evolution-api

n8n Community Node for the Evolution API (WhatsApp automation)

Package Information

Downloads: 29 weekly / 61 monthly
Latest Version: 1.0.4
Author: Jörg Sebening

Available Nodes

Evolution API icon
Evolution API
Interact with Evolution API (v2.3)

Documentation

@rjsebening/n8n-nodes-evolution-api

Evolution API Node
Version
License

A professional n8n community node for seamless integration with the Evolution API.
Automate WhatsApp-related operations like sending messages, managing instances, and interacting with chats and groups — fully API-driven and production-ready.

What is n8n?

n8n is an easy-to-use workflow automation tool that connects different apps and services, like the Evolution API.
By creating workflows between systems, you can automate repetitive tasks and backend processes — saving time, reducing errors, and scaling operations reliably.

⚖️ Legal Notice

This Community Node uses the public Evolution API and is not affiliated with, endorsed, or sponsored by the Evolution API project or its maintainers.
All trademarks are the property of their respective owners.

Note: This is a community-developed node. For official support regarding the Evolution API, please refer to the official documentation or maintainers.

🚀 Overview

This n8n custom node provides a clean and structured integration with the Evolution API, enabling you to control WhatsApp instances and perform messaging-related actions programmatically.

The focus of this node is stable, outbound API interaction — ideal for automation workflows, backend systems, and operational processes.

✨ Key Features

💬 Messaging & Communication

  • Send Message: Send text messages via WhatsApp
  • Send Media: Send images, documents, audio, or video
  • Send Polls & Interactive Messages
  • Send Messages to Groups
  • Reply to Existing Chats

👥 Group & Chat Management

  • Create Groups
  • Add / Remove Participants
  • Update Group Info
  • Fetch Chats
  • Fetch Group Metadata

🧩 Instance Management

  • List Instances
  • Get Instance Status
  • Restart / Logout Instances
  • QR Code Handling
  • Connection Status Checks

🔐 Secure API Integration

  • API Key Authentication
  • Connection Test
  • Consistent Error Handling
  • Fully JSON-based Requests

📦 Installation

Requirements

  • n8n version 1.0.0 or higher
  • ✅ testet with n8n 2.0
  • Running Evolution API instance
  • Valid Evolution API key

🔧 Configuration

Installation in n8n

This node can be installed using the Community Nodes feature in n8n.

  1. Open your n8n instance
  2. Go to Settings → Community Nodes → Install
  3. Enter the following package names:
@rjsebening/n8n-nodes-evolution-api

Both packages contain the same code.
The scoped version exists to avoid name collisions with potential future official integrations.

  1. Restart n8n → the node will be available

🔑 Set Up API Credentials

  1. In n8n, go to Credentials → Create New

  2. Search for “Evolution API”

  3. Enter your credentials:

    • Server URL: Base URL of your Evolution API instance
      (e.g. https://your-evolution-api.domain)
    • API Key: Your Evolution API key

Obtain Your API Key

  1. Open your Evolution API dashboard
  2. Navigate to Settings / API
  3. Generate or copy your API key
  4. Use it inside n8n credentials

⚙️ Available Actions

Messaging

Action Description
Send Text Message Send plain WhatsApp messages
Send Media Message Send images, documents, audio, or video
Send Poll Send interactive poll messages
Send to Group Send messages to WhatsApp groups

Groups & Chats

Action Description
Create Group Create a new WhatsApp group
Update Group Change group name or settings
Add Participants Add users to a group
Remove Participants Remove users from a group
Fetch Chats Load chats from an instance
Fetch Groups Retrieve group metadata

Instance Operations

Action Description
List Instances Retrieve all available instances
Get Instance Status Check connection state
Restart Instance Restart a WhatsApp instance
Logout Instance Logout an instance
Get QR Code Retrieve QR code for authentication

Utility

Action Description
Test Authentication Verify API key and connection
Health Check Validate server availability

📖 Example Use Cases

  • Send WhatsApp notifications when a deal is closed
  • Automatically inform teams via WhatsApp
  • Build WhatsApp-based onboarding flows
  • Control WhatsApp instances from backend automations
  • Integrate WhatsApp messaging into ERP, CRM, or internal tools

🌍 Why this matters

WhatsApp is often mission-critical — but manual handling doesn’t scale.

This node allows you to:

  • centralize control
  • automate communication
  • reduce human error
  • build reliable, backend-driven WhatsApp workflows

All without custom code.

📬 About the Author

I’m Rezk Jörg Sebening – Business Automation Expert (DACH).
I build automation systems, scalable workflows, and n8n community nodes for agencies and growing companies.

👉 Follow me on GitHub to stay updated with new integrations and automation tooling.

📋 Disclaimer

This is an unofficial community node and is not affiliated with the Evolution API project.

Important Notes:

  • This node is maintained by the community
  • API behavior depends on the Evolution API version
  • For Evolution API issues, consult the official documentation
  • All trademarks and logos belong to their respective owners

Discussion