Quem monta atendimento em equipe sobre a Z-API esbarra cedo numa parede: a API entrega a conexão, mas não entrega caixa de entrada. Vários atendentes respondendo pelo mesmo número, fila, atribuição de conversa: isso é trabalho de outra ferramenta, e a mais citada do ecossistema open source é o Chatwoot. A dupla Z-API + Chatwoot funciona, tem quem opere bem, e tem uma anatomia de riscos que vale conhecer antes de casar as duas assinaturas de manutenção.
TL;DR: A integração Z-API + Chatwoot se faz por ponte: os webhooks da Z-API alimentam a API de conversas do Chatwoot (via middleware próprio, n8n ou conectores da comunidade), e as respostas dos atendentes voltam pelos endpoints de envio da Z-API. Não há conector nativo oficial entre os dois, diferença relevante frente ao arranjo com Evolution API, que traz integração Chatwoot embutida. O resultado: mais uma peça de manutenção (a ponte) e os pontos cegos clássicos: mensagem do celular pareado, mídia e dessincronia pós-atualização.
A anatomia da integração
O Chatwoot fala com o mundo por inboxes de API: um canal genérico que aceita conversas criadas de fora. A ponte precisa fazer quatro trabalhos: receber o webhook da Z-API, localizar ou criar o contato e a conversa no Chatwoot, postar a mensagem recebida, e no sentido inverso escutar as respostas dos agentes (webhook do Chatwoot) e enviá-las pelos endpoints da Z-API. Implementações comuns dessa ponte: um serviço próprio pequeno, um fluxo de n8n dedicado (as regras de sobrevivência estão em integrações da Z-API) ou conectores mantidos pela comunidade.
Cada uma dessas implementações é código de alguém que precisa acompanhar dois alvos móveis: a API da Z-API e a API do Chatwoot. É aqui que o arranjo difere do primo famoso: a integração Evolution API + Chatwoot vem embutida na própria Evolution, com os defeitos conhecidos e documentados; a ponte com a Z-API é sua, ou de um terceiro que você escolhe.
Os três pontos cegos do arranjo
Mensagem do celular pareado. A resposta rápida que o dono dá pelo aplicativo precisa aparecer no Chatwoot para o histórico fazer sentido. Depende da ponte tratar os eventos de mensagem enviada, e é o ponto que mais falha nas implementações da categoria, com o efeito conhecido: atendente respondendo sem ver metade da conversa.
Mídia nos dois sentidos. Áudio do cliente subindo para o Chatwoot e imagem do atendente descendo pela Z-API passam por download e reupload na ponte. Teste com arquivos reais antes de operar, incluindo os grandes (o serviço anuncia suporte até 100 MB; a sua ponte precisa aguentar o mesmo).
Dessincronia pós-atualização. Três peças versionadas (Z-API, ponte, Chatwoot), três changelogs para acompanhar. A disciplina é a mesma recomendada para toda a pilha: versão fixada em produção, atualização em janela com teste do caminho completo.
A conta honesta do arranjo
Somando: assinatura da Z-API por instância, hospedagem do Chatwoot (VPS própria ou cloud pago), a ponte para manter e o plantão das três. Para operação técnica com gente disponível, é um arranjo defensável e barato em licenças. Para agência atendendo clientes, cada elo é um lugar onde a falha aparece com a marca da agência em cima, e o diagnóstico de “sumiu mensagem” tem quatro suspeitos antes do primeiro café.
O desenho alternativo junta as pontas: caixa de entrada multiagente, automação e CRM na mesma plataforma, sobre conexão oficial da Meta, sem ponte de terceiro, e com o modo coexistência (documentado pela Meta em 2025) mantendo o aplicativo do celular ativo, o que elimina por desenho o ponto cego número um deste artigo: mensagens do app chegam por webhooks de eco documentados. É o formato do Cubo Suite, nosso interesse declarado, e a comparação de fundo está em Z-API ou API oficial com coexistência. Quem prefere seguir no open source encontra o mapa completo do Chatwoot, limites incluídos, no nosso guia do Chatwoot.
Existe conector oficial entre Z-API e Chatwoot?
Não há conector nativo mantido oficialmente pelos dois lados: a integração se faz por ponte (serviço próprio, n8n ou conector de comunidade) entre os webhooks da Z-API e a API de inbox do Chatwoot.
As mensagens que o dono envia pelo celular aparecem no Chatwoot?
Só se a ponte tratar os eventos de mensagem enviada da Z-API e espelhá-los. É o ponto que mais falha nas implementações: valide esse caminho especificamente antes de operar com equipe.
Vale mais Z-API + Chatwoot ou Evolution API + Chatwoot?
A Evolution traz o conector de Chatwoot embutido (menos ponte para manter) e cobra em infraestrutura própria; a Z-API terceiriza a infraestrutura e deixa a ponte com você. O risco da conexão não oficial é equivalente nos dois; a escolha é sobre onde você prefere gastar a manutenção.
Deixe um comentário