Chatwoot + WhatsApp em produção
Atendimento humano com inbox compartilhado, sem middleware de terceiros: a WPPAPI fala com o Chatwoot nativamente, nos dois sentidos.
Crie um inbox do tipo API no Chatwoot
No Chatwoot (cloud ou self-hosted, 4.13+ recomendado), vá em Settings → Inboxes → Add Inbox → API. Dê um nome (ex.: WhatsApp Vendas) e conclua. Anote o account ID e o inbox ID que aparecem na URL.
Copie as credenciais
Em Profile Settings, copie seu Access Token. Em Settings → Inboxes → seu inbox API → Configuration, copie também o webhook signing secret — é ele que garante que só o Chatwoot chama a sua callback.
Ative o Chatwoot nativo na WPPAPI
No painel da WPPAPI, abra a instância conectada ao seu número e clique em Chatwoot nativo. Informe a URL do Chatwoot, account ID, inbox ID, access token e o signing secret. A WPPAPI gera a URL de callback automaticamente.
Teste o fluxo completo
Envie uma mensagem de WhatsApp para o número: ela vira uma conversa no inbox, com contato criado automaticamente. Responda pelo Chatwoot: a resposta sai pelo WhatsApp em segundos. Mensagens enviadas pelo celular também podem ser importadas para manter o histórico completo.
Segurança da callback
A URL de callback usa um token aleatório de 256 bits. Com o signing secret configurado (Chatwoot 4.13+), a WPPAPI opera fail-closed: exige assinaturaX-Chatwoot-Signature válida e timestamp com no máximo 5 minutos — requisições sem assinatura correta são rejeitadas.
Perguntas frequentes
Preciso de algum conector ou middleware entre os dois?
Não. A integração é nativa: a WPPAPI conversa direto com a API do Chatwoot e recebe a callback do inbox. Menos uma peça para instalar, monitorar e quebrar.
Funciona com Chatwoot self-hosted?
Sim, cloud ou self-hosted. Para self-hosted, a URL do Chatwoot precisa ser acessível publicamente (ou pelo menos alcançável pela WPPAPI) e recomendamos Chatwoot 4.13+ para usar o signing secret.
E se o agente e o cliente mandarem mensagem ao mesmo tempo?
A ponte é idempotente: cada mensagem é mapeada por ID nos dois lados, então reentregas e corridas não duplicam conversa nem mensagem. Falhas ficam visíveis no painel e podem ser reprocessadas.
Veja também: WPPAPI vs Evolution API — se você considerava montar essa ponte à mão — e alista completa de integrações.
Teste com seu Chatwoot hoje
A integração nativa está disponível desde o trial — 3 dias grátis, sem cartão.
Criar conta grátis