Community nodes for integrating Evolution API v2.2+ with n8n workflows. Includes action nodes and an event-driven Trigger node for automatic workflow execution on incoming messages. Originally developed by OrionDesign, extended with trigger support.

⚙️ Requirements

• n8n v1.54.4 or higher
• Evolution API v2.2.0 or higher

🚀 Features

🔔 Evolution API Trigger (New)

Event-driven trigger node that starts workflows automatically when messages arrive via Evolution API.

• New Message — triggers on messages.upsert
• 20+ events — subscribe to any Evolution API event (messages, groups, contacts, presence, etc.)
• Automatic webhook registration — registers on activation, removes on deactivation
• Payload normalization — raw webhook data is normalized into {sender, message, messageType, timestamp}
• Multiple event support — subscribe to multiple events simultaneously

📌 Available Resources

Instance

🖥️ Full management of Evolution API instances: create, connect, configure, monitor presence, restart, and delete instances.

Operations

✅ Create Instance

✅ Generate QR Code

✅ Fetch Instance

✅ Set Behavior

✅ Set Presence

✅ Set Proxy

✅ Find Proxy

✅ Disconnect WhatsApp

✅ Delete Instance

Message

✉️ Send and manage messages: text, images, videos, audio, documents, contacts, interactive lists, buttons, PIX, and status messages.

Operations

✅ Send Text

✅ Send Image

✅ Send Video

✅ Send Audio

✅ Send Document

✅ Send Poll

✅ Send Contact

✅ Send List

✅ Send Button

✅ Send PIX

✅ Send Status

✅ React to Message

Group

👥 Full group management: create, update settings, manage participants, invite links, and ephemeral messages.

Operations

✅ Create Group

✅ Update Group Picture

✅ Update Group Name

✅ Update Group Description

✅ Update Group Settings

✅ Update Members

✅ Fetch Invite Link

✅ Revoke Invite Link

✅ Send Invite Link

✅ Find Participants

✅ Ephemeral Messages

✅ Leave Group

✅ Join Group

Chat

💬 Comprehensive chat management: verify numbers, manage messages, handle media, control read status, contacts, and presence.

Operations

✅ Check Number

✅ Read Messages

✅ Manage Archive

✅ Mark as Unread

✅ Delete Message

✅ Fetch Profile Picture

✅ Get Media as Base64

✅ Edit Message

✅ Send Presence

✅ Block Contact

✅ Find Contacts

✅ Search Messages

✅ Search Status

✅ Search Chats

Event

⚡ Real-time event monitoring via Webhooks and RabbitMQ integration.

Operations

✅ Webhook

✅ RabbitMQ

Integration

🔗 Connect Evolution API with external platforms: Chatwoot, Evolution Bot, Typebot, Flowise, and Dify.

Operations

✅ Chatwoot

✅ Evolution Bot

✅ Typebot

✅ Dify

✅ Flowise

🔧 Installation

1. In n8n, go to Settings → Community Nodes
2. Click Install
3. Enter n8n-nodes-evolution-api-plus
4. Click Install

Or install via npm:

npm install n8n-nodes-evolution-api-plus

🔑 Credentials

To use the nodes, configure the following credentials in n8n:

Field	Description
Server Url	Full URL of your Evolution API instance (e.g. https://api.example.com)
ApiKey	Your instance or global API key
Instance Name	The name of your Evolution API instance

🔄 Trigger Node Lifecycle

The Evolution API Trigger node follows n8n's webhook lifecycle:

1. Activation — Automatically registers a webhook with Evolution API via POST /webhook/set/{instance} using n8n's generated webhook URL
2. Event Reception — Incoming messages trigger the workflow; payload is normalized before execution
3. Deactivation — Automatically removes the webhook via DELETE /webhook/{instance}

📦 Normalized Payload

Raw Evolution API webhook data is normalized into a clean output:

{
  "event": "messages.upsert",
  "sender": "5511999999999",
  "senderName": "John Doe",
  "message": "Hello, how are you?",
  "messageType": "text",
  "timestamp": "2025-05-20T12:00:00.000Z",
  "instance": "MyInstance"
}

🤝 Contributing

Contributions are welcome! You can help by:

• Pull Requests — Submit improvements, fixes, or new features
• Issues — Report bugs or suggest ideas
• Documentation — Help improve or expand the docs

📌 Contributors

📄 License

MIT