Viber

Comprimento máximo da mensagem de texto: 1000 caracteres

O Viber não permite recuperar automaticamente o número de telefone do cliente.

Como Conectar o Viber

Versão Antiga

Esta versão é aplicável apenas a usuários que criaram seu chatbot antes de 5 de fevereiro de 2024.

Se você ainda não criou um bot do Viber (após 5 de fevereiro de 2024), prossiga para a seção Nova Versão.

Primeiro, siga o link abaixo e faça login no site.

https://partners.viber.com/login?returnUrl=%2Faccount

Em seguida, crie uma Conta Pública para o seu bot.

Escolha uma imagem e preencha todos os campos obrigatórios.

Campo	Descrição
Nome da conta	Nome do bot. Pode ser alterado posteriormente.
Uri	Nome de usuário do bot. Usado para gerar links do bot.
Categoria	Especifique sua categoria de negócio (por exemplo, Negócio Local).
Subcategoria	Especifique a subcategoria do negócio (por exemplo, Negócio Automotivo).
Idioma	Idioma do bot.
Descrição da conta	Descrição do bot visível para todos os assinantes.
Endereço do site	Seu site.
Endereço de e-mail	Endereço de e-mail de contato.
Localização	Localização do negócio.

Há um interruptor no formulário de registro chamado "A conta contém conteúdo adulto."

NÃO ATIVE ESTA OPÇÃO!

Caso contrário, todos os usuários verão um aviso antes de abrir seu bot indicando que ele contém conteúdo adulto.

Aceite o contrato de licença e clique em Criar.

Se tudo tiver sido concluído corretamente, você receberá o token do seu bot.

Você precisará dele para o próximo passo.

Seu bot está pronto agora.

A única etapa restante é conectá-lo ao Mavibot.

Vá para a seção Canais e selecione Viber.

Digite o token que você recebeu.

Clique em Concluir para conectar o bot ao Mavibot.

Você receberá uma notificação no aplicativo móvel do Viber confirmando que o bot foi criado junto com as informações fornecidas durante o registro.

Nova Versão (Disponível a partir de 5 de fevereiro de 2024)

A partir de 5 de fevereiro de 2024, o Viber mudou as condições para criar e conectar chatbots.

O serviço agora é pago.

Chatbots criados antes desta data continuam operando sob as condições anteriores.

Como Obter um Link para o Seu Bot do Viber

O link do bot fica disponível imediatamente após o bot ser conectado.

Devido às limitações do Viber, os bots não podem ser encontrados através da pesquisa do Viber.

Os usuários só podem abrir um bot usando seu botão ou link direto.

Links internos viber:// não são reconhecidos por muitos navegadores ou aplicativos.

Se você quiser distribuir seu bot, você pode:

usar as mini landing pages do MaviBot;

encurtar o link usando um serviço como:

https://tinyurl.com/

Como Criar um Carrossel no Viber

O Viber suporta até 6 cartões em um carrossel.

O Viber permite usar botões coloridos.

Formatos de imagem suportados

JPEG
PNG

Tamanho máximo da imagem

500 KB

Vamos ver um exemplo de um carrossel contendo 3 cartões.

Para criar os cartões, insira o seguinte código no campo Calculadora:

p =[{"title":"TITLE 1", "description": "DESCRIPTION ", "image": "IMAGE LINK 1", "buttons":[{"text":"BUTTON TEXT 1","color":"#4BB34B"}]}, {"title":"TITLE 1", "description": "DESCRIPTION ", "image": "IMAGE LINK 1", "buttons":[{"text":"BUTTON TEXT 1"}]}, {"title":"TITLE 2", "description": "DESCRIPTION ", "image": "IMAGE LINK 2", "buttons":[{"text":"BUTTON TEXT 2", "url":"LINK"}]}, {"title":"TITLE 3", "description": "DESCRIPTION", "image": "IMAGE LINK 3", "buttons":[{"text":"BUTTON TEXT 3"}]}]

