Conectar o WhatsApp ao Chatwoot tem dois caminhos com naturezas opostas, e a maioria dos tutoriais brasileiros só mostra um deles, justamente o mais frágil. O caminho da porta da frente: o canal nativo do Chatwoot via API oficial da Meta. O caminho do puxadinho: pontes com Evolution API, Z-API e afins, que trazem o número por pareamento. Os dois colocam conversas de WhatsApp na caixa de entrada; o que muda é tudo o que acontece depois, do sincronismo do histórico ao dia em que algo cai.
TL;DR: O Chatwoot conecta WhatsApp de duas formas: via Cloud API oficial da Meta (canal nativo do produto, com cadastro empresarial, templates e tarifas da tabela oficial: atendimento reativo gratuito, marketing a US$ 0,0625 por mensagem no Brasil desde julho de 2025) ou via ferramentas de pareamento (Evolution API com conector embutido, Z-API por ponte), sem burocracia de entrada e com os riscos conhecidos: banimento possível, mensagens do celular que somem do painel, dessincronia. Para operação comercial, a conexão oficial ganhou o desempate definitivo em 2025 com o modo coexistência: o aplicativo do celular continua funcionando junto da API.
Caminho 1: o canal oficial nativo
O Chatwoot traz o WhatsApp Cloud API como tipo de inbox nativo: você cadastra o número na plataforma da Meta (conta business, verificação, número dedicado), gera as credenciais e configura o canal no Chatwoot com token e webhook. A partir daí, o funcionamento é o contratual: mensagens de clientes chegam à caixa de entrada, respostas dentro da janela de 24 horas são livres e gratuitas, mensagens ativas fora da janela usam templates aprovados com as tarifas da tabela da Meta.
Os custos desse caminho são de cerimônia, não de risco: o cadastro empresarial leva dias, mensagens ativas dependem de template aprovado, e o número passa a operar sob as regras publicadas da plataforma. Em troca, não existe QR code, não existe sessão para cair, e não existe o vetor de banimento por automação: a automação é o serviço contratado.
Caminho 2: as pontes de pareamento
Quem quer evitar a cerimônia conecta por pareamento, e o ecossistema oferece duas rotas principais: a Evolution API, que traz conector de Chatwoot embutido (a rota mais montada do open source brasileiro), e a Z-API via ponte própria, para quem prefere a conexão como serviço. Nas duas, o número entra escaneando QR code, sem cadastro na Meta, e as conversas fluem em minutos.
O preço aparece nas três frestas documentadas publicamente: mensagens enviadas pelo celular que não aparecem no painel (issue #485 do repositório da Evolution API, entre outros relatos), remetente trocado em certas configurações (issue #8712 do Chatwoot) e o risco estrutural do regime: número pareado pode ser banido pela plataforma, e a sessão cai quando o protocolo muda. Para suporte interno tolerante a falha, é um trade aceitável; para o canal que fecha vendas, é operar o caixa da empresa num gerador emprestado.
O desempate que mudou em 2025: coexistência
Durante anos, o caminho oficial tinha um custo que empurrava todo mundo para o puxadinho: registrar o número na Cloud API significava perder o WhatsApp do celular. Quem mandava no argumento era o dono da empresa, que não abre mão de responder do bolso. Esse argumento expirou: o modo coexistência, documentado pela Meta (2025), conecta o número do WhatsApp Business à Cloud API mantendo o aplicativo ativo, com sincronização de até 180 dias de conversas individuais e eco das mensagens do app chegando ao sistema via webhooks documentados, exatamente a fresta número um do caminho 2, resolvida por desenho no caminho 1.
Requisitos e limites documentados: app na versão 2.24.17 ou superior, onboarding via parceiro da plataforma, grupos fora da sincronização, transmissões desativadas e vazão de 20 mensagens por segundo.
Qual caminho para qual operação
| Situação | Caminho indicado | Justificativa |
|---|---|---|
| Suporte interno, tolera queda | Pareamento (Evolution + conector) | Custo zero de licença, atritos administráveis |
| Vendas pelo WhatsApp | Oficial (nativo ou coexistência) | Canal de receita não opera sem contrato |
| Dono responde do celular | Oficial com coexistência | App preservado + eco documentado no painel |
| Agência conectando clientes | Oficial, de preferência em plataforma | Ban de cliente é dano de marca; pareamento multiplica risco |
Para a última linha, o registro de interesse: montar Chatwoot + conexão + CRM + pontes para cada cliente é um projeto de integração contínuo, e a alternativa de plataforma única com API oficial nativa (incluindo coexistência), atendimento e CRM juntos é o Cubo Suite, inclusive white label para operar com a sua marca. O quadro completo do Chatwoot, forças e fronteiras, está no guia do Chatwoot.
O Chatwoot conecta WhatsApp por QR code nativamente?
Não: o canal nativo é a Cloud API oficial. Conexão por QR code entra apenas via ferramentas de terceiros (Evolution API, Z-API) integradas por conector ou ponte, com os atritos e riscos do pareamento.
Quanto custa o WhatsApp oficial no Chatwoot?
O Chatwoot não cobra pelo canal; as tarifas são da Meta, por mensagem desde julho de 2025: atendimento iniciado pelo cliente gratuito, utilidade gratuita na janela de 24h, marketing a US$ 0,0625 por mensagem no Brasil.
Dá para usar o mesmo número no app e no Chatwoot?
No pareamento, sim, com a instabilidade conhecida. No caminho oficial, o modo coexistência da Meta (2025) mantém app e API no mesmo número, com histórico individual sincronizado, os dois lados vendo a mesma conversa.
Deixe um comentário