Overview
This node integrates with the Evolution API to interact with WhatsApp instances. It supports sending text messages, sending various types of media (images, documents, videos, audio), and retrieving a QR code for connecting a WhatsApp instance.
The "Send Media" operation allows users to send media files to a specified phone number via a WhatsApp instance. This is useful in scenarios such as customer support, marketing campaigns, or automated notifications where multimedia content needs to be delivered directly through WhatsApp.
Practical example:
A business can use this node to automatically send product images or brochures to customers who request information via WhatsApp, enhancing engagement with rich media content.
Properties
| Name | Meaning |
|---|---|
| Instance | The name identifier of the WhatsApp instance to use for sending the media. |
| Phone Number | The recipient's phone number including country code. |
| Media Type | The type of media to send. Options: Image, Document, Video, Audio. |
| Media URL | The URL pointing to the media file that will be sent. |
| Caption | Optional text caption to accompany the media message. |
Output
The node outputs JSON data representing the response from the Evolution API after attempting to send the media. This typically includes status information about the message delivery.
If an error occurs during execution, the output JSON will contain an error field with the error message.
No binary data output is produced by this node.
Dependencies
- Requires an active Evolution API WhatsApp integration 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 within n8n is necessary before using the node.
Troubleshooting
Common issues:
- Invalid or missing API key or base URL in credentials will cause authentication failures.
- Incorrect WhatsApp instance name or phone number format may result in errors or failed message delivery.
- Providing an invalid media URL or unsupported media type can cause the API to reject the request.
Error messages:
"The operation \"<operation>\" is not supported!": Indicates an unsupported operation was requested; ensure the operation parameter is correctly set.- Network or API errors will return messages from the Evolution API; check connectivity and API limits.
Resolution tips:
- Verify credentials and instance names are correct.
- Ensure phone numbers include the country code without extra characters.
- Confirm media URLs are accessible and point to valid media files.
- Use the optional "continue on fail" setting to handle errors gracefully in workflows.
Links and References
- Evolution API Documentation (Replace with actual URL if available)
- WhatsApp Business API Overview
- n8n Documentation on Credentials