Rode um fluxo do Typebot no WhatsApp com Coexistência
O canal de WhatsApp do Typebot pede um token, o id de uma WhatsApp Business Account e um phone number id, e em troca entrega uma callback URL e um verify token. Preencha os três primeiros com os dados do número conectado, deixe vazio o app secret opcional do Typebot e defina a callback URL e o verify token dele como destino do webhook do número.
O Typebot lista a integração com WhatsApp como recurso do plano Pro, não dos planos Free ou Starter.
O Typebot só confere a assinatura do webhook quando um app secret é salvo junto das credenciais.
O assistente do Typebot rejeita um token cuja expiração não esteja definida como nunca.
Throughput fixo para um número usado com o app do WhatsApp Business e a Cloud API.
Quais campos do Typebot recebem valores do número conectado?
O assistente de WhatsApp do Typebot, na aba Share de um bot, pede quatro coisas: um app secret, um System User Token, um WhatsApp Business Account ID e um Phone number ID.
Três deles vêm direto da conexão. O painel mostra o id da WABA, o phone number id e o token de acesso do número, e a ferramenta get_api_credentials devolve os mesmos valores se um assistente estiver buscando por você. Cole cada um no campo correspondente.
O app secret é o que deve ficar em branco. O Typebot o usa para uma única coisa no tráfego de entrada: conferir o cabeçalho X-Hub-Signature-256 que a Meta adiciona a cada entrega. Para um número conectado por um Tech Provider, a Meta assina com o app secret do provedor, que nunca é compartilhado, então qualquer valor digitado ali faz o Typebot rejeitar todas as mensagens legítimas. Com o campo vazio, o Typebot pula essa checagem e aceita a entrega.
Onde entram a callback URL e o verify token do Typebot?
No destino do webhook do número, não no painel de um app da Meta.
O assistente do Typebot manda colar a Callback URL e o Verify Token nas configurações de WhatsApp do seu próprio app da Meta. Com a Coexistência pela EasyCoexistence, não há app seu envolvido: a Meta roteia os eventos do número para o destino definido na conexão. Então copie os dois valores da última etapa do Typebot e defina-os como destino, no painel ou com set_webhook_destination.
Em seguida a Meta envia o GET de verificação ao Typebot, o Typebot responde com o challenge e, a partir daí, toda mensagem para o número chega ao bot. O verify token do Typebot é de uso único: ele é apagado do banco de dados do Typebot assim que uma verificação dá certo. Se você definir o destino de novo mais tarde, gere antes um token novo rodando o assistente outra vez.
O que o bot faz com a janela de 24 horas?
O Typebot responde a quem escreveu para ele, o que mantém quase toda mensagem dentro da janela de atendimento. A Meta abre uma janela de 24 horas a cada vez que um cliente escreve e, dentro dela, qualquer tipo de mensagem de atendimento pode ser enviado sem template. Um bot que só responde é, portanto, o caso fácil.
O limite aparece num fluxo que espera. Um bloco Wait, ou uma sessão retomada depois de o cliente ficar mais de um dia em silêncio, tentará enviar texto livre fora da janela, e a Meta o recusa com o erro 131047. O timeout de expiração de sessão do Typebot, de 4 horas por padrão e ajustável até 48, decide quando um cliente que volta começa uma nova conversa, não se a Meta aceita a mensagem.
Como isso é Coexistência, a equipe continua vendo todas as conversas no app do WhatsApp Business e pode assumir pelo celular sempre que o bot não deva responder.
Erros comuns
- Colar no Typebot o app secret de um app da Meta. As entregas são assinadas com o secret do Tech Provider, então o Typebot rejeita toda mensagem por assinatura inválida.
- Reaproveitar um verify token antigo do Typebot. Ele é apagado após uma verificação bem-sucedida, então definir o destino de novo exige um token novo do assistente.
- Compartilhar a callback URL. Com a checagem de assinatura desligada, conhecer a URL é o que permite enviar uma requisição, então trate-a como uma senha.
Conecte o número em easycoexistence.com, copie o token, o id da WABA e o phone number id para o Typebot e defina a callback URL do Typebot como destino do webhook. A partir de US$ 9 por número por mês, caindo até US$ 1 conforme você adiciona números, com os 3 primeiros dias grátis.
Perguntas frequentes
Preciso de um app próprio da Meta para usar o Typebot?
Não. O guia do Typebot pressupõe um porque a maioria das pessoas conecta o número por conta própria. Com a Coexistência por um Tech Provider, o token e os ids vêm da conexão e a Meta roteia o webhook para o Typebot.
A equipe ainda verá no celular as mensagens do bot?
Sim. As mensagens enviadas pela Cloud API aparecem no app do WhatsApp Business no mesmo número, então uma pessoa pode ler a conversa e assumir.
O Typebot e o n8n podem receber as mensagens do mesmo número?
Não. Um número tem um único destino de webhook. Se os dois precisam dos eventos, aponte o destino para o n8n e faça o fluxo encaminhar o payload bruto para a callback URL do Typebot.
O Typebot armazena as conversas?
O Typebot guarda seus próprios dados de sessão e resultados, como em qualquer canal. A EasyCoexistence nunca armazena o conteúdo das mensagens: a Meta entrega direto no destino que você definir.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em