Viber #

Conecte seu próprio bot do Viber para que suas conversas no Viber fluam para o aplicativo e um Agente de IA possa responder. Você conecta colando um único valor (o token de autenticação do seu bot) e nós cuidamos do restante da configuração para você.

O que é a integração com o Viber? #

A integração com o Viber vincula um bot do Viber de sua propriedade à plataforma usando a API oficial de Bots do Viber, o próprio sistema do Viber para enviar e receber mensagens automaticamente, em vez de você digitá-las manualmente. As conversas entre seu bot e as pessoas que o seguem ficam disponíveis dentro do aplicativo, e um Agente de IA e uma caixa de entrada compartilhada operam sobre elas.

Esta é uma integração oficial, portanto, é estável e está dentro das regras do Viber.

Disponibilidade. O Viber é mais amplamente utilizado nas Filipinas, Vietnã e outras partes do Sudeste Asiático, além de toda a Europa Oriental e Grécia.

Antes de começar #

Você precisa do seu próprio bot do Viber, e o Viber só emite bots em um plano comercial pago. Desde fevereiro de 2024, o Viber não cria mais bots gratuitos. Você configura a conta diretamente com o Viber, e essa conta e suas taxas permanecem entre você e o Viber. Nós não revendemos, não adicionamos margem, não recebemos comissão e não podemos criar o bot em seu nome.

No momento da redação deste documento, o Viber cobra uma taxa mensal por bot, além de uma cobrança por mensagem para mensagens iniciadas pelo seu bot (veja Custo abaixo). Verifique os termos atuais do Viber ao se inscrever, já que a precificação é de responsabilidade deles e pode mudar.

Não existe um formulário de inscrição de autoatendimento. O Viber analisa cada solicitação de chatbot manualmente, e você pode se inscrever de duas maneiras:

• Por meio de um parceiro verificado do Viber, que é o caminho recomendado pelo Viber e geralmente o mais rápido.
• Diretamente com o Viber, enviando um e-mail para partners@viber.com. Se você já trabalha com o Viber, seu gerente de conta comercial pode iniciar o processo em seu lugar.

Assim que sua solicitação for aprovada, você assina o contrato do Viber e aceita os termos comerciais, e seu bot é criado.

Depois disso, você encontrará seu token no aplicativo Viber em Mais → Configurações → Bots → Editar informações → Sua chave de aplicativo. O Viber chama isso de chave de aplicativo; a documentação da API deles chama o mesmo valor de token de autenticação, e os administradores de bots também podem vê-lo no próprio painel administrativo do Viber. Independentemente de como seja rotulado, é o único valor que este aplicativo solicita.

Esse token é a única coisa que você precisa do Viber. A configuração aqui leva cerca de um minuto.

Configurando o Viber #

Passo 1: Copie o Token de Autenticação do seu Bot #

O lugar mais rápido para encontrá-lo é no aplicativo Viber em seu telefone.

1. Abra o Viber no telefone cuja conta possui o bot.
2. Vá para Mais → Configurações → Bots.
3. Selecione seu bot e toque em Editar informações.
4. Copie o valor exibido em Sua chave de aplicativo. Esse é o token.

Mantenha este token privado. Qualquer pessoa que o possua pode enviar mensagens como se fosse seu bot.

Passo 2: Conecte o Viber no Aplicativo #

1. Na barra lateral esquerda, clique em Configurações perto da parte inferior.
2. Na barra lateral esquerda de Configurações, em Canais, clique em Canais.
3. Encontre o cartão Viber e clique em Conectar.
4. Cole seu token de autenticação.
5. Clique em Conectar.
6. O aplicativo verifica o token com o Viber e exibe “Conectado a: <nome do seu bot>”.

Não há webhook para configurar. Ao contrário da maioria dos outros canais, registramos tudo no Viber para você como parte da conexão, portanto, não há nada para copiar em outro console. A tela de conexão mostra o endereço onde suas mensagens chegam apenas para que você possa compartilhá-lo com o suporte, caso precise.

Passo 3: Teste o Bot #

1. De um telefone diferente, abra o Viber e siga seu bot (pesquise por ele ou use seu link).
2. Envie uma mensagem para ele.
3. Abra o aplicativo e vá para Conversas. A mensagem recebida aparece na lista de conversas.
4. Se um Agente de IA estiver gerenciando este canal, você verá ele responder automaticamente.

Uma vez conectado, seu bot do Viber aparece como Conectado na página Canais e a IA responde às mensagens recebidas.

Para quem seu bot pode enviar mensagens #

Esta é a coisa mais importante a entender sobre o Viber, e é diferente de todos os outros canais:

Seu bot só pode enviar mensagens para pessoas que o seguem. Alguém precisa encontrar seu bot e segui-lo antes que você possa enviar qualquer coisa. Não há como enviar mensagens para um usuário do Viber que não tenha seguido seu bot primeiro.

Se alguém deixar de seguir ou bloquear seu bot, você não poderá enviar mensagens para essa pessoa novamente até que ela o siga e envie uma mensagem para você. Quando isso acontece, o aplicativo marca a conversa para que pare de tentar, e qualquer resposta que você enviar aparecerá como falha com uma explicação, em vez de desaparecer silenciosamente.

