Existe um usuário específico para quem este artigo foi escrito: quem opera Chatwoot com WhatsApp via ponte não oficial, convive com as mensagens do celular sumindo do painel, e já ouviu falar que “agora dá para usar a API oficial sem perder o app”. A notícia é verdadeira, tem nome (modo coexistência), tem documentação da Meta por trás, e muda o cálculo de quem estava adiando a regularização da conexão por causa do celular do dono.
TL;DR: A coexistência, documentada pela Meta (2025), permite registrar o número do WhatsApp Business na Cloud API oficial mantendo o aplicativo funcionando: é a combinação que o arranjo Chatwoot + ponte não oficial tentava imitar, agora com contrato. Para quem usa Chatwoot: o canal oficial nativo passa a receber também o eco das mensagens enviadas pelo app (webhooks documentados), o histórico individual sincroniza até 180 dias no onboarding, e as frestas clássicas da ponte (mensagem do celular sumida, remetente trocado, ban) saem do desenho. Requisitos: app 2.24.17+, onboarding via parceiro da plataforma; limites: grupos fora, transmissões desativadas, 20 mensagens/segundo.
O problema que a coexistência resolve para quem usa Chatwoot
O arranjo mais comum do Chatwoot brasileiro (ponte com Evolution API ou Z-API) existe por um único motivo histórico: era o jeito de ter o número no painel sem abrir mão do aplicativo. O custo desse arranjo está documentado nos próprios repositórios: mensagens do celular que não chegam ao painel, remetente invertido, dessincronia após updates, e o risco permanente de banimento do regime não oficial.
A coexistência ataca exatamente essa lista. Pela documentação da Meta: o número entra na Cloud API e o app permanece ativo; o que o dono responde pelo celular chega ao sistema conectado por webhooks de eco (que o sistema deve espelhar, por especificação); a importação inicial traz contatos e até 180 dias de conversas individuais na janela de 24h. O painel e o bolso passam a contar a mesma história por contrato, não por gambiarra bem ajustada.
Como fica a arquitetura com Chatwoot
O Chatwoot já possui o canal nativo de WhatsApp Cloud API. Com um número em coexistência, esse canal é o destino natural: as credenciais da Cloud API alimentam a inbox oficial, e a ponte não oficial se aposenta. Dois pontos de atenção práticos:
- O onboarding de coexistência passa por parceiros da plataforma (Solution Partners/Tech Providers, na nomenclatura da Meta): o fluxo de vincular o número do app à Cloud API é oferecido por plataformas parceiras, não por um botão avulso no painel da Meta. Na prática, você conecta através de quem implementa esse fluxo.
- O espelhamento do eco é responsabilidade do sistema conectado: a Meta entrega os webhooks; exibi-los correta e completamente na linha do tempo é trabalho da plataforma que recebe. Ao avaliar por onde conectar, teste especificamente esse caminho: mensagem enviada pelo app aparecendo no painel, com autor certo.
O que muda e o que se perde (lista da documentação)
| Item | Ponte não oficial | Coexistência (oficial) |
|---|---|---|
| Mensagens do app no painel | Falha conhecida (issues públicas) | Eco documentado por webhook |
| Risco de ban por automação | Permanente | Fora do desenho: automação é o produto |
| Histórico na conexão | Não sincroniza | Até 180 dias de conversas 1:1 |
| Grupos | Acessíveis via ponte | Fora da sincronização (só no app) |
| Transmissões do app | Funcionam | Desativadas |
| Mensagens temporárias 1:1 | Funcionam | Desligadas |
| Custo por mensagem | Zero (e sem contrato) | Serviço grátis; marketing US$ 0,0625/msg (Meta, 2025) |
| Vazão | Sem limite formal | 20 msg/segundo, documentado |
Quem depende operacionalmente de grupos via API ou das listas de transmissão do app precisa pesar as duas linhas do meio antes de migrar: são as perdas reais do desenho, e é melhor descobri-las na tabela do que na segunda-feira seguinte.
Vale migrar o Chatwoot para coexistência?
Se o número é canal de receita: sim, e o argumento que segurava a decisão já não existe. A régua completa entre os dois regimes está em WhatsApp no Chatwoot. Vale também registrar a segunda pergunta, a que costuma aparecer três meses depois da primeira: se a operação é de vendas, a caixa de entrada regularizada continua sem funil, kanban e valor de negociação, a fronteira que mapeamos em Chatwoot é um CRM?. Para quem vai resolver as duas coisas de uma vez, conexão oficial com coexistência nativa, atendimento e CRM no mesmo banco é o desenho do Cubo Suite, interesse declarado desta casa.
O Chatwoot suporta o modo coexistência?
O Chatwoot opera o canal WhatsApp Cloud API; a coexistência é uma modalidade de registro do número nessa mesma Cloud API, com onboarding via parceiros da plataforma. O ponto a validar na sua implementação é o espelhamento completo dos webhooks de eco na linha do tempo.
Migro da Evolution API para a coexistência sem trocar de número?
Sim: a coexistência foi desenhada para levar o número existente do app à Cloud API. O histórico da sessão não oficial não migra; o do aplicativo sincroniza (até 180 dias de conversas individuais). O processo está no nosso guia de migração com coexistência.
As conversas de grupo aparecem no Chatwoot com coexistência?
Não: pela documentação da Meta, grupos ficam fora da sincronização e seguem existindo apenas no aplicativo. Operação dependente de grupos via API precisa pesar essa perda antes de migrar.
Deixe um comentário