Description

!image

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