{"id":16133,"library":"n8n-nodes-evolution-api","title":"n8n Evolution API Community Node","description":"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+.","status":"active","version":"1.0.4","language":"javascript","source_language":"en","source_url":"https://github.com/oriondesign2015/n8n-nodes-evolution-api","tags":["javascript","n8n-community-node-package"],"install":[{"cmd":"npm install n8n-nodes-evolution-api","lang":"bash","label":"npm"},{"cmd":"yarn add n8n-nodes-evolution-api","lang":"bash","label":"yarn"},{"cmd":"pnpm add n8n-nodes-evolution-api","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"This package registers as a custom node within the n8n workflow engine.","package":"n8n-workflow","optional":false}],"imports":[],"quickstart":{"code":"npx n8n@latest install n8n-nodes-evolution-api\n# Or, if you manage custom nodes manually (e.g., self-hosted n8n):\n# cd ~/.n8n\n# npm install n8n-nodes-evolution-api\n# # OR using pnpm if configured for n8n projects:\n# # pnpm add n8n-nodes-evolution-api\n\n# After installation, restart your n8n instance.\n# Then, in the n8n workflow editor, add a new node and search for \"Evolution API\".\n# Configure a new 'Evolution API' credential with your Server URL (without trailing slash) and API Key.\n# Select a 'Resource' (e.g., 'Instância' or 'Mensagem') and an 'Operação' (e.g., 'Criar Instancia' or 'Enviar Texto').\n# Connect the node within your workflow to automate WhatsApp tasks.","lang":"javascript","description":"Instructions to install the n8n-nodes-evolution-api package into an n8n instance."},"warnings":[{"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/`).","message":"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.","severity":"gotcha","affected_versions":">=1.0.1"},{"fix":"Upgrade your n8n instance to version `1.54.4` or later.","message":"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.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Ensure your Evolution API backend is updated to version `2.2.0` or newer.","message":"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.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-21T00:00:00.000Z","next_check":"2026-07-20T00:00:00.000Z","problems":[{"fix":"Edit the Evolution API credential and remove the '/' character from the end of the 'Server Url' field.","cause":"The 'Server Url' in the Evolution API credential in n8n includes a trailing forward slash, which is not supported.","error":"Validation Error: Server URL cannot end with a '/'"},{"fix":"Update to n8n-nodes-evolution-api version 1.0.2 or higher to resolve the Dify integration bug.","cause":"An internal indexing error was occurring when making requests to Dify via the Evolution API node in versions prior to 1.0.2.","error":"N8n workflow error: Dify integration request indexing issue"},{"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.","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).","error":"Node not found / Cannot load community node 'n8n-nodes-evolution-api'"}],"ecosystem":"npm"}