Como instalar o NexaChat no n8n

R

Ruan Rodrigues

Última atualização em Oct 3, 2026

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

  1. No n8n, abra Settings (Configurações) → Community Nodes.

  2. Clique em Install.

  3. No campo npm Package Name, digite: @nexaomni/n8n-nodes-nexachat

  4. Marque "I understand the risks…" e clique em Install.

Tela Install community nodes do n8n com o pacote @nexaomni/n8n-nodes-nexachat preenchido

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

Busca por NexaChat ao adicionar um passo no fluxo do n8n

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, defina N8N_REINSTALL_MISSING_PACKAGES=true nos workers.

Passo 2 — Conectar a sua conta

  1. Em qualquer node do NexaChat, no campo Credential, clique em Create new credential.

  2. 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.

  3. Salve. O n8n testa a conexão na hora.

Onde copiar o token, no seu perfil do NexaChat:

Seção Token de acesso nas Configurações do perfil do NexaChat, com o botão Copiar

Credencial salva e testada no n8n:

Credencial do NexaChat no n8n com a mensagem Connection tested successfully

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.br e engagement.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 }}):

Fluxo no n8n: NexaChat Instagram Trigger ligado ao node Reply publicly to a comment

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.