Registry / communication / n8n-nodes-evolution-api

n8n-nodes-evolution-api

library1.0.4jsnpmunverified

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+.

communication web-framework devops

npm install n8n-nodes-evolution-api

github ↗package ↗

INSTALL

IMPORT

SIG · N8N-NODES-EVOLUTIO

n8n-nodes-evolution-api

communicationjavascriptv1.0.4

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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.

Debug

Known issues

gotchaConfiguring 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/`).

affects: >=1.0.1

breakingThis 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.

affects: >=1.0.0

gotchaFull 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.

affects: >=1.0.0

Errors

Common errors & fixes

Validation Error: Server URL cannot end with a '/'

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

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'

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.

Upgrade

Version history

1.0.4latest on npm

Audit

Dependencies

n8n-workflowrequiredThis package registers as a custom node within the n8n workflow engine.

Agent activity

20 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/oriondesign2015/n8n-nodes-evolution-api ↗

packagehttps://www.npmjs.com/package/n8n-nodes-evolution-api ↗