Geral
Você pode conectar seu chatbot ao seu canal do WhatsApp (conta do WhatsApp Business) usando nosso recurso de integração nativa.
📌 Observação: o canal do WhatsApp tem mais limitações em comparação com um chatbot baseado em widget devido às restrições da Meta. Essas limitações são detalhadas abaixo na seção de implementação.
Como configurar o WhatsApp?
📑 Essa configuração é feita principalmente na plataforma da Meta. Embora não seja necessário programar, conhecimentos técnicos são úteis para entender a documentação e o processo de configuração.
Para adicionar um canal do WhatsApp ao seu chatbot:
Aceda à página Canais página no menu “Integrar” e adicione um novo canal de usuário.
Selecione WhatsApp como canal do cliente e escolha o idioma.
Siga as etapas das “Diretrizes”
Siga as etapas da seção “Configuração da conexão” para configurar suas credenciais (token permanente ou token de acesso temporário, ID do número de telefone)
Teste sua conexão com o WhatsApp.
A "Teste de conexão" garante que o ViaSay possa enviar mensagens aos usuários pelo WhatsApp, mas não confirma que o ViaSay esteja recebendo mensagens dos usuários. Se o bot não estiver respondendo corretamente, verifique as etapas relacionadas à configuração do Webhook.
Após concluir, implemente e teste seu chatbot de acordo com as diretrizes da próxima seção.
🎧 Precisa de suporte técnico?
Para obter ajuda com a integração do WhatsApp, envie um e-mail para support@viasay.io . Você também pode consultar a documentação da Meta: Saiba como criar um token permanente .
Limitações do WhatsApp
Ao usar o chatbot do ViaSay no canal do WhatsApp, considere as seguintes limitações da API que restringem os recursos de exibição:
Texto: Cada mensagem deve ter menos de 1024 caracteres. Links podem ser incluídos nas mensagens.
Botões: Máximo de 3 botões, cada um com menos de 20 caracteres; só podem ser clicados uma vez.
Imagens: Exibidas uma por vez com um título; não é possível usar carrossel.
Essas limitações afetam a plataforma da seguinte forma:
As mensagens do bot são limitadas a 1024 caracteres.
As respostas rápidas e os botões de "voltar" são limitados a um máximo de 3 por etapa, com menos de 20 caracteres em cada texto.
Links da Web não são compatíveis.
As pesquisas de CSAT não são compatíveis e não serão exibidas se forem adicionadas, sem causar um erro.
❗️ A transferência para um agente via Zendesk não é compatível.
❗️ Alguns links em mensagens de texto podem não ser clicáveis em determinados dispositivos iOS para clientes sem uma "Conta comercial oficial" devido às limitações do WhatsApp. Os usuários devem adicionar o número de telefone comercial à agenda de contatos para iniciar a conversa.
Testando o chatbot
As limitações específicas do WhatsApp não são verificadas na plataforma ViaSay; portanto, nenhuma mensagem de erro específica é exibida no Flow Builder, no Advanced Builder ou no widget de teste.
📑 Teste com um token e um número de telefone temporários
Você pode testar seu chatbot com um token e um número de telefone temporários ou permanentes, dependendo da configuração da plataforma da Meta. Tokens e números de telefone temporários permitem testes rápidos, mas têm limitações (validade de 24 horas e alcance limitado). Tokens e números permanentes eliminam essas limitações.
Para obter os melhores resultados, teste o chatbot diretamente no WhatsApp para identificar problemas relacionados às limitações do WhatsApp. Se uma interação não estiver de acordo com as regras específicas do WhatsApp, o chatbot poderá:
Não exibir o elemento (por exemplo, subtítulos em um template).
Exibir uma mensagem de erro padrão: "Desculpe, ocorreu um erro técnico: esta mensagem do bot não respeita as diretrizes do WhatsApp."
Compartilhando o link com seus usuários
O WhatsApp fornece um guia sobre como criar um link que direciona os usuários ao seu chatbot. Como o chatbot não pode iniciar conversas, use esse link para preencher previamente uma mensagem que os usuários possam enviar. Por exemplo, se o seu chatbot estiver no número +15550451352, o link poderia ser: https://wa.me/15550451352?text=Hello bot . Você também pode criar um link personalizado no WhatsApp Manager.
Push do WhatsApp
Depois de conectar seu canal do WhatsApp, você poderá enviar mensagens push (mensagens iniciadas pela empresa) aos usuários.
🗒️ O bloco de push do WhatsApp só ficará visível se você tiver um canal conectado.
O endpoint da API a seguir permite enviar uma mensagem de template pré-configurada como a primeira mensagem push para uma lista de números de telefone, direcionando-os a um caso de uso específico
❗️ Pré-requisitos para usar a API de push do WhatsApp:
Um canal de usuário do WhatsApp conectado
O nome da mensagem de template aprovada no Meta Business Suite
Uma lista de números de telefone que aceitaram previamente receber mensagens
O UUID do caso de uso de acompanhamento, se aplicável
Mensagem de template
Uma mensagem de template é a primeira mensagem push em uma conversa do WhatsApp iniciada pela empresa. Ela deve ser aprovada pela Meta antes de ser enviada aos usuários. Saiba mais sobre mensagens de template em Meta . A aprovação normalmente leva 24 horas.
Tipos de template aceitos:
Baseado em texto
CTA interativo (chamada para ação)
QR interativo (resposta rápida)
Consulte este artigo se não tiver certeza sobre a mensagem de template que criou.
Após a primeira mensagem push, os usuários poderão interagir com o bot conforme configurado no seu canal do WhatsApp.
Caso de uso de acompanhamento
Para mensagens de template do tipo QR interativo, atribua um caso de uso de acompanhamento do Flow Builder incluindo o UUID do caso de uso no payload do botão QR. A Meta permite apenas 128 caracteres por payload de botão QR.
Encontre o UUID de um caso de uso aqui:
O caso de uso de acompanhamento começará na primeira etapa após a intenção de início. Observe que o botão "Voltar" na primeira etapa não funcionará, pois a mensagem push anterior é enviada pela API, e não pelo caso de uso. As limitações gerais do WhatsApp mencionadas acima também se aplicam aqui.
Conversas push
Depois que as mensagens push forem enviadas, você poderá filtrar e pesquisar conversas iniciadas por mensagens push na página de Conversas . Consulte a documentação relevante para obter mais detalhes.
Pontos principais a lembrar:
Somente o nome da mensagem de template será exibido nos detalhes da conversa.
Após a primeira mensagem push, os usuários terão 24 horas para responder ou interagir com o bot a fim de serem incluídos na conversa inicial.
As interações subsequentes à primeira mensagem push voltam a seguir a regra do período de conversa de 15 minutos.
Após 24 horas, qualquer nova resposta ou interação do usuário gera uma nova conversa.
Se não houver mais nenhuma interação do usuário após 24 horas, a mensagem push inicial permanecerá na conversa original.