Como instalar o NexaChat no n8n
Com os nodes do NexaChat no n8n, você automatiza o seu atendimento: cria contatos, envia mensagens, move cards no Kanban, usa a NexaAI, responde comentários do Instagram, recebe respostas de formulários e acompanha seus anúncios — tudo dentro dos seus fluxos.
Antes de começar
-
n8n instalado no seu servidor (self-hosted), versão 1.x ou 2.x.
-
Acesso de dono (owner) da instância do n8n.
-
Um usuário do NexaChat com acesso ao que você vai automatizar.
Importante: o n8n Cloud (a versão hospedada pelo próprio n8n) ainda não permite instalar estes nodes. Use o n8n instalado no seu servidor.
Passo 1 — Instalar os nodes
-
No n8n, abra Settings (Configurações) → Community Nodes.
-
Clique em Install.
-
No campo npm Package Name, digite:
@nexaomni/n8n-nodes-nexachat -
Marque "I understand the risks…" e clique em Install.

Pronto. Ao adicionar um passo no fluxo, busque por NexaChat para ver todos os nodes.

Usa n8n com Docker em modo fila (main + workers)? A instalação vale para todos os processos se eles compartilham a pasta
/home/node/.n8n. Se não compartilham, definaN8N_REINSTALL_MISSING_PACKAGES=truenos workers.
Passo 2 — Conectar a sua conta
-
Em qualquer node do NexaChat, no campo Credential, clique em Create new credential.
-
Preencha:
-
NexaChat API URL:
https://chat.nexaomni.com.br -
Access Token: o token de acesso do seu usuário. Para encontrá-lo, abra o seu Perfil (clique no seu avatar) → Configurações do perfil → seção Token de Acesso → clique em Copiar.
-
-
Salve. O n8n testa a conexão na hora.
Onde copiar o token, no seu perfil do NexaChat:

Credencial salva e testada no n8n:

Restringiu os domínios da credencial? No n8n 2.x a credencial tem a opção Allowed HTTP Request Domains. Se você limitar os domínios, inclua os dois:
chat.nexaomni.com.breengagement.nexaomni.com.br(o segundo é usado pelos nodes de Instagram, Formulários e Anúncios).
Qual usuário usar?
O n8n age como o usuário dono do token: tudo o que o fluxo fizer aparece no NexaChat em nome desse usuário, com as mesmas permissões dele.
Recomendado: crie um usuário só para integrações (por exemplo, "Integração n8n") com perfil de administrador. Assim as mensagens automáticas ficam identificadas e nada para de funcionar se alguém da equipe sair da empresa. Ler respostas de formulários exige token de administrador.
O que cada node faz
| Node | Para que serve |
|---|---|
| NexaChat | Conversas, mensagens, contatos, empresas, etiquetas, caixas de entrada, Kanban, tarefas, agenda, campanhas, respostas prontas, Central de Ajuda, relatórios e NexaAI |
| NexaChat Trigger | Inicia o fluxo quando algo acontece no NexaChat: nova mensagem, conversa criada ou atualizada, contato criado e outros |
| NexaChat Instagram | Comentários (listar, responder, DM ao autor, ocultar, resolver), leads, posts (agendar, listar, métricas), envio de imagem/vídeo e crescimento da conta |
| NexaChat Instagram Trigger | Inicia o fluxo a cada novo comentário ou novo lead do Instagram |
| NexaChat Forms | Lista seus formulários de captura e as respostas recebidas |
| NexaChat Forms Trigger | Inicia o fluxo a cada nova resposta de formulário |
| NexaChat Ads | Resultados das campanhas, gasto × vendas, funil, origem dos leads e envio de conversões para a Meta |
| NexaChat Ads Trigger | Inicia o fluxo quando chega um novo lead vindo de anúncio |
Os nodes de Instagram, Formulários e Anúncios funcionam quando o módulo correspondente está contratado e ativo na sua conta.
Exemplos de automação
-
Lead do formulário → WhatsApp em segundos: NexaChat Forms Trigger → NexaChat (criar contato) → NexaChat (enviar mensagem).
-
IA respondendo comentários do Instagram: NexaChat Instagram Trigger → NexaAI ou outra IA → NexaChat Instagram (responder e enviar DM).
-
Venda no seu sistema → a Meta aprende quem compra: Webhook do seu ERP/checkout → NexaChat Ads (Enviar conversão: Purchase com o valor e o número do pedido).
Exemplo simples — cada novo comentário recebe uma resposta pública (no campo Comment ID use a expressão {{ $json.comment_id }}):

Usando IA para responder comentários? Desligue as regras de palavra-chave do NexaChat na mesma conta do Instagram — senão o comentário recebe duas respostas. No gatilho, deixe ligada a opção Ignore Own Comments para a IA não responder os comentários da sua própria marca.
Segurança
-
O token dá ao n8n o mesmo acesso do usuário. Nunca compartilhe nem cole o token em lugares públicos.
-
Para cortar o acesso, gere um novo token no perfil do NexaChat — o anterior deixa de funcionar.
-
Ações que publicam (responder comentário, DM, agendar post, enviar mensagem) são reais: teste com contatos seus antes de ativar o fluxo.
Atualizações
Quando sair uma versão nova, vá em Settings → Community Nodes, localize @nexaomni/n8n-nodes-nexachat e clique em Update.
Precisa de ajuda com a automação? Fale com a nossa equipe.