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

$3

1. Go to your n8n installation folder
2. Install the package:
``
npm install n8n-nodes-evolution-tools
`
3. Restart n8n

$3

Add to your Dockerfile:
`dockerfile
RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-nodes-evolution-tools
`

Available Features

$3

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

$3

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

$3

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

$3

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

`bash


Install dependencies

npm install

Build code

npm run build

Development with auto-compilation

npm run dev
``

License

MIT

LLM Tool adaptation by Nilson Arcuri.