Chatwoot com WhatsApp oficial: como ligar a API da Meta ao seu Chatwoot

Quais são os caminhos para ligar o Chatwoot ao WhatsApp oficial?

Na prática, três. O canal WhatsApp Cloud nativo do Chatwoot, com cadastro pela Meta ou configuração manual. Uma ponte por webhook, montada no n8n, entre a Meta e o Chatwoot. Ou uma integração pronta, como a do Omnique, que conecta o número oficial e espelha as conversas numa caixa de entrada do seu Chatwoot.

O que o canal WhatsApp Cloud nativo do Chatwoot exige?

Um app seu na Meta. No Chatwoot auto-hospedado, o cadastro pela Meta só aparece depois que o super admin preenche WHATSAPP_APP_ID, WHATSAPP_CONFIGURATION_ID e WHATSAPP_APP_SECRET, tirados do painel de desenvolvedor. Na configuração manual, você informa o ID da conta do WhatsApp Business, o ID do número e um token permanente de usuário do sistema.

Para quem já tem app aprovado e sabe gerar token de usuário do sistema, o canal nativo funciona e não depende de ninguém no meio. É uma escolha legítima. O custo está no resto: a documentação do n8n lembra que a Meta classifica quem cria app de WhatsApp como Tech Provider, com as verificações que isso traz (o que significa está em como virar Tech Provider da Meta). O token precisa ser guardado com cuidado, e cada número novo de cliente repete o processo. Se você quer seguir por esse caminho, o roteiro está em como configurar a WhatsApp Cloud API.

Por que a mensagem chega no webhook e não aparece no Chatwoot?

É a queixa mais comum de quem monta a ponte por conta própria. No repositório do Chatwoot há issues abertas em que o evento chega, o Chatwoot responde 200 e a conversa não é criada, inclusive com o webhook passando pelo n8n desde a versão 4.9. O 200 confirma o recebimento, não a mensagem na tela.

O problema de fundo é que ninguém fica olhando a entrega. Se o Chatwoot aceitou e não gravou, a Meta considera o trabalho feito e não reenvia. Por isso a integração do Omnique registra cada mensagem espelhada numa trilha própria e, no sentido contrário, avisa o agente dentro da conversa quando uma resposta não sai. Se o seu caso é o webhook da Meta que nem chega, as causas mais comuns estão no guia de webhook do WhatsApp Cloud API.

Como funciona a integração do Omnique com o Chatwoot?

O Omnique recebe os eventos da Meta e espelha cada mensagem numa caixa de entrada do tipo API no seu Chatwoot, criando contato e conversa. Quando o agente responde, o Chatwoot avisa o Omnique, que envia pelo WhatsApp oficial. Os dois sentidos passam por filas próprias, com registro de cada entrega.

• Do WhatsApp para o Chatwoot: texto e mídia do cliente viram mensagens na conversa, com foto, vídeo, áudio e documento como anexo. O contato é encontrado ou criado pelo número.
• Do Chatwoot para o WhatsApp: só sai a mensagem escrita por agente humano naquela caixa. Nota privada, mensagem do próprio contato e o eco do que o Omnique espelhou são descartados. Sem essa trava, a mensagem do cliente voltaria para ele e a conversa entraria em loop, gastando mensagem paga na Meta.
• Fila separada: se o Chatwoot ficar lento ou fora do ar, as tentativas se acumulam na fila dele, e o repasse para o webhook de destino da instância continua normalmente.
• Token protegido: o token do Chatwoot é guardado cifrado e nunca volta para a tela nem para o navegador.

Como conectar o Chatwoot no Omnique, passo a passo?

Primeiro o número, depois o Chatwoot. Conecte o WhatsApp pelo login da Meta, junte três dados do Chatwoot (URL, ID da conta e token de acesso pessoal), preencha no menu da instância e salve. O Omnique cria a caixa de entrada e configura o webhook dela. Em seguida, teste com mensagem, foto e áudio.

1. No Omnique, em Conexões, conecte o número pelo login da Meta. Pode ser um número novo ou o que já está no app WhatsApp Business, por coexistência.
2. No Chatwoot, anote a URL do site (o endereço que você abre no navegador; pode colar o de qualquer tela) e o ID da conta, que é o número logo depois de /accounts/ no endereço.
3. Pegue o token de acesso pessoal: avatar no canto inferior esquerdo, Configurações do perfil, seção Token de acesso. Use um usuário administrador da conta, para a caixa de entrada poder ser criada automaticamente.
4. No Omnique, abra o menu da instância e clique em Conectar Chatwoot. Preencha os três campos.
5. Deixe o Omnique criar a caixa de entrada, ou ligue Usar caixa nativa e informe o ID de uma caixa do tipo API que já existe (o número depois de /settings/inboxes/).
6. Salve. O Omnique configura sozinho o webhook da caixa no Chatwoot. Se a sua versão não aceitar a configuração automática, a tela mostra a URL para colar em Configurações, Caixas de entrada, Configuração. Sem esse passo, as respostas dos agentes não chegam ao WhatsApp.
7. Clique em Testar conexão e mande, do seu celular, uma mensagem, uma foto e um áudio para o número. Responda pelo Chatwoot com texto e com uma gravação de voz.

