n8n-nodes-evolution

Requirements

• n8n version 1.54.4 or higher
• Evolution API version 2.2.0 or higher
• Node.js >= 18.10
• pnpm >= 9.1.4 (for development)

Installation

Via npm (Recommended)

npm install @aorizondo/n8n-nodes-evolution

Manual

1. Clone the repository
2. Run pnpm install
3. Run pnpm build
4. Copy to the n8n custom nodes folder

Available Resources (14)

Instance

Complete management of Evolution API instances.

| Operation | Description | |----------|-----------| | Create Instance | Creates a new WhatsApp instance | | Generate QR-Code | Gets QR code for connection | | Fetch Instance | Lists available instances | | Connection State | Checks current state | | Set Behavior | Configures behavior | | Set Presence | Sets presence status | | Set Proxy | Configures proxy | | Fetch Proxy | Gets proxy configuration | | Disconnect | Disconnects from WhatsApp | | Delete | Removes instance |

Message

Sending various types of messages.

| Operation | Description | |----------|-----------| | Send Text | Simple text message | | Send Image | Send images | | Send Video | Send videos | | Send Audio | Send audios | | Send Document | Send documents | | Send Poll | Poll creation | | Send Contact | Share contacts | | Send List | Message with a list of options | | Send Button | Message with buttons | | Send Pix | PIX payment message (Brazil) | | Send Status | Publish to status | | React | Add reaction to a message |

Group

Complete group management.

| Operation | Description | |----------|-----------| | Create Group | Creates a new group | | Update Image | Changes group photo | | Update Name | Changes group name | | Update Description | Changes description | | Update Settings | Changes settings | | Update Members | Adds/removes members | | Fetch Invite Link | Gets invite link | | Revoke Link | Revokes current link | | Send Invite Link | Sends invite | | Find Participants | Lists participants | | Ephemeral Messages | Configures temporary messages | | Leave Group | Removes instance from group | | Join Group | Joins via invite link |

Channels (Newsletter)

Management of WhatsApp channels/newsletters.

| Operation | Description | |----------|-----------| | Create Channel | Creates new channel | | Fetch Channels | Lists available channels | | Fetch Messages | Lists channel messages | | Send Text | Sends text to own channel | | Send Media | Sends image/video/audio/document | | Send Poll | Creates poll in channel | | Send Q&A Question | Creates interactive question (⚠️ replies not available) | | Repost Message | Reposts from one channel to another | | Invite Info | Gets info from invite code | | Follow | Follows a channel | | Unfollow | Stops following | | Mute | Mutes notifications | | Unmute | Unmutes notifications |

⚠️ WhatsApp Limitation: Q&A question replies are processed only server-side by WhatsApp. It is not possible to capture subscriber replies via API.

Community

WhatsApp communities management.

| Operation | Description | |----------|-----------| | Create Community | Creates new community | | Fetch Communities | Lists communities | | Fetch Participants | Lists members | | Update Participants | Manages members | | Leave Community | Removes from community |

Chat

Chat and message operations.

| Operation | Description | |----------|-----------| | Check Number | Validates WhatsApp number | | Read Message | Marks as read | | Manage Archive | Archives/unarchives | | Mark as Unread | Marks conversation | | Delete Message | Removes message | | Fetch Profile Picture | Gets photo | | Get Media in Base64 | Converts media | | Edit Message | Edits sent message | | Send Presence | Sends typing status | | Block Contact | Blocks/unblocks | | Fetch Contacts | Lists contacts | | Search Messages | Searches messages | | Search Status | Searches status | | Search Chats | Lists conversations | | Fetch Chat by JID | Searches specific chat |

Labels

Label management.

| Operation | Description | |----------|-----------| | Create Label | Creates new label | | Fetch Labels | Lists labels | | Add to Chat | Adds label to chat | | Remove from Chat | Removes label from chat |

Calls

Voice call control.

| Operation | Description | |----------|-----------| | Simulate Call | Starts fake call | | Fetch Calls | Lists calls |

Business

WhatsApp Business resources.

| Operation | Description | |----------|-----------| | Fetch Catalog | Lists products | | Fetch Collections | Lists collections |

Profile

Profile management.

| Operation | Description | |----------|-----------| | Fetch Profile | Gets information | | Update Name | Changes name | | Update Status | Changes status | | Update Photo | Changes photo | | Remove Photo | Removes photo | | Privacy Settings | Manages privacy |

Templates (Meta Business)

Meta Business templates management.

| Operation | Description | |----------|-----------| | Create Template | Creates new template | | Fetch Templates | Lists templates |

S3 Storage

