Viber #

Ligue o seu próprio bot do Viber para que as suas conversas no Viber fluam para a aplicação e um Agente de IA possa responder. Pode ligá-lo colando um valor (o token de autenticação do seu bot) e nós tratamos do resto da configuração por si.

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

A integração com o Viber liga um bot do Viber que possui à plataforma utilizando a API oficial de Bots do Viber, o sistema próprio do Viber para enviar e receber mensagens automaticamente, em vez de as escrever manualmente. As conversas entre o seu bot e as pessoas que o seguem ficam disponíveis dentro da aplicação, e um Agente de IA e uma caixa de entrada partilhada funcionam sobre as mesmas.

Esta é uma integração oficial, pelo que é estável e cumpre as regras do Viber.

Disponibilidade. O Viber é mais utilizado nas Filipinas, no Vietname e noutras partes do Sudeste Asiático, bem como em toda a Europa de Leste e na Grécia.

Antes de começar #

Precisa do seu próprio bot do Viber, e o Viber apenas emite bots num plano de negócio pago. Desde fevereiro de 2024, o Viber já não cria bots gratuitos. Configura a conta diretamente com o Viber, e essa conta e as suas taxas são da sua responsabilidade e do Viber. Nós não revendemos, não aumentamos o preço nem recebemos uma comissão, e não podemos criar o bot em seu nome.

No momento em que este texto foi escrito, o Viber cobra uma taxa mensal por bot, acrescida de uma taxa por mensagem para as mensagens que o seu bot inicia (consulte Custo abaixo). Verifique os termos atuais do Viber quando se registar, uma vez que os preços podem ser alterados por eles.

Não existe um formulário de inscrição self-service. A Viber analisa manualmente cada pedido de chatbot, e pode candidatar-se de duas formas:

• Através de um parceiro Viber verificado, que é o método recomendado pela Viber e, normalmente, o mais rápido.
• Diretamente com a Viber, enviando um e-mail para partners@viber.com. Se já trabalha com a Viber, o seu gestor de conta empresarial pode iniciar o processo em seu nome.

Assim que a sua candidatura for aprovada, assina o contrato da Viber e aceita os seus termos comerciais, e o seu bot é criado.

Depois disso, encontrará o seu token na aplicação Viber em Mais → Definições → Bots → Editar Informações → Chave da sua aplicação. O Viber chama-lhe chave da aplicação; a documentação da API deles chama ao mesmo valor token de autenticação, e os administradores de bots também o podem ver no painel de administração do próprio Viber. Independentemente de como esteja identificado, é o único valor que esta aplicação solicita.

Esse token é a única coisa de que precisa da Viber. A configuração aqui demora cerca de um minuto.

Configurar o Viber #

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

O local mais rápido para o encontrar é na aplicação Viber no seu telemóvel.

1. Abra o Viber no telemóvel cuja conta é proprietária do bot.
2. Aceda a Mais → Definições → Bots.
3. Selecione o seu bot e toque em Editar Informações.
4. Copie o valor apresentado em A sua chave de aplicação. Esse é o token.

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

Passo 2: Ligue o Viber na Aplicação #

1. Na barra lateral esquerda, clique em Definições perto da parte inferior.
2. Na barra lateral das Definições, em Canais, clique em Canais.
3. Encontre o cartão Viber e clique em Ligar.
4. Cole o seu token de autenticação.
5. Clique em Ligar.
6. A aplicação verifica o token com o Viber e apresenta “Ligado a: <o nome do seu bot>”.

Não há nenhum webhook para configurar. Ao contrário da maioria dos outros canais, registamos tudo no Viber por si como parte da ligação, por isso não há nada para copiar para outra consola. O ecrã de ligação mostra o endereço onde as suas mensagens chegam apenas para que o possa partilhar com o suporte, caso precise.

Passo 3: Testar o Bot #

1. A partir de um telemóvel diferente, abra o Viber e siga o seu bot (pesquise por ele ou utilize a sua ligação).
2. Envie-lhe uma mensagem.
3. Abra a aplicação e vá a Conversas. A mensagem recebida aparece na lista de conversas.
4. Se um Agente de IA estiver a gerir este canal, verá que ele responde automaticamente.

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

A quem o seu bot pode enviar mensagens #

Este é o ponto mais importante a compreender sobre o Viber, e é diferente de qualquer outro canal:

O seu bot só pode enviar mensagens a pessoas que o sigam. Alguém tem de encontrar o seu bot e segui-lo antes que lhe possa enviar qualquer coisa. Não existe forma de enviar uma mensagem a um utilizador do Viber que não tenha seguido o seu bot primeiro.

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

