Ligar um bot Botpress ao WhatsApp com Coexistence
Use a integração WhatsApp do Botpress em Manual Configuration. Cole o access token e o phone number id do número ligado, escolha um verify token e deixe App ID e Client Secret vazios. Depois defina o URL do webhook do Botpress e esse verify token como destino do webhook do número, e a Meta entrega todas as mensagens ao bot.
Campo Client Secret do Botpress: se ficar vazio, a verificação da assinatura do webhook é ignorada.
Campos de webhook que o guia do Botpress subscreve, incluindo mensagens e atualizações de estado dos templates.
A janela de atendimento ao cliente que uma mensagem do cliente abre, dentro da qual pode ser enviada qualquer mensagem de serviço.
Que configuração do Botpress funciona com um número Coexistence?
Manual Configuration. As outras opções ligam um número através da app Meta do próprio Botpress, o que é uma associação separada do número e não uma forma de usar um número já ligado.
Na integração WhatsApp, abra a lista pendente Configuration e escolha Manual Configuration. Esta 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 ligação: o painel mostra-os e get_api_credentials devolve-os a um assistente. O verify token é qualquer texto que 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 marca-o como opcional e indica que, sem ele, a verificação da assinatura é ignorada. Isto importa, porque a Meta assina cada entrega com o app secret do Tech Provider, que nenhum cliente possui.
Como recebe o webhook do Botpress as mensagens da Meta?
Através do destino do webhook do número. O guia do Botpress manda colar o URL do webhook e o verify token na configuração WhatsApp de uma app Meta. Aqui não existe nenhuma app Meta sua: a Meta encaminha os eventos do número para o destino que a ligação indicar. Copie, por isso, o URL do webhook que o Botpress mostra para a integração e defina-o, 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-lhe e a entrega começa. Quando o Botpress guarda uma configuração manual, verifica também o token perguntando à Graph que app o emitiu, pelo que um token inválido ou revogado falha ao guardar e não na primeira mensagem.
O handler do Botpress processa ainda smb_message_echoes, o evento que a Meta envia quando alguém responde a partir da app WhatsApp Business. Assim, uma resposta dada pelo telemóvel fica visível para o bot, em vez de lhe ser 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 deve o bot saber sobre a Coexistence?
Que uma pessoa pode já estar a falar. A app WhatsApp Business continua a funcionar no número, pelo que um cliente pode receber uma resposta do telemóvel e outra do bot no mesmo minuto. Defina no fluxo o que acontece quando chega um eco: a maioria das equipas pausa o bot para esse contacto durante algum tempo, para que a pessoa que interveio não seja interrompida.
A segunda questão é o tempo. Um bot que responde a mensagens recebidas trabalha dentro da janela de atendimento ao cliente de 24 horas, onde o texto livre é permitido. Um fluxo que envia algo um dia depois, um seguimento ou um lembrete, precisa de um template aprovado, e o texto livre nesse caso devolve o erro 131047. O guia do Botpress subscreve os campos de estado dos templates precisamente para este tipo de mensagem proativa.
E o throughput é fixo, com 20 mensagens por segundo num número Coexistence, muito acima do que um bot conversacional envia.
Erros comuns
- Preencher o Client Secret com o secret da sua própria app Meta. A assinatura nunca coincide e o Botpress responde a cada entrega com 401.
- Escolher a opção OAuth ou sandbox em vez de Manual Configuration. Essas ligam um número através da app do próprio Botpress, não do número já ligado.
- Ignorar os ecos. Sem uma regra para as respostas enviadas pelo telemóvel, o bot responde por cima de uma pessoa que já interveio.
Ligue o número em easycoexistence.com, cole o token e o phone number id na Manual Configuration do Botpress e defina o URL do webhook do Botpress como destino. A partir de US$ 9 por número ligado por mês, a descer até US$ 1 à medida que adiciona números, com os primeiros 3 dias grátis.
Perguntas frequentes
É seguro ignorar a verificação da assinatura?
A proteção passa para o URL. O Botpress gera o URL do webhook por integração, por isso mantenha-o privado. Os ficheiros multimédia continuam a ter de ser obtidos junto da Meta com o token, o que um evento falsificado não consegue simular.
O mesmo número pode alimentar também o n8n?
Um número tem um único destino de webhook. Aponte-o para um sistema e reencaminhe a partir daí, se um segundo precisar dos eventos.
O Botpress precisa do meu WABA id?
A definição marca-o como opcional por agora e indica que será obrigatório numa futura versão principal, pelo que convém preenchê-lo a partir da ligação.
As mensagens passam pela EasyCoexistence?
Não. A Meta entrega diretamente no URL do webhook do Botpress e o conteúdo nunca é guardado do nosso lado.
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