Overview
This node integrates with the Evolution API for WhatsApp to enable sending messages and media through a specified WhatsApp instance. It supports sending plain text messages, various types of media files (images, documents, videos, audio), and retrieving QR codes for instance authentication.
Common scenarios include automating customer support by sending multimedia content, broadcasting updates with images or documents, or integrating WhatsApp messaging into workflows that require rich media communication.
For example, you can use this node to send an image with a caption to a customer’s phone number or deliver a PDF document as part of an automated notification system.
Properties
| Name | Meaning |
|---|---|
| Instance | The name identifier of the WhatsApp instance to use for sending messages. |
| Phone Number | Recipient's phone number including country code (e.g., 5511999999999). |
| Media Type | Type of media to send. Options: Image, Document, Video, Audio. |
| Media URL | URL pointing to the media file to be sent. |
| Caption | Optional text caption accompanying the media message. |
Output
The node outputs JSON data representing the response from the Evolution API after sending the message or media. This typically includes status information about the sent message.
If an error occurs during execution, the output will contain an error field with the error message.
No binary data is output by this node.
Dependencies
- Requires an active Evolution API WhatsApp instance with valid credentials including:
- Base URL of the Evolution API.
- An API key for authentication.
- The node uses HTTP requests to communicate with the Evolution API endpoints.
- Proper configuration of the API credentials in n8n is necessary before using this node.
Troubleshooting
- Common issues:
- Invalid or missing API credentials will cause authentication failures.
- Incorrect instance name or phone number format may result in errors from the API.
- Providing an invalid media URL or unsupported media type can cause the media sending operation to fail.
- Error messages:
"The operation \"<operation>\" is not supported!"indicates an unsupported operation was requested; ensure only supported operations (sendMessage,sendMedia,getQrCode) are used.- Network or API errors will return messages from the Evolution API; verify connectivity and API limits.
- To resolve errors, verify all input parameters, ensure the API key and instance are correctly configured, and confirm media URLs are accessible.
Links and References
- Evolution API official documentation (refer to your provider’s docs for detailed API usage)
- WhatsApp Business API guidelines for media message formats and limitations