n8n-nodes-evogo

Node customizado do n8n para a API Evolution GO (WhatsApp), no estilo do n8n-nodes-evolution-api — com dropdown dinâmico de instâncias e resolução automática de token.

Instalação

Pela UI do n8n (recomendado): Settings → Community Nodes → Install → @romariormr/n8n-nodes-evogo

Manual (self-hosted): copiar os arquivos de dist/ para a pasta apontada por N8N_CUSTOM_EXTENSIONS e reiniciar o n8n.

Recursos

| Resource | Operações | |---|---| | Mensagem | Texto, Mídia (imagem/vídeo/áudio/documento por URL), Botões (reply/url/call/copy/pix), Lista, Carrossel, Enquete, Localização, Contato, Sticker, Reagir, Marcar como lida, Editar, Apagar, Presença (digitando/gravando) | | Grupo | Listar, Meus grupos, Info, Criar, Link de convite, Entrar via link, Sair, Participantes (add/remove/promote/demote), Nome, Descrição, Foto, Atualizar Configurações (announce/locked/aprovação/quem adiciona) | | Canal | Listar canais inscritos, Info, Buscar por convite, Inscrever-se, Mensagens do canal, Criar canal | | Chat | Fixar, Desfixar, Arquivar, Desarquivar, Silenciar, Dessilenciar, Buscar histórico de mensagens (solicita reenvio ao WhatsApp — async), Procurar Mensagens (busca por número, paginado — só mensagens recebidas desde a 0.2.6) | | Perfil | Buscar perfil, Buscar perfil profissional (Business), Atualizar nome, Atualizar status, Atualizar/Remover foto, Buscar/Atualizar configurações de privacidade | | Integração | Chatwoot: buscar/definir/remover configuração, resetar status da conversa (precisa selecionar uma instância real, não a chave da credencial) | | Instância | Listar todas (API key global), Configurar webhook/eventos |

💬 Enviar mensagem para um canal: use o resource Mensagem normalmente, colocando o JID do canal (termina em @newsletter) no campo Número. Use Canal → Listar Canais pra descobrir o JID de cada canal que você segue.

Credencial Evolution GO API

| Campo | Descrição | |---|---| | Base URL | URL da API, ex.: https://evolutiongo.exemplo.com ou http://10.0.0.5:4000 | | API Key | API Key Global (recomendado — habilita o dropdown de instâncias) ou token de uma instância específica | | Ignorar Erros TLS | Para certificados self-signed / wildcard não-correspondente |

Modelo de instâncias

• Credencial com API key global → campo Instância lista todas as instâncias com status (teste 🟢 open / x 🔴 close); o node resolve o token da instância automaticamente na execução.
• Credencial com token de instância → deixe o campo Instância em "— Usar Chave Da Credencial —".

Receber eventos (webhook)

Configure o webhook da instância apontando para um Webhook trigger do n8n (operação Instância → Configurar Webhook/Eventos, eventos MESSAGE + BUTTON_CLICK).

Payload do clique em botão:

{
  "event": "ButtonClick",
  "data": { "buttonId": "opcao_a", "buttonText": "Opção A", "phone": "55...", ... }
}

⚠️ Bug conhecido do Evolution GO: cliques do tipo template_button_reply chegam sem phone/jid — use fallback no fluxo (ex.: capturar o remetente pelo evento Message).

Exemplo: menu interativo com submenu e "voltar"

Webhook ─► É clique? ─┬─ sim ─► roteia por buttonId ─► submenus / voltar / confirmação
                      └─ não ─► msg de texto recebida? ─► envia Menu Principal

Anti-loop: filtre fromMe != true e exija message.conversation não-vazio antes de responder menu.

Build a partir do fonte

npm install
npm run build   # tsc + copia o ícone → dist/

☕ Apoie O Projeto

Se esse node te ajudou, considere apoiar:

Licença

MIT