Conectar um bot do Botpress ao WhatsApp com Coexistência
Use a integração de WhatsApp do Botpress em Manual Configuration. Cole o access token e o phone number id do número conectado, escolha um verify token e deixe App ID e Client Secret vazios. Depois defina a URL de webhook do Botpress e esse verify token como destino do webhook do número, e a Meta entrega cada mensagem ao bot.
Campo Client Secret do Botpress: se ficar vazio, a verificação de assinatura do webhook é ignorada.
Campos de webhook que o guia do Botpress assina, incluindo mensagens e atualizações de status de template.
A janela de atendimento que a mensagem de um cliente abre, dentro da qual qualquer mensagem de serviço pode ser enviada.
Qual configuração do Botpress funciona com um número em Coexistência?
Manual Configuration. As outras opções conectam um número pelo app da Meta do próprio Botpress, o que é um novo onboarding do número, e não uma forma de usar um número que já está conectado.
Na integração de WhatsApp, abra o menu suspenso Configuration e escolha Manual Configuration. Ele pede um Verify Token, um Access Token, um Default Bot Phone Number ID e, opcionalmente, um App ID, um Client Secret e um WABA ID.
O access token, o phone number id e o WABA id vêm da conexão: o painel mostra os três, e get_api_credentials os devolve a um assistente. O verify token é qualquer texto que você escolher. App ID e Client Secret ficam vazios. O guia do Botpress apresenta o secret como um campo a preencher, mas a definição da integração o marca como opcional e diz que, sem ele, a verificação de assinatura é ignorada. Isso importa, porque a Meta assina cada entrega com o app secret do Tech Provider, que nenhum cliente possui.
Como o webhook do Botpress recebe as mensagens da Meta?
Pelo destino do webhook do número. O guia do Botpress manda colar a URL de webhook dele e o seu verify token na configuração de WhatsApp de um app da Meta. Aqui você não tem um app da Meta: a Meta encaminha os eventos do número para o destino que a conexão indicar. Então copie a URL de webhook que o Botpress mostra para a integração e defina-a, com o mesmo verify token, como destino no painel ou com set_webhook_destination.
A Meta envia um GET de verificação, o Botpress responde e a entrega começa. Quando o Botpress salva uma configuração manual, ele também confere o token perguntando ao Graph qual app o emitiu, então um token inválido ou revogado falha na hora de salvar, e não na primeira mensagem.
O handler do Botpress também processa smb_message_echoes, o evento que a Meta envia quando alguém responde pelo app do WhatsApp Business. Assim, uma resposta dada pelo celular fica visível para o bot, em vez de invisível.
| Required? | What to enter | |
|---|---|---|
| Access Token | Required | The connected number's token |
| Default Bot Phone Number ID | Required | The connected number's phone number id |
| Verify Token | Required | Any string, reused in the webhook destination |
| WABA ID | Optional | The connected number's WABA id |
| App ID and Client Secret | Optional | Leave both empty |
O que o bot precisa saber sobre a Coexistência?
Que um humano pode já estar conversando. O app do WhatsApp Business continua funcionando no número, então um cliente pode receber uma resposta do celular e outra do bot no mesmo minuto. Defina no fluxo o que acontece quando um eco chega: a maioria das equipes pausa o bot para aquele contato por um tempo, para não falar por cima de quem entrou na conversa.
O segundo ponto é o tempo. Um bot que responde mensagens recebidas trabalha dentro da janela de atendimento de 24 horas, em que texto livre é permitido. Um fluxo que envia algo um dia depois, um acompanhamento ou um lembrete, precisa de um template aprovado, e texto livre nesse caso retorna o erro 131047. O guia do Botpress assina os campos de status de template justamente para esse tipo de mensagem proativa.
E o throughput é fixo em 20 mensagens por segundo para um número em Coexistência, muito acima do que um bot conversacional envia.
Erros comuns
- Preencher o Client Secret com o secret do seu próprio app da Meta. A assinatura nunca confere e o Botpress responde 401 a cada entrega.
- Escolher a opção OAuth ou sandbox em vez de Manual Configuration. Elas conectam um número pelo app do próprio Botpress, e não pelo que já está conectado.
- Ignorar os ecos. Sem uma regra para respostas enviadas pelo celular, o bot responde por cima de uma pessoa que já entrou na conversa.
Conecte o número em easycoexistence.com, cole o token e o phone number id dele na Manual Configuration do Botpress e defina a URL de webhook do Botpress como destino. A partir de US$ 9 por número conectado por mês, caindo até US$ 1 conforme você adiciona números, com os 3 primeiros dias grátis.
Perguntas frequentes
Ignorar a verificação de assinatura é seguro?
A proteção passa para a URL. O Botpress gera a URL de webhook por integração, então mantenha-a privada. A mídia ainda precisa ser buscada na Meta com o token, algo que um evento forjado não consegue fazer.
O mesmo número também pode alimentar o n8n?
Um número tem um único destino de webhook. Aponte-o para um sistema e encaminhe a partir dele se um segundo precisar dos eventos.
O Botpress precisa do meu WABA id?
A definição o marca como opcional por enquanto e diz que ele será obrigatório em uma versão principal futura, então preencha-o com o dado da conexão.
As mensagens passam pela EasyCoexistence?
Não. A Meta entrega direto na URL de webhook do Botpress, e o conteúdo nunca é armazenado do nosso lado.
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