n8n-nodes-evolution

!Evolution API

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

$3

bash
npm install n8n-nodes-evolution


$3

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)
$3

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 |
$3

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 |
$3

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 |
$3

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.
$3

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 |
$3

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 |
$3

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 |
$3

Controle de chamadas de voz.
| Operação | Descrição |
|----------|-----------|
| Simular Chamada | Inicia chamada fake |
| Buscar Chamadas | Lista chamadas |
$3

Recursos do WhatsApp Business.
| Operação | Descrição |
|----------|-----------|
| Buscar Catálogo | Lista produtos |
| Buscar Coleções | Lista coleções |
$3

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 |
$3

Gerenciamento de templates do Meta Business.
| Operação | Descrição |
|----------|-----------|
| Criar Template | Cria novo template |
| Buscar Templates | Lista templates |
$3

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 |
$3

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 |
$3

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
$3

Processa mensagens recebidas:


Webhook n8n  Processa dados  Evolution API Node  Responde


$3

Inicia ações programadas:


Schedule/Trigger  Evolution API Node  Busca/Envia dados


---
 Desenvolvimento

`bash

`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
$3

- ❌ 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
$3

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

- ✨ S3 Media URL: Suporte a

mediaS3Url

 no trigger e repost
- 🔧 Fix:

ignoreOwnNewsletters` default true (evita loop de duplicação)

$3

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

$3

- ✨ 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)

$3

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

$3

- ✨ 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

$3

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

$3

- 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

$3

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

$3

- 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