Pular para o conteúdo
NooviAIDocs
NooviChatNooviFlow

Como instalar o node da NooviChat no n8n

O node oficial da NooviChat para o n8n permite criar automações completas — enviar mensagens, criar contatos, disparar campanhas e reagir a eventos via webhook — tudo dentro dos seus fluxos do n8n.

Sobre o node

O pacote n8n-nodes-noovichat é um Community Node que adiciona ao n8n suporte nativo à API da NooviChat. Com ele você pode:

  • Enviar e receber mensagens em conversas
  • Criar e atualizar contatos
  • Gerenciar caixas de entrada (inboxes)
  • Disparar campanhas de mensagens
  • Escutar eventos da NooviChat via Webhook Trigger
  • Executar qualquer endpoint da API REST da NooviChat
Pacote npmn8n-nodes-noovichat
Compatibilidaden8n 1.0+
AutenticaçãoAPI Access Token (gerado na NooviChat)

Pré-requisitos

  • Uma instância do n8n funcionando (self-hosted ou n8n Cloud)
  • Acesso de administrador ao n8n para instalar Community Nodes
  • Uma conta ativa na NooviChat
  • O API Access Token da sua conta NooviChat (Configurações → API Access Token)

Método 1 — Community Nodes (recomendado)

O método mais simples — feito diretamente pela interface do n8n, sem precisar acessar o servidor.

1

Abrir as configurações do n8n

No menu lateral do n8n, clique em Settings (ícone de engrenagem) e depois em Community Nodes.

2

Instalar o node

Clique em Install a community node, insira o nome do pacote e confirme:

text
n8n-nodes-noovichat
3

Aceitar o aviso de segurança

O n8n exibirá um aviso sobre Community Nodes. Leia e clique em Install para confirmar.

4

Reiniciar o n8n (se necessário)

Em algumas versões o n8n reinicia automaticamente. Se o node não aparecer na busca, reinicie manualmente:

bash
# Se estiver usando Docker\ndocker restart seu-container-n8n

n8n Cloud

No n8n Cloud, Community Nodes precisam ser habilitados pelo administrador do workspace em Settings → Community Nodes → Enable.

Método 2 — Linha de comando

Ideal para servidores auto-hospedados onde você tem acesso ao terminal.

1

Acessar o container do n8n

bash
# Substitua "n8n" pelo nome do seu container
docker exec -it n8n sh
2

Instalar o pacote via npm

bash
npm install n8n-nodes-noovichat
3

Sair e reiniciar o container

bash
exit
docker restart n8n

Método 3 — Docker Compose

Melhor opção para manter a instalação persistente e reproduzível — o node é instalado toda vez que o container sobe.

No seu docker-compose.yml, adicione a variável de ambiente N8N_COMMUNITY_PACKAGES_ENABLED e liste o pacote em N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE:

yaml
services:
  n8n:
    image: n8nio/n8n:latest
    environment:
      # Habilitar Community Nodes
      - N8N_COMMUNITY_PACKAGES_ENABLED=true
      # Instalar automaticamente ao iniciar
      - N8N_COMMUNITY_PACKAGES_INSTALL_MISSING_PACKAGES=true
      - N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=n8n-nodes-noovichat
    volumes:
      - n8n_data:/home/node/.n8n
    ports:
      - "5678:5678"
    restart: unless-stopped

volumes:
  n8n_data:

Variável N8N_CUSTOM_EXTENSIONS (versões antigas)

Em versões do n8n anteriores à 1.0, o método era apontar para um diretório com o pacote instalado via N8N_CUSTOM_EXTENSIONS. Se você usa uma versão antiga, consulte a documentação do n8n para o processo correto.

Verificação

Após a instalação, confirme que o node está disponível:

  1. 1Abra o editor de um workflow no n8n
  2. 2Clique em + para adicionar um novo node
  3. 3Na barra de busca, digite "NooviChat"
  4. 4O node deve aparecer na lista com o logo da NooviAI

Primeiro uso — configurar credencial

Na primeira vez que usar o node, você precisará configurar a credencial com o token da NooviChat:

1

Adicionar o node NooviChat ao workflow

Busque por "NooviChat" no painel de nodes e arraste para o canvas.

2

Criar nova credencial

No painel do node, clique em Credential → Create New. Informe:

3

Preencher os dados de acesso

CampoOnde encontrar
Base URLURL da sua instância NooviChat, ex: https://chat.seudominio.com
API Access TokenNooviChat → Configurações → Integrações → API Access Token
4

Testar e salvar

Clique em Test connection. Se aparecer "Connection successful", clique em Save.

Problemas comuns

Node não aparece na busca após instalar

Reinicie o container/processo do n8n. Em alguns casos, um Hard Refresh (Ctrl+Shift+R) no browser resolve.

"Community Nodes are disabled"

Adicione a variável de ambiente N8N_COMMUNITY_PACKAGES_ENABLED=true e reinicie o n8n.

Erro "401 Unauthorized" ao testar a credencial

Verifique se o API Access Token está correto e se a Base URL aponta para a instância certa (sem barra no final).

Node instalado mas não atualiza para nova versão

Acesse Settings → Community Nodes, localize o n8n-nodes-noovichat e clique em "Update".