Por causa disso, o Viber funciona muito bem como um canal de suporte e resposta (alguém envia uma mensagem para você, a IA responde) e mal como um canal de abordagem fria (cold-outreach).

Custo #

O Viber é um canal gratuito no aplicativo: sem cobrança por mensagem e sem taxa mensal de conexão da nossa parte.

Seus custos vêm do Viber, em sua própria conta:

• Uma taxa mensal por bot (cerca de €100 no momento da redação).
• Respostas dentro de uma conversa iniciada por alguém são gratuitas e ilimitadas. Isso cobre quase tudo o que um Agente de IA faz.
• Mensagens que seu bot inicia, fora de uma conversa que a pessoa começou, são cobradas por mensagem a uma taxa que depende do país do destinatário.

A conclusão prática: responder às pessoas não lhe custa nada além da taxa mensal. Transmissões e acompanhamentos proativos são o que aumenta o custo.

Mensagens de mídia #

Fotos, vídeos, arquivos, adesivos, locais e contatos compartilhados recebidos são reconhecidos para que a IA saiba que a mídia foi enviada (uma pequena nota é adicionada à conversa). As respostas de saída da IA são texto e imagens nesta versão. Respostas longas são automaticamente cortadas para o limite de 7.000 caracteres do Viber.

Gerenciamento de Sessão #

Verificando o Status da Conexão #

O status da sua conexão com o Viber é mostrado no cartão Viber na página Canais:

O cartão verifica novamente o seu bot toda vez que você abre a página Canais. Um bot do Viber só pode enviar suas mensagens para um lugar de cada vez, portanto, se você conectar o mesmo bot a outra ferramenta, essa ferramenta assumirá o controle e suas mensagens pararão de chegar aqui, sem nenhum aviso do Viber. É isso que “Conectado, ação necessária” significa. Abra o cartão e reconecte para retomar o controle.

Desconectando #

Abra o cartão Viber e clique em Gerenciar, depois clique em Desconectar e confirme em Remover Viber?. Isso impede que recebamos as mensagens do bot e o remove da sua conta. O seu bot continua sendo seu. Nada muda na sua conta do Viber.

Limitações #

• Apenas seguidores. Seu bot só pode enviar mensagens para pessoas que o seguem. Veja Quem seu bot pode contatar.
• Você precisa do seu próprio bot pago do Viber. Não podemos fornecer um.
• Um bot por conexão. Conecte cada bot separadamente; um bot só pode ser vinculado a uma conta.
• Envio de texto + imagem. A IA responde com texto e imagens; carrosséis e cartões rich não são enviados nesta versão.
• Sem mensagem de boas-vindas. Quando alguém abre seu bot pela primeira vez, mas ainda não o seguiu, o Viber permite uma única saudação instantânea. Esta versão não envia uma. A conversa começa quando eles enviam a primeira mensagem.

Solução de problemas #

Token rejeitado ao conectar #

• Certifique-se de ter copiado o valor de Edit Info → Your app key no aplicativo Viber, e não um ID diferente.
• Verifique se o seu bot ainda está ativo na sua conta do Viber.
• A conexão também verifica se o Viber consegue nos alcançar. Se o seu token estiver definitivamente correto e ainda assim falhar, aguarde um minuto e tente novamente, depois entre em contato com o suporte.

“Este bot do Viber já está conectado a outra conta” #

O mesmo bot está vinculado a uma conta diferente no aplicativo. Desconecte-o lá primeiro ou use um bot diferente.

O bot não está respondendo #

• Confirme se o cartão mostra Conectado, e não Conectado, ação necessária.
• Confirme se a pessoa com quem você está testando seguiu seu bot. O Viber só entrega mensagens de seguidores.
• Verifique se um Agente de IA está atribuído a este canal.

As mensagens pararam de chegar #

Isso é quase sempre o problema de substituição descrito em Verificando o status da conexão: o mesmo bot foi conectado a outra ferramenta. Abra o cartão Viber e reconecte.

Uma resposta falhou com “Não inscrito” #

A pessoa deixou de seguir ou bloqueou seu bot. Você não pode enviar mensagens para ela até que ela siga o bot novamente e envie uma mensagem primeiro.

Melhores práticas #

• Priorize o suporte, não a prospecção. As respostas dentro de uma conversa que alguém iniciou são gratuitas e ilimitadas; as mensagens que você inicia são cobradas e só chegam aos seguidores.
• Facilite o ato de seguir seu bot. Coloque o link dele no seu site, na sua assinatura de e-mail e em seus outros canais. Segui-lo é a única maneira de as pessoas entrarem em contato.
• Mantenha seu token de autenticação seguro. Qualquer pessoa com ele pode enviar mensagens como se fosse seu bot. Gere-o novamente no aplicativo Viber se ele vazar, depois reconecte aqui.
• Não conecte o mesmo bot a duas ferramentas. A segunda assumirá o controle silenciosamente.