n8n-nodes-evolution

Community Node para integração completa da Evolution API v2.2+ com o n8n.
Permite automação de WhatsApp com suporte a mensagens, grupos, canais, integrações e muito mais.

---

Requisitos

• n8n versão 1.54.4 ou superior
• Evolution API versão 2.2.0 ou superior
• Node.js >= 18.10
• pnpm >= 9.1.4 (para desenvolvimento)

---

Instalação

Via npm (Recomendado)

npm install n8n-nodes-evolution

Manual

1. Clone o repositório
2. Execute pnpm install
3. Execute pnpm build
4. Copie para a pasta de nodes customizados do n8n

---

Recursos Disponíveis (14)

Instância

Gerenciamento completo de instâncias da Evolution API.

Operação	Descrição
Criar Instância	Cria nova instância WhatsApp
Gerar QR-Code	Obtém QR code para conexão
Buscar Instância	Lista instâncias disponíveis
Estado da Conexão	Verifica estado atual
Definir Comportamento	Configura comportamento
Definir Presença	Define status de presença
Definir Proxy	Configura proxy
Buscar Proxy	Obtém configuração de proxy
Desconectar	Desconecta do WhatsApp
Deletar	Remove instância

Mensagem

Envio de diversos tipos de mensagens.

Operação	Descrição
Enviar Texto	Mensagem de texto simples
Enviar Imagem	Envio de imagens
Enviar Vídeo	Envio de vídeos
Enviar Áudio	Envio de áudios
Enviar Documento	Envio de documentos
Enviar Enquete	Criação de enquetes
Enviar Contato	Compartilhamento de contatos
Enviar Lista	Mensagem com lista de opções
Enviar Botão	Mensagem com botões
Enviar Pix	Mensagem de pagamento PIX
Enviar Status	Publicar no status
Reagir	Adicionar reação a mensagem

Grupo

Gerenciamento completo de grupos.

Operação	Descrição
Criar Grupo	Cria novo grupo
Atualizar Imagem	Altera foto do grupo
Atualizar Nome	Altera nome do grupo
Atualizar Descrição	Altera descrição
Atualizar Configurações	Altera configurações
Atualizar Membros	Adiciona/remove membros
Buscar Link de Convite	Obtém link de convite
Revogar Link	Revoga link atual
Enviar Link de Convite	Envia convite
Encontrar Participantes	Lista participantes
Mensagens Temporárias	Configura mensagens temporárias
Sair do Grupo	Remove instância do grupo
Entrar no Grupo	Entra via link de convite

Canais (Newsletter)

Gerenciamento de canais/newsletters do WhatsApp.

Operação	Descrição
Criar Canal	Cria novo canal
Buscar Canais	Lista canais disponíveis
Buscar Mensagens	Lista mensagens do canal
Enviar Texto	Envia texto para canal próprio
Enviar Mídia	Envia imagem/vídeo/áudio/documento
Enviar Enquete	Cria enquete no canal
Enviar Pergunta Q&A	Cria pergunta interativa (⚠️ respostas não disponíveis)
Repostar Mensagem	Reposta de um canal para outro
Info do Convite	Obtém info do código de convite
Seguir	Segue um canal
Deixar de Seguir	Para de seguir
Silenciar	Silencia notificações
Reativar	Reativa notificações

⚠️ Limitação do WhatsApp: Respostas a perguntas Q&A são processadas apenas server-side pelo WhatsApp. Não é possível capturar as respostas dos inscritos via API.

Comunidade

Gerenciamento de comunidades WhatsApp.

Operação	Descrição
Criar Comunidade	Cria nova comunidade
Buscar Comunidades	Lista comunidades
Buscar Participantes	Lista membros
Atualizar Participantes	Gerencia membros
Sair da Comunidade	Remove da comunidade

Chat

Operações de chat e mensagens.

Operação	Descrição
Verificar Número	Valida número WhatsApp
Ler Mensagem	Marca como lida
Gerenciar Arquivo	Arquiva/desarquiva
Marcar como Não Lido	Marca conversa
Deletar Mensagem	Remove mensagem
Buscar Foto de Perfil	Obtém foto
Obter Mídia em Base64	Converte mídia
Editar Mensagem	Edita mensagem enviada
Enviar Presença	Envia status de digitando
Bloquear Contato	Bloqueia/desbloqueia
Buscar Contatos	Lista contatos
Procurar Mensagens	Busca mensagens
Procurar Status	Busca status
Procurar Chats	Lista conversas
Buscar Chat por JID	Busca chat específico

Etiquetas

Gerenciamento de etiquetas (labels).

Operação	Descrição
Criar Etiqueta	Cria nova label
Buscar Etiquetas	Lista labels
Adicionar a Chat	Adiciona label ao chat
Remover de Chat	Remove label do chat

Chamadas

Controle de chamadas de voz.

Operação	Descrição
Simular Chamada	Inicia chamada fake
Buscar Chamadas	Lista chamadas