Devido a isto, o Viber funciona muito bem como um canal de suporte e resposta (alguém envia-lhe uma mensagem, a IA responde) e mal como um canal de contacto a frio.

Custo #

O Viber é um canal gratuito na aplicação: sem custos por mensagem e sem taxa de ligação mensal da nossa parte.

Os seus custos provêm do Viber, na sua própria conta:

• Uma taxa mensal por bot (cerca de 100 € à data em que este texto foi escrito).
• As respostas dentro de uma conversa iniciada por alguém são gratuitas e ilimitadas. Isto cobre quase tudo o que um Agente de IA faz.
• As mensagens iniciadas pelo seu bot, 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. As transmissões e os acompanhamentos proativos são o que faz aumentar os custos.

Mensagens de multimédia #

Fotografias, vídeos, ficheiros, autocolantes, localizações e contactos partilhados recebidos são reconhecidos para que a IA saiba que foi enviado conteúdo multimédia (é adicionada uma breve nota à conversa). As respostas de saída da IA são texto e imagens nesta versão. As respostas longas são automaticamente cortadas para o limite de 7000 caracteres do Viber.

Gestão de Sessão #

Verificar o Estado da Ligação #

O estado da sua ligação ao Viber é apresentado no cartão Viber na página Canais:

O cartão verifica novamente o seu bot sempre que abre a página Canais. Um bot Viber só pode enviar as suas mensagens para um local de cada vez, por isso, se ligar o mesmo bot a outra ferramenta, essa ferramenta assume o controlo e as suas mensagens deixam de chegar aqui, sem qualquer aviso por parte do Viber. É isso que significa “Ligado, ação necessária”. Abra o cartão e volte a ligar para retomar o controlo.

Desligar #

Abra o cartão Viber e clique em Gerir, depois clique em Desligar e confirme em Remover Viber?. Isto impede-nos de receber as mensagens do bot e remove-o da sua conta. O seu bot continua a ser seu. Nada muda na sua conta Viber.

Limitações #

• Apenas seguidores. O seu bot só pode enviar mensagens a pessoas que o sigam. Consulte Quem o seu bot pode contactar.
• Precisa do seu próprio bot Viber pago. Não podemos fornecer um.
• Um bot por ligação. Ligue cada bot separadamente; um bot só pode estar associado a uma conta.
• Envio de texto + imagem. A IA responde com texto e imagens; carrosséis e cartões interativos (rich cards) não são enviados nesta versão.
• Sem mensagem de boas-vindas. Quando alguém abre o 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 nenhuma. A conversa começa quando a pessoa envia a sua primeira mensagem.

Resolução de Problemas #

Token rejeitado ao ligar #

• Certifique-se de que copiou o valor de Edit Info → Your app key na aplicação Viber e não um ID diferente.
• Verifique se o seu bot ainda está ativo na sua conta Viber.
• A ligação também verifica se o Viber consegue chegar até nós. Se o seu token estiver certamente correto e continuar a falhar, aguarde um minuto e tente novamente, depois contacte o suporte.

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

O mesmo bot está associado a uma conta diferente na aplicação. Desligue-o primeiro nessa conta ou utilize um bot diferente.

O bot não responde #

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

As mensagens deixaram de chegar #

Este é quase sempre o problema de sobreposição descrito em Verificar o estado da ligação: o mesmo bot foi ligado a outra ferramenta. Abra o cartão Viber e volte a ligar.

Uma resposta falhou com “Not Subscribed” #

A pessoa deixou de seguir ou bloqueou o seu bot. Não pode enviar-lhe mensagens até que a pessoa volte a seguir o bot e lhe envie uma mensagem primeiro.

Melhores práticas #

• Privilegie o suporte, não a prospeção. As respostas dentro de uma conversa iniciada por alguém são gratuitas e ilimitadas; as mensagens que inicia são pagas e só chegam aos seguidores.
• Torne o seu bot fácil de seguir. Coloque a ligação no seu site, na sua assinatura de e-mail e nos seus outros canais. Segui-lo é a única forma de as pessoas chegarem até ele.
• Mantenha o seu token de autenticação seguro. Qualquer pessoa com acesso a ele pode enviar mensagens como se fosse o seu bot. Gere um novo na aplicação Viber se este for divulgado e, em seguida, volte a ligar aqui.
• Não ligue o mesmo bot a duas ferramentas. A segunda assumirá o controlo silenciosamente.