S3 storage integration.

| Operation | Description | |----------|-----------| | Fetch Media | Gets media from S3 | | Fetch Media URL | Gets signed URL |

Event

Events and integrations configuration.

| Operation | Description | |----------|-----------| | Webhook | Configures webhook | | RabbitMQ | Configures RabbitMQ | | WebSocket | Configures WebSocket | | SQS | Configures Amazon SQS | | NATS | Configures NATS | | Pusher | Configures Pusher | | Kafka | Configures Apache Kafka |

Integration

Integrations with external platforms.

| Operation | Description | |----------|-----------| | Chatwoot | Chatwoot integration | | Evolution Bot | Native bot | | Typebot | Typebot integration | | Dify | Dify AI integration | | Flowise | Flowise integration | | OpenAI | OpenAI integration | | N8N Bot | N8n bot | | EvoAI | EvoAI integration |

Use Cases

Reactive Workflow (Webhook)

Processes incoming messages:

n8n Webhook -> Processes data -> Evolution API Node -> Responds

Proactive Workflow (Queries)

Starts scheduled actions:

Schedule/Trigger -> Evolution API Node -> Fetches/Sends data

Development

# Install dependencies
pnpm install

# Production build
pnpm build

# Development mode (watch)
pnpm dev

# Lint
pnpm lint

# Lint with auto-fix
pnpm lintfix

Changelog

v1.9.53 (Fork by @aorizondo)

• ✨ English UI: Translated node interface from Portuguese to English.
• 🐛 Bugfix: Fixed hardcoded evolutionApi credential calls across 18 integration endpoints (OpenAI, EvoAI, S3, Webhooks, etc.) that used to throw does not have any credentials of type "evolutionApi".
• 🐛 Bugfix: Fixed Invalid URL execution errors on integration endpoints by ensuring that EvolutionRequest wrapper is used for all operations, correctly picking up the Server URL from the user's credentials.

v1.9.29 (2025-12-06)

• ❌ Removed: NEWSLETTER_QUESTION_REPLY event (WhatsApp limitation - Q&A replies are not sent to third-parties)
• 🧹 Debug code cleanup

v1.9.27 (2025-12-02)

• ✨ Newsletter Send Question: Send Q&A questions to own channels
• ✨ Newsletter Send Poll: Polls in channels

v1.9.19 (2025-12-01)

• ✨ S3 Media URL: Support for mediaS3Url on trigger and repost
• 🔧 Fix: ignoreOwnNewsletters default true (prevents duplication loop)

v1.9.0 (2025-11-30)

• ✨ Dynamic Selection: Channels, groups, and instances with dropdown
• ✨ LoadOptions: Dynamic fetching via API
• ✨ Repost Newsletter: Repost messages between channels

v1.8.0 (2025-11-30)

• ✨ Repost Newsletter Message: Repost from followed channels to own channels
• ✨ Modify Caption/Media: Edit content when reposting
• 🔧 Payload optimization (~40-50% smaller)

v1.7.0 (2025-11-27)

• ✨ Trigger Node: Recebe webhooks com endpoint editável
• ✨ Auto-extraction: 30+ automatically extracted fields
• ✨ Newsletter Media Base64: Full media on webhook

v1.6.0 (2025-11-28)

• ✨ Newsletter Send: Send text and media to own channels
• ✨ Newsletter Invite Info: Get information from invite code
• ✨ Newsletter Fetch Messages: Fetch channel messages
• 🔧 TypeScript typings fixes for Newsletter API
• 📊 127+ operations covering the entire API

v1.5.0 (2025-11-27)

• ✨ Community: 10 additional operations (invites, requests, settings)
• 🔧 Improvements on Trigger Node for webhooks

v1.2.0 (2025-11-25)

• 14 Resources complete
• ~114 Operations covering the entire API
• New: Templates API, S3 API
• New events: WebSocket, SQS, NATS, Pusher, Kafka
• New integrations: OpenAI, N8N Bot, EvoAI
• Newsletter renamed to "Channels"
• Bug fixes and UI improvements

v1.1.0

• Added support for Newsletter/Channels
• Improvements on group management
• New fields for messages

v1.0.0

• Initial release
• Basic support for instances and messages

Credits

• Original Author: Flávio Kosta (@flaviokosta79) - Created the original n8n-nodes-evolution package.
• Fork Maintainer: @aorizondo - Fixed credentials bugs and translated the UI to English.

Contribution

Contributions are welcome! Please:

• Open Issues to report bugs
• Send Pull Requests with improvements
• Suggest new features

License

MIT License - See LICENSE.md for details.