Negócios

Recursos do WhatsApp Business.

Operação	Descrição
Buscar Catálogo	Lista produtos
Buscar Coleções	Lista coleções

Perfil

Gerenciamento de perfil.

Operação	Descrição
Buscar Perfil	Obtém informações
Atualizar Nome	Altera nome
Atualizar Status	Altera status
Atualizar Foto	Altera foto
Remover Foto	Remove foto
Configurações de Privacidade	Gerencia privacidade

Templates (Meta Business)

Gerenciamento de templates do Meta Business.

Operação	Descrição
Criar Template	Cria novo template
Buscar Templates	Lista templates

Armazenamento S3

Integração com armazenamento S3.

Operação	Descrição
Buscar Mídia	Obtém mídia do S3
Buscar URL da Mídia	Obtém URL assinada

Evento

Configuração de eventos e integrações.

Operação	Descrição
Webhook	Configura webhook
RabbitMQ	Configura RabbitMQ
WebSocket	Configura WebSocket
SQS	Configura Amazon SQS
NATS	Configura NATS
Pusher	Configura Pusher
Kafka	Configura Apache Kafka

Integração

Integrações com plataformas externas.

Operação	Descrição
Chatwoot	Integração Chatwoot
Evolution Bot	Bot nativo
Typebot	Integração Typebot
Dify	Integração Dify AI
Flowise	Integração Flowise
OpenAI	Integração OpenAI
N8N Bot	Bot do n8n
EvoAI	Integração EvoAI

---

Cenários de Uso

Workflow Reativo (Webhook)

Processa mensagens recebidas:

Webhook n8n  Processa dados  Evolution API Node  Responde

Workflow Proativo (Consultas)

Inicia ações programadas:

Schedule/Trigger  Evolution API Node  Busca/Envia dados

---

Desenvolvimento

# Instalar dependências
pnpm install

# Build de produção
pnpm build

# Modo de desenvolvimento (watch)
pnpm dev

# Lint
pnpm lint

# Lint com correção automática
pnpm lintfix

---

Changelog

v1.9.29 (2025-12-06)

• ❌ Removido: Evento NEWSLETTER_QUESTION_REPLY (limitação do WhatsApp - respostas Q&A não são enviadas para terceiros)
• 🧹 Limpeza de código de debug

v1.9.27 (2025-12-02)

• ✨ Newsletter Send Question: Enviar perguntas Q&A para canais próprios
• ✨ Newsletter Send Poll: Enquetes em canais

v1.9.19 (2025-12-01)

• ✨ S3 Media URL: Suporte a mediaS3Url no trigger e repost
• 🔧 Fix: ignoreOwnNewsletters default true (evita loop de duplicação)

v1.9.0 (2025-11-30)

• ✨ Seleção Dinâmica: Canais, grupos e instâncias com dropdown
• ✨ LoadOptions: Busca dinâmica via API
• ✨ Repost Newsletter: Reposta mensagens entre canais

v1.8.0 (2025-11-30)

• ✨ Repost Newsletter Message: Reposta de canais seguidos para canais próprios
• ✨ Modificar Legenda/Mídia: Edita conteúdo ao repostar
• 🔧 Otimização de payload (~40-50% menor)

v1.7.0 (2025-11-27)

• ✨ Trigger Node: Recebe webhooks com endpoint editável
• ✨ Auto-extração: 30+ campos extraídos automaticamente
• ✨ Newsletter Media Base64: Mídia completa no webhook

v1.6.0 (2025-11-28)

• ✨ Newsletter Send: Enviar texto e mídia para canais próprios
• ✨ Newsletter Invite Info: Obter informações de código de convite
• ✨ Newsletter Fetch Messages: Buscar mensagens do canal
• 🔧 Correções de tipos TypeScript para Newsletter API
• 📊 127+ operações cobrindo toda API

v1.5.0 (2025-11-27)

• ✨ Community: 10 operações adicionais (convites, solicitações, configurações)
• 🔧 Melhorias no Trigger Node para webhooks

v1.2.0 (2025-11-25)

• 14 Recursos completos
• ~114 Operações cobrindo toda API
• Novos: Templates API, S3 API
• Novos eventos: WebSocket, SQS, NATS, Pusher, Kafka
• Novas integrações: OpenAI, N8N Bot, EvoAI
• Newsletter renomeado para "Canais" (localização PT-BR)
• Correções de bugs e melhorias de UI

v1.1.0

• Adicionado suporte a Newsletter/Canais
• Melhorias no gerenciamento de grupos
• Novos campos para mensagens

v1.0.0

• Release inicial
• Suporte básico a instâncias e mensagens

---

Contribuição

Contribuições são bem-vindas! Por favor:

• Abra Issues para reportar bugs
• Envie Pull Requests com melhorias
• Sugira novas funcionalidades

---

Licença

MIT License - Veja LICENSE.md para detalhes.

---

Desenvolvido com para a comunidade Evolution API