A UAZAPI no n8n e no Chatwoot
A UAZAPI conecta a sessão do WhatsApp às automações do n8n e ao atendimento no Chatwoot. O n8n recebe eventos e chama a API, enquanto a integração beta do Chatwoot sincroniza mensagens novas.
Ficha e sumário da página
- Referência técnica
- UAZAPI 2.6.9
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
O n8n transforma eventos em trabalho no seu sistema
O Node Webhook do n8n recebe uma requisição HTTP e disponibiliza o conteúdo para o fluxo. Quando a UAZAPI envia um evento de mensagem, você usa esse conteúdo para consultar um cadastro, encaminhar a conversa ou preparar uma resposta. O Node HTTP Request permite chamar os endpoints da API com a credencial correspondente. Esse caminho usa recursos HTTP documentados, sem exigir um Node comunitário específico da UAZAPI.
A finalidade de cada execução pertence ao seu fluxo. A API entrega uma ocorrência da sessão, mas não define qual mensagem deve receber resposta automática nem quando o atendimento humano precisa assumir. Você relaciona o evento à conversa e ao estado do seu app antes de executar uma ação. Isso permite que uma mensagem recebida durante um atendimento não provoque uma segunda resposta incompatível com a primeira.
A entrada e a saída percorrem caminhos distintos
O webhook aponta para o n8n e recebe eventos enviados pela UAZAPI. A chamada de envio sai do n8n e aponta para a Server URL da API. O token seleciona a instância usada nessa chamada. Você preserva essa relação quando um mesmo n8n atende vários números, pois uma resposta precisa sair pela sessão autorizada para a conversa que originou o evento.
WhatsAppO número está ligado à sessão pareada.UAZAPIA sessão entrega eventos aos destinos configurados.n8nO webhook inicia o fluxo que consulta o app e prepara ações.ChatwootA integração nativa sincroniza mensagens novas com a inbox.
O diagrama apresenta responsabilidades e não uma exigência de encaminhamento em série. A integração nativa do Chatwoot pode sincronizar mensagens diretamente. O n8n pode trabalhar com eventos de outra finalidade. Ao usar ambos para responder à mesma conversa, você define qual componente envia cada resposta. Dois caminhos habilitados sem essa definição podem produzir mensagens repetidas, mesmo quando cada requisição individual termina sem erro.
O Chatwoot recebe mensagens novas
O contrato da UAZAPI oferece /chatwoot/config para consultar
e atualizar a integração. A configuração relaciona o endereço
do Chatwoot e seu token de acesso. Os campos account_id e
inbox_id identificam o cadastro no Chatwoot e a caixa de entrada. O retorno informa a URL usada no
webhook da inbox. Esses identificadores ligam a sessão de
WhatsApp ao atendimento correto, em vez de misturar todas
as conversas num destino escolhido apenas pelo nome.
Na versão 2.6.9, a integração está marcada como beta. A documentação descreve sincronização bidirecional de mensagens novas e informa que a importação de histórico não está implementada. Portanto, você não apresenta a ativação da integração como migração completa das conversas antigas. Uma conversa anterior pode continuar relevante para o atendente sem aparecer automaticamente na nova caixa de entrada.
As opções mudam o que aparece no atendimento
A configuração inclui opções para ignorar grupos, assinar mensagens e criar uma nova conversa em vez de reutilizar uma existente. Cada opção altera a leitura do atendimento. Ignorar grupos retira esse tipo de mensagem da sincronização. A opção de criar uma conversa nova muda a organização do histórico. Você avalia essas opções pelo efeito na caixa de entrada, sem tratá-las apenas como campos necessários para ativar o recurso.
O retorno de consulta da configuração pode incluir credenciais. Ele não deve ser publicado num log ou numa captura de suporte. O token do Chatwoot e o token da instância UAZAPI autorizam sistemas diferentes. Você guarda cada um no local adequado e mantém claro qual acesso precisa ser atualizado quando uma credencial muda. Trocar somente uma delas não renova automaticamente o acesso ao outro serviço.
Uma repetição de evento não precisa repetir a resposta
Os webhooks podem chegar duplicados ou fora de ordem.
O fluxo usa os identificadores disponíveis para reconhecer
uma ocorrência já processada. Também distingue uma mensagem
recebida de um envio feito pela própria API. O filtro
wasSentByApi pode excluir esse segundo grupo da entrega,
conforme a finalidade escolhida. A aplicação ainda precisa
conferir se a ação planejada já aconteceu antes de criar
outra resposta para o mesmo conteúdo.
O tratamento de timeout exige a mesma atenção. A ausência
de resposta HTTP não comprova que o envio falhou. Você
consulta o estado conhecido antes de repetir a chamada.
O track_id relaciona a mensagem a uma
execução, mas não elimina duplicações. No atendimento,
esse cuidado evita que o contato receba a mesma confirmação
várias vezes porque uma etapa demorou mais que o esperado.
A VPS hospeda os destinos da integração
O n8n e o Chatwoot podem ocupar a sua VPS, com os endereços públicos necessários para receber eventos. Isso não significa que o serviço proprietário da uazapi também está instalado nessa máquina. A Server URL continua apontando para o ambiente da API. A distinção permite dimensionar e acompanhar os sistemas que você mantém, sem atribuir à sua VPS a disponibilidade do servidor do fornecedor.
Quando você precisa revisar a ligação entre esses sistemas, o Desenvolvimento Colaborativo da Dev Side Studio oferece orientação técnica ao vivo para integrações e APIs. O recebimento dos eventos está em webhooks e eventos. A integração permanece sujeita à sessão do WhatsApp e aos limites descritos em API não oficial.
Continue na comunidade
Leve ao Discord da Promovaweb a sessão que desconecta ou o webhook que não chega ao n8n. Com o evento recebido na conversa, a comunidade compara o seu caso com integrações parecidas.
Uma VPS para suas automações
O webhook da UAZAPI precisa de um endereço público para entregar cada evento. A VPS da StayCloud em São Paulo vem com acesso root e disco NVMe para o n8n e o Chatwoot receberem as mensagens.
Link de parceiro da Promovaweb.