n8n-nodes-n8ntools-evolution-api

N8N Tools - Evolution API

Complete WhatsApp automation with Evolution API - Multi-platform messaging with Docker support.

Features

• Message Management: Text, media, location, contact, interactive lists and buttons
• Group Operations: Create, manage, add/remove participants, admin controls
• Contact Management: Get contacts, check numbers, profile pictures, block/unblock
• Media Handling: Send images, videos, audio, documents, stickers with captions
• Instance Control: Create, connect, disconnect, QR codes, connection states
• Webhook Integration: Real-time event notifications and webhook management
• Profile Management: Update name, status, picture, privacy settings

Installation

npm install n8n-nodes-n8ntools-evolution-api

Credentials

Configure Evolution API credentials in N8N:

• Base URL: Your Evolution API server URL (e.g., https://your-evolution-api.com)
• API Key: API Key from your Evolution API server
• Instance Name: WhatsApp instance name (e.g., my-instance)

Operations

Message Operations

• Send Text: Send text messages with mentions and quotes
• Send Media: Images, videos, audio, documents with captions
• Send Location: GPS coordinates with optional location name
• Send Contact: vCard contact sharing
• Send Interactive: Lists and buttons for user interaction
• Mark as Read: Mark messages as read/seen
• Delete Message: Delete sent messages
• Get Messages: Retrieve chat message history

Group Operations

• Create Group: Create new WhatsApp groups
• Get Group Info: Retrieve group details and metadata
• Update Group: Change group settings and information
• Add/Remove Participants: Manage group membership
• Promote/Demote Admin: Admin role management
• Leave Group: Exit from groups
• Get Participants: List all group members

Contact Operations

• Get Contacts: List all WhatsApp contacts
• Get Contact: Specific contact information
• Check Number: Verify if number exists on WhatsApp
• Get Profile Picture: Retrieve contact profile photos
• Get Status: Contact about/status messages
• Block/Unblock: Contact blocking management

Instance Operations

• Create Instance: Initialize new WhatsApp instance
• Get Instance: Retrieve instance information
• Connect/Disconnect: Manage WhatsApp connection
• Get QR Code: QR code for device linking
• Restart Instance: Restart WhatsApp session
• Get Connection State: Check connection status

Webhook Operations

• Set Webhook: Configure event notification URL
• Get Webhook: Retrieve webhook configuration

Profile Operations

• Get Profile: Current profile information
• Update Profile Name: Change profile display name
• Update Profile Status: Change about/status text
• Update Profile Picture: Change profile photo
• Privacy Settings: Manage privacy configurations

Usage Examples

Send Text Message

{
  "resource": "message",
  "operation": "sendText",
  "phoneNumber": "5511999999999",
  "message": "Hello from Evolution API!"
}

Create Group

{
  "resource": "group",
  "operation": "createGroup",
  "groupName": "My New Group",
  "participants": "5511999999999,5511888888888"
}

Send Image with Caption

{
  "resource": "media",
  "operation": "sendImage",
  "phoneNumber": "5511999999999",
  "mediaUrl": "https://example.com/image.jpg",
  "caption": "Check out this image!"
}

Authentication

Evolution API uses API key authentication. The node automatically handles authentication using the configured credentials.

Rate Limiting

Evolution API has built-in rate limiting. The node handles errors gracefully and provides detailed error messages for troubleshooting.

Support

• Documentation: Evolution API Docs
• Issues: GitHub Issues