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 named WhatsApp instance. This is useful in scenarios such as customer support, marketing campaigns, or automated notifications where multimedia content needs to be delivered through WhatsApp.
Practical example:
A business can use this node to automatically send product images or promotional videos to customers who have opted in, enhancing engagement by delivering rich media content directly to their WhatsApp.
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 to 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. The structure typically includes status information about the message delivery.
If an error occurs, 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 may result in errors or no message delivery.
- Invalid phone number format (missing country code) can cause message sending to fail.
- Media URL must be accessible and properly formatted; otherwise, the media will not be sent.
Error messages:
"The operation \"<operation>\" is not supported!": Indicates an unsupported operation was requested; ensure only supported operations are used.- Network or API errors will return messages from the Evolution API; check API key validity and network connectivity.
- If the node throws errors related to media sending, verify that the media URL is reachable and the media type matches the content.
Resolution tips:
- Double-check all input parameters for correctness.
- Ensure the Evolution API credentials are correctly set up in n8n.
- Test the media URL independently to confirm accessibility.
- Use the "Get QR Code" operation to verify the WhatsApp instance connection status.
Links and References
- Evolution API Documentation (example placeholder, replace with actual if available)
- WhatsApp Business API Overview
- n8n Documentation on Credentials