Execute um fluxo Typebot no WhatsApp com Coexistence
O canal de WhatsApp do Typebot pede um token, um id de WhatsApp Business Account e um id do número de telefone, e devolve um callback URL e um verify token. Preencha os três primeiros com os dados do número ligado, deixe vazio o app secret opcional do Typebot e defina o callback URL e o verify token do Typebot como destino do webhook do número.
O Typebot indica a integração com o WhatsApp como funcionalidade do plano Pro, não dos planos Free ou Starter.
O Typebot só verifica a assinatura do webhook quando um app secret é guardado com as credenciais.
O assistente do Typebot rejeita um token cuja expiração não esteja definida como nunca.
Throughput fixo para um número usado em simultâneo na app WhatsApp Business e na Cloud API.
Que campos do Typebot recebem valores do número ligado?
O assistente de WhatsApp do Typebot, no separador Share de um bot, pede quatro itens: um App Secret, um System User Token, um WhatsApp Business Account ID e um Phone number ID.
Três deles vêm diretamente da ligação. O painel mostra o id da WABA, o id do número de telefone e o token de acesso do número, e a ferramenta get_api_credentials devolve os mesmos valores se for um assistente a obtê-los por si. Cole-os nos campos correspondentes.
O App Secret é o que deve ficar em branco. O Typebot usa-o para uma única coisa no tráfego recebido: verificar o cabeçalho X-Hub-Signature-256 que a Meta acrescenta a cada entrega. Num número ligado através de um Tech Provider, a Meta assina com o app secret do fornecedor, que nunca é partilhado, pelo que qualquer valor escrito ali faz o Typebot rejeitar todas as mensagens genuínas. Com o campo vazio, o Typebot ignora essa verificação e aceita a entrega.
Onde se colocam o callback URL e o verify token do Typebot?
No destino do webhook do número, não no painel de uma app da Meta.
O assistente do Typebot indica que se cole o Callback URL e o Verify Token nas definições de WhatsApp da sua própria app da Meta. Com a Coexistence através da EasyCoexistence, não há nenhuma app sua envolvida: a Meta encaminha os eventos do número para o destino definido na ligação. Copie por isso os dois valores do último passo do Typebot e defina-os como destino, no painel ou com set_webhook_destination.
A Meta envia então o seu GET de verificação ao Typebot, o Typebot responde com o desafio e, a partir desse momento, todas as mensagens para o número chegam ao bot. O verify token do Typebot é de utilização única: é eliminado da base de dados do Typebot assim que uma verificação tem êxito. Se voltar a definir o destino mais tarde, gere primeiro um novo token, executando de novo o assistente.
Como trata o bot a janela de 24 horas?
O Typebot responde a pessoas que lhe escreveram, o que mantém quase todas as mensagens dentro da janela de atendimento ao cliente. A Meta abre uma janela de 24 horas sempre que um cliente escreve e, dentro dela, qualquer tipo de mensagem de serviço pode ser enviado sem template. Um bot que se limita a responder é, por isso, o caso simples.
O limite está nos fluxos que esperam. Um bloco Wait, ou uma sessão que é retomada depois de o cliente estar mais de um dia em silêncio, tentará enviar uma mensagem de texto livre fora da janela, e a Meta recusa-a com o erro 131047. O tempo limite de expiração da sessão do Typebot, de 4 horas por predefinição e configurável até 48, decide quando um cliente que regressa inicia uma nova conversa, não se a Meta aceita a mensagem.
Como se trata de Coexistence, a equipa continua a ver todas as conversas na app WhatsApp Business e pode intervir a partir do telemóvel sempre que o bot não deva responder.
Erros comuns
- Colar no Typebot um app secret da Meta. As entregas são assinadas com o secret do Tech Provider, por isso o Typebot rejeita todas as mensagens por assinatura inválida.
- Reutilizar um verify token antigo do Typebot. É eliminado após uma verificação bem-sucedida, pelo que voltar a definir o destino exige um novo token, obtido no assistente.
- Partilhar o callback URL. Com a verificação da assinatura desativada, conhecer o URL é o que permite a entrada de um pedido, por isso trate-o como uma palavra-passe.
Ligue o número em easycoexistence.com, copie o token, o id da WABA e o id do número de telefone para o Typebot e defina o callback URL do Typebot como destino do webhook. A partir de US$ 9 por número ligado por mês, descendo até US$ 1 à medida que adiciona números, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Preciso de uma app própria da Meta para o Typebot?
Não. O guia do Typebot pressupõe uma, porque a maioria das pessoas liga o número por si. Com a Coexistence através de um Tech Provider, o token e os ids vêm da ligação e a Meta encaminha o webhook para o Typebot.
A equipa continua a ver no telemóvel as mensagens do bot?
Sim. As mensagens enviadas pela Cloud API aparecem na app WhatsApp Business no mesmo número, pelo que uma pessoa pode ler a conversa e assumi-la.
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 ambos precisarem dos eventos, aponte o destino para o n8n e faça o workflow reencaminhar o payload original para o callback URL do Typebot.
O Typebot guarda as conversas?
O Typebot mantém os seus próprios dados de sessão e de resultados, como em qualquer canal. A EasyCoexistence nunca guarda o conteúdo das mensagens: a Meta entrega diretamente no destino que definir.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em