## 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](https://bridge.nexaomni.com.br/assets/hc/n8n/01-community-nodes-v1.png)

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](https://bridge.nexaomni.com.br/assets/hc/n8n/04-buscar-node-v1.png)

> **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](https://bridge.nexaomni.com.br/assets/hc/n8n/02-token-perfil-v1.png)

Credencial salva e testada no n8n:

![Credencial do NexaChat no n8n com a mensagem Connection tested successfully](https://bridge.nexaomni.com.br/assets/hc/n8n/03-credencial-ok-v1.png)

> **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](https://bridge.nexaomni.com.br/assets/hc/n8n/05-fluxo-exemplo-v2.png)

> **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](https://wa.me/552731991998).