Use um número Coexistência como caixa de entrada WhatsApp Cloud do Chatwoot
A caixa de entrada WhatsApp Cloud do Chatwoot pede três valores: o WhatsApp Business Account id, o phone number id e um token de acesso. Um número Coexistência expõe os três. Crie a caixa de entrada com eles, depois defina o destino do webhook do número como a URL de webhook do Chatwoot, com o mesmo token de verificação, e a equipe responde pelo Chatwoot e pelo celular.
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 da Coexistência, então as respostas enviadas pelo app do WhatsApp Business aparecem na conversa.
A Meta permite que um número de telefone comercial tenha sua própria URL de callback de webhook, substituindo a padrão do app.
Como conectar um número Coexistência ao Chatwoot?
Em dois lugares, nesta ordem.
No Chatwoot, adicione uma caixa de entrada, escolha WhatsApp e selecione o provedor WhatsApp Cloud com a configuração manual. Informe o número, o phone number id, o WhatsApp Business Account id e o token de acesso, todos exibidos no painel do EasyCoexistence para a conexão, ou retornados por get_api_credentials a um assistente. O Chatwoot então mostra uma URL de webhook e um token de verificação do webhook para a caixa de entrada.
No EasyCoexistence, defina o destino do webhook do número como essa URL e informe o mesmo token de verificação. A Meta envia a requisição de verificação ao Chatwoot, o Chatwoot responde, e a partir daí toda mensagem para o número chega na caixa de entrada. Nada roda no meio, então não há workflow para manter vivo.
As respostas enviadas pelo celular aparecem no Chatwoot?
Sim. Em um número Coexistência, uma resposta digitada no app do WhatsApp Business é informada pela Meta como um evento smb_message_echoes, e o job de webhook do Chatwoot reconhece esse campo e registra a mensagem como enviada, na conversa certa. O código-fonte descreve o caso diretamente: empresas respondendo tanto pelo Chatwoot quanto pelo app, com as mensagens sincronizadas no Chatwoot.
Isso faz a divisão funcionar na prática. O dono pode continuar atendendo clientes frequentes pelo celular, a equipe pode trabalhar a caixa de entrada compartilhada na mesa, e cada um vê o que o outro enviou, sem ninguém encaminhar prints.
As mensagens enviadas pelo Chatwoot saem pela Cloud API no mesmo número, então também aparecem no celular.
Por que a caixa de entrada do Chatwoot não deve ter segredo do app?
Porque as entregas são assinadas com um segredo que você não tem. A Meta assina cada webhook com o segredo do app dono da assinatura, que é o app do EasyCoexistence, e esse segredo nunca é compartilhado.
No código atual do Chatwoot, o cabeçalho X-Hub-Signature-256 de um canal WhatsApp Cloud configurado manualmente só é verificado quando um segredo do app foi armazenado nele, ou quando o canal foi criado pelo Embedded Signup do próprio Chatwoot. Uma caixa de entrada manual sem segredo do app aceita as entregas; uma com qualquer segredo do app preenchido rejeita todas como não autorizadas.
O token de verificação é a proteção que vale aqui. Escolha um valor longo e aleatório, pois é ele que permite ao Chatwoot distinguir a requisição de verificação da Meta de qualquer outra.
O que o Chatwoot não consegue fazer neste número?
Receber webhooks em um segundo lugar ao mesmo tempo. A Meta encaminha os webhooks de um número para um único destino, então 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 repasse cada entrega ao Chatwoot e ao workflow.
Os limites da Coexistência valem como em qualquer lugar: a API envia até 20 mensagens por segundo, texto livre só sai dentro de 24 horas após a última mensagem do cliente, e os templates cobrem todo o resto.
O app do WhatsApp Business ainda precisa ser aberto pelo menos uma vez a cada 14 dias, e o EasyCoexistence vigia isso.
Erros comuns
- Preencher um segredo do app na caixa de entrada do Chatwoot. As entregas são assinadas com o segredo do app do EasyCoexistence, então o Chatwoot rejeita todas como não autorizadas.
- Usar no EasyCoexistence um token de verificação diferente do que o Chatwoot mostra. A verificação da Meta falha e a caixa de entrada nunca recebe mensagem.
- Escolher o Embedded Signup do Chatwoot em vez do fluxo manual. Isso conecta o número pelo app da Meta do próprio Chatwoot, uma conexão separada.
Conecte 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 conectado por mês, caindo até US$ 1 conforme você adiciona números, com os 3 primeiros dias grátis.
Perguntas frequentes
Isso funciona no Chatwoot hospedado por conta própria?
Sim. A 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 um app da Meta próprio para o Chatwoot?
Não. O número é conectado pelo EasyCoexistence, que fornece as credenciais e encaminha os webhooks. O guia do Chatwoot descreve a criação de um app da Meta só porque presume que você não tem nenhum.
Dá para colocar 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 a URL e o token de verificação da caixa de entrada correspondente.
O EasyCoexistence vê as conversas?
Não. A Meta entrega os webhooks direto ao Chatwoot, e o EasyCoexistence nunca armazena o conteúdo das conversas.
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