Use um número Coexistence como caixa de entrada WhatsApp Cloud do Chatwoot
A caixa de entrada WhatsApp Cloud do Chatwoot pede três valores: o id da WhatsApp Business Account, o phone number id e um token de acesso. Um número Coexistence disponibiliza os três. Crie a caixa de entrada com eles, defina o destino do webhook do número como o URL de webhook do Chatwoot, com o mesmo verify token, e a equipa pode responder a partir do Chatwoot e do telemóvel.
WABA id, phone number id e um token de acesso: o que a configuração manual do WhatsApp Cloud no Chatwoot pede.
O Chatwoot trata este evento Coexistence, por isso as respostas enviadas a partir da app WhatsApp Business aparecem na conversa.
A Meta permite que um número de telefone empresarial tenha o seu próprio URL de callback de webhook, que substitui o predefinido da app.
Como se liga um número Coexistence ao Chatwoot?
Em dois locais, por esta ordem.
No Chatwoot, adicione uma caixa de entrada, escolha WhatsApp e selecione o fornecedor WhatsApp Cloud com a configuração manual. Introduza o número, o phone number id, o id da WhatsApp Business Account e o token de acesso, que o painel da EasyCoexistence mostra para a ligação, ou que get_api_credentials devolve a um assistente. O Chatwoot apresenta então um URL de webhook e um webhook verify token para a caixa de entrada.
Na EasyCoexistence, defina o destino do webhook do número como esse URL e introduza o mesmo verify token. A Meta envia o pedido de verificação ao Chatwoot, o Chatwoot responde-lhe e, a partir daí, todas as mensagens para o número chegam à caixa de entrada. Nada corre pelo meio, por isso não há nenhum workflow para manter ativo.
As respostas enviadas do telemóvel aparecem no Chatwoot?
Sim. Num número Coexistence, uma resposta escrita na app WhatsApp Business é comunicada pela Meta como um evento smb_message_echoes, e o job de webhook do Chatwoot reconhece esse campo e regista a mensagem como enviada, na conversa certa. O código-fonte descreve o caso diretamente: empresas que respondem tanto a partir do Chatwoot como da app, com as mensagens sincronizadas no Chatwoot.
Isto faz a divisão funcionar na prática. O proprietário pode continuar a responder aos clientes habituais a partir do telemóvel, a equipa pode trabalhar a caixa de entrada partilhada numa secretária, e cada um vê o que o outro enviou sem que ninguém reencaminhe capturas de ecrã.
As mensagens enviadas do Chatwoot saem pela Cloud API no mesmo número, pelo que também aparecem no telemóvel.
Porque é que a caixa de entrada do Chatwoot não deve ter app secret?
Porque as entregas são assinadas com um segredo que não possui. A Meta assina cada webhook com o app secret da app titular da subscrição, que é a app da EasyCoexistence, e esse segredo nunca é partilhado.
No código atual do Chatwoot, o cabeçalho X-Hub-Signature-256 só é verificado num canal WhatsApp Cloud configurado manualmente quando existe um app secret guardado nesse canal, ou quando o canal foi criado através do embedded signup do próprio Chatwoot. Uma caixa de entrada manual sem app secret aceita as entregas; uma com qualquer app secret preenchido rejeita todas como não autorizadas.
O verify token é a proteção que se aplica aqui. Escolha um valor aleatório e longo, pois é ele que permite ao Chatwoot distinguir o pedido de verificação da Meta de qualquer outro.
O que não pode o Chatwoot fazer neste número?
Receber webhooks em dois locais ao mesmo tempo. A Meta encaminha os webhooks de um número para um único destino, pelo que, enquanto o Chatwoot o ocupa, um workflow do n8n não recebe os mesmos eventos. Se precisar dos dois, aponte o destino para um pequeno relay seu que reencaminhe cada entrega para o Chatwoot e para o workflow.
Os limites da Coexistence aplicam-se como em qualquer outro lado: a API envia até 20 mensagens por segundo, o texto livre só pode ser enviado nas 24 horas seguintes à última mensagem do cliente, e os templates cobrem tudo o que vem depois.
A app WhatsApp Business continua a precisar de ser aberta pelo menos uma vez de 14 em 14 dias, algo que a EasyCoexistence vigia.
Erros comuns
- Preencher um app secret na caixa de entrada do Chatwoot. As entregas são assinadas com o segredo da app da EasyCoexistence, por isso o Chatwoot rejeita todas como não autorizadas.
- Usar na EasyCoexistence um verify token diferente do que o Chatwoot mostra. A verificação da Meta falha e a caixa de entrada nunca recebe nenhuma mensagem.
- Escolher o embedded signup do Chatwoot em vez do fluxo manual. Isso liga o número através da app Meta do próprio Chatwoot, que é uma ligação separada.
Ligue o número em easycoexistence.com, copie as credenciais para uma caixa de entrada WhatsApp Cloud do Chatwoot e defina o destino do webhook como o Chatwoot. A partir de US$ 9 por número por mês, descendo até US$ 1 à medida que adiciona números, com os primeiros 3 dias grátis.
Perguntas frequentes
Isto funciona num Chatwoot self-hosted?
Sim. O URL do webhook usa o seu próprio domínio do Chatwoot em vez de app.chatwoot.com, e o resto da configuração é igual.
Preciso de uma app Meta própria para o Chatwoot?
Não. O número é ligado através da EasyCoexistence, que fornece as credenciais e encaminha os webhooks. O guia do Chatwoot descreve a criação de uma app Meta apenas porque parte do princípio de que não tem nenhuma.
Podem entrar vários números no Chatwoot?
Sim. Crie uma caixa de entrada WhatsApp Cloud por número e defina o destino do webhook de cada número como o URL e o verify token da respetiva caixa de entrada.
A EasyCoexistence vê as conversas?
Não. A Meta entrega os webhooks diretamente ao Chatwoot, e a EasyCoexistence nunca guarda o conteúdo das conversas.
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