n8n-nodes-evolution-tools/dist/README.md

n8n node para integrar com Evolution API WhatsApp como ferramenta para agentes com IA

# n8n-evolution-tools

This package contains nodes for n8n that allow integration with [Evolution API](https://github.com/evolution-api/evolution-api) for WhatsApp, including a tool for use in AI agents with LLMs.

[![NPM](https://img.shields.io/npm/v/n8n-evolution-tools.svg)](https://www.npmjs.com/package/n8n-evolution-tools)
[![GitHub](https://img.shields.io/github/stars/C0d3Sn4p/n8n-evolution-api-tools.svg)](https://github.com/C0d3Sn4p/n8n-evolution-api-tools)

## 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](https://oriondesign.art.br). The base code for this tool comes from their [Evolution API Node for n8n](https://github.com/oriondesign2015/n8n-nodes-evolution-api), which has been adapted and extended to work as an LLM tool.

## Prerequisites

- [n8n](https://n8n.io/) (version 0.214.0 or higher)
- [Evolution API](https://github.com/evolution-api/evolution-api) installed and configured

## Installation

### In locally hosted n8n

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

### In Docker

Add to your Dockerfile:
```dockerfile
RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-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

```bash
# Install dependencies
npm install

# Build code
npm run build

# Development with auto-compilation
npm run dev
```

## License

[MIT](LICENSE)

LLM Tool adaptation by Nilson Arcuri.