Ir para o conteúdo
Promovaweb

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
  1. O n8n transforma eventos em trabalho no seu sistema
  2. A entrada e a saída percorrem caminhos distintos
  3. O Chatwoot recebe mensagens novas
  4. As opções mudam o que aparece no atendimento
  5. Uma repetição de evento não precisa repetir a resposta
  6. A VPS hospeda os destinos da integração

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.
Destinos de automação e atendimento ligados à sessão, sem exigir que toda mensagem passe pelos dois.

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.

Ver a VPS da StayCloud

Link de parceiro da Promovaweb.