O Chatwoot self-hosted pode usar a API oficial do WhatsApp sem App Review da Meta?

Em resumo: sim, e o seu número continua funcionando no app WhatsApp Business do celular. O ZapClaw conecta o número à API Cloud oficial da Meta pela Coexistência e responde ao canal WhatsApp Cloud nativo do Chatwoot do mesmo jeito que a Meta. Sem app próprio na Meta, sem App Review, sem fork: uma variável de ambiente e uma chamada de API por número.

O que o ZapClaw traz para o Chatwoot

• A API oficial, não uma biblioteca não oficial. As mensagens passam pela API Cloud da Meta, e não por um cliente que imita o WhatsApp Web, o tipo de conexão que contraria os termos do WhatsApp e põe números em risco.
• O número continua no celular. Com a Coexistência, o app WhatsApp Business segue funcionando ao lado do Chatwoot. A Meta só libera a Coexistência para Tech Providers e Solution Partners. O ZapClaw é Tech Provider da Meta, então você não precisa virar um.
• Os números dos seus clientes, sem App Review. Um app usado por outras empresas precisa passar pelo App Review da Meta. Os seus clientes conectam pelo Embedded Signup do ZapClaw, em minutos, e os planos pagos aceitam números ilimitados.
• Chatwoot e a sua automação no mesmo número. Um webhook nativo pode funcionar junto com o Chatwoot, e assim um bot ou um fluxo no n8n também recebe cada mensagem.

Configuração: uma variável e uma chamada de API por número

1. Crie a sua conta no ZapClaw e conecte o número na janela da Meta, pelo Embedded Signup.
2. No painel, crie uma chave de API para o Chatwoot e informe o endereço do seu Chatwoot na seção Chatwoot de Webhook. O ZapClaw mostra então a chave de assinatura e, para cada número, o comando do inbox já com os dados do número.
3. Defina WHATSAPP_CLOUD_BASE_URL como https://api.zapclaw.app nos contêineres web e Sidekiq do Chatwoot e reinicie os dois. A partir daí, todo inbox WhatsApp Cloud dessa instalação envia pelo ZapClaw.
4. Crie o inbox com uma chamada à API do Chatwoot, uma vez por número. A chamada define source como manual_setup_v2 e o app_secret do inbox como a chave de assinatura, o que liga a verificação de assinatura do Chatwoot.
5. Clique em Enviar evento de teste e mande uma mensagem de WhatsApp para o número. Ela aparece no Chatwoot, e as respostas saem pelo ZapClaw.

Por que não pela tela do próprio Chatwoot? Desde o Chatwoot 4.18, a tela de WhatsApp Cloud confere a chave em graph.facebook.com, que recusa uma chave do ZapClaw. A chamada de API cria o mesmo inbox nativo.

O Chatwoot envia pelo ZapClaw a partir da versão 2.15. Use a 4.14 ou mais recente, que também confere a assinatura de cada entrega com o app_secret do inbox. A variável WHATSAPP_APP_SECRET não participa: uma instalação padrão a ignora.

O Chatwoot responde 401?

Para quem é

Equipes e agências que rodam o Chatwoot no próprio servidor e querem manter o número no app WhatsApp Business, ter os números dos clientes no Chatwoot ou as duas coisas. Se for um único número seu e ele não precisar do app, o Chatwoot pode se conectar direto à Meta, sem App Review.

Para ir além

• O guia completo do Chatwoot (em inglês), com cada campo e a solução de problemas.
• chatwoot-zapclaw no GitHub: um script que testa a sua chave antes de mexer no Chatwoot, e um exemplo de Compose.
• O que é preciso para conectar um número pela Coexistência.
• Planos e preços, do plano grátis ao plano Agência para agências.