Três opções são ajustáveis e nenhuma é obrigatória: Assinatura, que acrescenta uma assinatura automática às mensagens; Evento ECHO, que replica no Chatwoot o que é enviado pelo celular; e Anúncio como Nota Privada, que registra anúncios e campanhas como nota privada na conversa, em vez de mensagem visível.

O que já vem resolvido: áudio, mídia, eco do celular e falhas?

Os pontos que mais quebram em integração caseira. A gravação de voz do agente sai no WhatsApp como mensagem de voz, a mídia vai e volta como anexo, o que alguém responde pelo celular aparece na conversa, e quando um envio falha o agente recebe uma nota privada dizendo o motivo, em vez de achar que o cliente leu.

Áudio como mensagem de voz

O Chatwoot rotula a gravação de voz como audio/opus, e a Cloud API recusa esse rótulo com o erro 131053, mesmo com o conteúdo certo. O Omnique corrige o formato antes de enviar e converte WAV e MP3 para Ogg/Opus mono, que é o que a Meta aceita como mensagem de voz. Do outro lado, o áudio que o cliente manda chega na conversa como anexo de áudio.

Eco do celular

Em coexistência, o número continua no app WhatsApp Business. Com o Evento ECHO ligado, a resposta que alguém da equipe dá pelo celular entra na mesma conversa do Chatwoot. O histórico fica inteiro, e ninguém responde de novo o que já foi respondido no aparelho.

Falha que não some calada

Quando a Meta recusa uma resposta do agente, o Omnique posta uma nota privada na conversa com o motivo em português: a janela de 24 horas fechou e só um template reabre, o número não tem WhatsApp, o arquivo passou do tamanho aceito, o token do canal expirou ou a Meta limitou o envio naquele momento.

Dá para usar o mesmo número no Chatwoot e no n8n?

Dá. Cada instância tem um webhook de destino e, à parte, a integração com o Chatwoot. A mesma mensagem do cliente vai para a caixa de entrada, onde a equipe atende, e para o n8n, onde roda a automação, como a qualificação por IA. As filas são separadas: um lado fora do ar não segura o outro.

No n8n, filtre pelo campo origin para processar só o que veio do cliente e não reagir ao que a própria equipe enviou. O passo a passo do lado da automação está em API oficial do WhatsApp no n8n.

Quanto custa o Chatwoot com WhatsApp oficial pelo Omnique?

O Omnique cobra por número: R$ 50 por mês de 1 a 4 números, sem taxa de ativação, com a integração do Chatwoot incluída. A Meta cobra cada mensagem entregue, direto no cartão cadastrado na conta dela. O Chatwoot segue na instalação que você já usa e não entra nessa conta.

Preços do NotificaMe Hub conferidos no site oficial em 6/10/2026; o plano Starter inclui um canal à escolha entre WhatsApp, Instagram, Telegram e outros. Para um número de WhatsApp, o Omnique custa R$ 70 a menos por mês e não cobra os R$ 150 de ativação. A comparação completa está em alternativa ao NotificaMe.

A mensagem é cobrada à parte pela Meta. No Brasil, pela tabela em reais vigente desde 1/10/2026, cada número tem 1.000 respostas grátis por mês dentro de 24 horas; da 1.001ª em diante, a resposta custa R$ 0,035, a mesma tarifa de utilidade e autenticação, e o marketing custa R$ 0,3217. Uma loja que responde 3.000 mensagens de atendimento no mês num número paga R$ 70 à Meta e R$ 50 ao Omnique. A tabela completa por volume de números está em preços.

Quando faz sentido ligar o Chatwoot direto na Meta?

Quando você já tem um app aprovado na Meta, opera poucos números e tem alguém para cuidar de token e webhook. O Omnique compensa quando você conecta números de clientes com frequência, quer áudio e eco do celular funcionando sem ajuste e precisa do mesmo número também no n8n ou no seu sistema.

Para quem instala Chatwoot para vários clientes, cada número vira uma instância com a sua caixa de entrada, sua chave de API e seu log, tudo na mesma conta. O modelo de operação com vários clientes está em API oficial do WhatsApp para agências.

Quer ver uma conversa do WhatsApp oficial abrindo no seu Chatwoot? Crie a conta, conecte o número e ligue o Chatwoot na instância. O teste grátis dura 3 dias, sem cartão.