n8n Evolution API Community Node

1.0.4 · active · verified Tue Apr 21

The n8n Evolution API Community Node is a free, open-source integration for the n8n automation platform, designed to simplify interaction with the Evolution API (a WhatsApp channel hub). It enables n8n users to automate various WhatsApp functionalities, including sending different message types (text, image, video, document, interactive messages, etc.) and managing Evolution API instances (creation, QR code generation, status updates, disconnection, deletion). The current stable version is 1.0.4. Releases are focused on bug fixes and feature enhancements, maintaining active development. This node primarily differentiates itself by providing a comprehensive, no-cost solution for WhatsApp automation within the n8n ecosystem, specifically tailored for Evolution API v2.2+.

Common errors

```
Validation Error: Server URL cannot end with a '/'
```
cause The 'Server Url' in the Evolution API credential in n8n includes a trailing forward slash, which is not supported.

fix Edit the Evolution API credential and remove the '/' character from the end of the 'Server Url' field.
```
N8n workflow error: Dify integration request indexing issue
```
cause An internal indexing error was occurring when making requests to Dify via the Evolution API node in versions prior to 1.0.2.

fix Update to n8n-nodes-evolution-api version 1.0.2 or higher to resolve the Dify integration bug.
```
Node not found / Cannot load community node 'n8n-nodes-evolution-api'
```
cause The 'n8n-nodes-evolution-api' package was not installed correctly, n8n was not restarted after installation, or the n8n version does not meet the minimum requirement (1.54.4).

fix Verify the package is installed in your n8n custom nodes directory (e.g., `~/.n8n/nodes`), ensure your n8n instance is version 1.54.4 or newer, and restart n8n.

Warnings

gotcha Configuring the Evolution API 'Server Url' with a trailing slash (`/`) in n8n credentials will lead to validation errors and prevent the credential from being saved or used.
Fix: Ensure the 'Server Url' field in Evolution API credentials does not end with a '/' (e.g., use `https://api.example.com` instead of `https://api.example.com/`).
breaking This n8n community node requires n8n version `1.54.4` or newer to function correctly. Older n8n versions may fail to load the node or exhibit unexpected behavior.
Fix: Upgrade your n8n instance to version `1.54.4` or later.
gotcha Full compatibility and all features of this node require your Evolution API instance to be running version `2.2.0` or superior. Using older Evolution API versions might result in missing functionalities or unexpected errors.
Fix: Ensure your Evolution API backend is updated to version `2.2.0` or newer.

Install

npm install n8n-nodes-evolution-api npm
yarn add n8n-nodes-evolution-api yarn
pnpm add n8n-nodes-evolution-api pnpm

Quickstart

Instructions to install the n8n-nodes-evolution-api package into an n8n instance.

npx n8n@latest install n8n-nodes-evolution-api
# Or, if you manage custom nodes manually (e.g., self-hosted n8n):
# cd ~/.n8n
# npm install n8n-nodes-evolution-api
# # OR using pnpm if configured for n8n projects:
# # pnpm add n8n-nodes-evolution-api

# After installation, restart your n8n instance.
# Then, in the n8n workflow editor, add a new node and search for "Evolution API".
# Configure a new 'Evolution API' credential with your Server URL (without trailing slash) and API Key.
# Select a 'Resource' (e.g., 'Instância' or 'Mensagem') and an 'Operação' (e.g., 'Criar Instancia' or 'Enviar Texto').
# Connect the node within your workflow to automate WhatsApp tasks.

view raw JSON →