WPPAPI
Guia · Atendimento

Chatwoot + WhatsApp em produção

Atendimento humano com inbox compartilhado, sem middleware de terceiros: a WPPAPI fala com o Chatwoot nativamente, nos dois sentidos.

Como funciona por baixo: mensagens recebidas no WhatsApp viram conversas incoming no inbox; respostas dos agentes voltam pela callback do inbox API e saem pelo número conectado. Contatos e conversas são criados e reutilizados automaticamente, com idempotência garantida por mapeamento de IDs.
1

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.

2

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.

3

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.

4

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 assinatura X-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 a lista 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