n8n-nodes-evolution-tools

This package contains nodes for n8n that allow integration with Evolution API for WhatsApp, including a tool for use in AI agents with LLMs.

Important Notice

This project is currently in migration and testing phase.

I, Nilson Arcuri, am currently migrating the original Evolution API node (created by Orion Design) to an LLM Tool that can be used with AI agents in n8n. As this tool is still under active development and testing, using it in production environments is at your own risk. Features may change, and updates might introduce breaking changes without prior notice.

Credits

This project is based on the original work by Orion Design. The base code for this tool comes from their Evolution API Node for n8n, which has been adapted and extended to work as an LLM tool.

Prerequisites

• n8n (version 0.214.0 or higher)
• Evolution API installed and configured

Installation

In locally hosted n8n

1. Go to your n8n installation folder
2. Install the package:

npm install n8n-nodes-evolution-tools

3. Restart n8n

In Docker

Add to your Dockerfile:

RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-nodes-evolution-tools

Available Features

Evolution API Tool

This node allows integration with Evolution API to send messages and media via WhatsApp.

Available operations:

• Send text messages
• Send media (image, document, video, audio)
• Get QR Code for connection

Evolution API AI Tool

This node allows n8n AI agents to use Evolution API as a tool, enabling them to send WhatsApp messages when requested.

Credentials

To connect to Evolution API, you'll need to configure the credentials:

1. API URL - URL where your Evolution API is hosted (e.g., http://localhost:8080)
2. API Key - API key configured in your Evolution API installation

Usage Examples

Sending a text message via WhatsApp

1. Add the "Evolution API Tool" node
2. Select "Send Message" operation
3. Configure the instance, phone number, and message
4. Connect to your workflow and execute

Using as an AI Tool

1. Configure an AI agent in n8n
2. Add "Evolution API AI Tool" as an available tool
3. The agent will be able to send WhatsApp messages when requested

Development

# Install dependencies
npm install

# Build code
npm run build

# Development with auto-compilation
npm run dev

License

MIT

LLM Tool adaptation by Nilson Arcuri.