n8n-nodes-new-evolution-api

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-new-evolution-api

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.