# 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](#cost) 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: \"**. **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**: | Estado | Significado | |---|---| | **Ligado** | Um bot Viber está associado a esta conta | | **Ligado, ação necessária** | Outra ferramenta assumiu o controlo do seu bot; as mensagens não nos estão a chegar | | **Não ligado** | Nenhuma ligação configurada | 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](#who-your-bot-can-message). - **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](#checking-connection-status): 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.