r = send_carousel(p, '')

Primeiro, salve o array contendo title, description, image e buttons na variável p (você pode usar qualquer nome de variável). Em seguida, use-o no método send_carousel(p, '').

Para tornar um botão colorido, adicione o parâmetro adicional "color":"#4BB34B" ao array buttons.

A cor deve ser especificada como um valor hexadecimal começando com #.

Você pode escolher qualquer cor usando um seletor de cores, por exemplo:

https://htmlcolorcodes.com/

Você pode inserir URLs nos botões dos cartões do carrossel usando o parâmetro url. Quando o cliente clicar no botão, ele será redirecionado para o link especificado, e o link também será recebido como uma mensagem.

Os botões dos cartões do carrossel também podem incluir o parâmetro payload. Este parâmetro não é exibido ao cliente, mas permite analisar a seleção do cliente.

[
{
"title":"TITLE 1",
"description":"DESCRIPTION",
"image":"IMAGE LINK 1",
"buttons":[
{
"text":"BUTTON TEXT 1",
"color":"#4BB34B",
"url":"BUTTON LINK",
"payload":"1"
}
]
}
]

Se você usar botões com texto idêntico, pode usar o parâmetro payload. Ele não é visível para o cliente, mas permite analisar a opção selecionada pelo usuário.

Dicas e Melhores Práticas para Bots do Viber

Ao criar bots do Viber, há várias características importantes que você deve estar ciente.

Entendê-las economizará tempo e ajudará você a aproveitar ao máximo os recursos do Viber.

Como Definir a Primeira Mensagem e Criar um Botão de Chamada para Ação

Ao contatar um usuário pela primeira vez, o Viber permite que os bots enviem apenas uma mensagem até que o usuário responda.

Portanto, assim que um usuário abrir seu bot usando o link do bot, ele receberá automaticamente a primeira mensagem.

Nesta mensagem, você deve pedir ao cliente para:

pressionar um botão; ou
enviar qualquer mensagem.

Caso contrário, nenhuma das suas mensagens subsequentes será entregue.

Assim que o usuário responder, você pode enviar um número ilimitado de mensagens.

A primeira mensagem motivacional para o Viber é configurada nas configurações do projeto.

Botões incorporados no texto da mensagem não são enviados quando o usuário abre o bot.

Apenas botões de teclado devem ser usados.

Após a primeira ação do usuário, você pode enviar qualquer conteúdo sem restrições.

Exemplo de como a primeira mensagem se parece após abrir o bot:

Como Testar a Primeira Mensagem Novamente

Execute estes passos toda vez que testar a primeira mensagem.

Para fazer isso:

Exclua a conversa da seção Clientes no construtor.
Exclua a conversa com o bot clicando em Excluir e Cancelar Inscrição.

Depois disso, abrir o bot novamente usando o link acionará a mensagem de boas-vindas mais uma vez.

Possíveis Erros do Viber

Se você vir a seguinte notificação na conversa com um cliente na seção Clientes, isso pode significar um dos seguintes:

O usuário cancelou a inscrição das suas mensagens (bloqueou o bot na sua conta do Viber).
Você enviou a segunda (ou subsequente) mensagem antes de o usuário responder à sua primeira mensagem.
Sua primeira mensagem contém botões dentro do texto.

Construa seu fluxo de conversa de modo que, após a primeira mensagem, o usuário responda ou configure o campo Responder à primeira mensagem do usuário nas configurações do construtor.

Peça ao usuário para enviar uma resposta ou pressionar um botão.

A primeira mensagem pode conter apenas botões de teclado.

Botões dentro do texto da mensagem não são permitidos.

Como Iniciar uma Conversa Corretamente

O bloco contendo #{none} é obrigatório.

Ele ativa o bot sem consumir o limite para envio da primeira mensagem do Viber.

Em seguida, compare o valor da variável client_type, que armazena o identificador numérico interno do mensageiro.

Para o Viber:

client_type = 2