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

• 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

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

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 |

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}

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"
}

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

MIT