Actions48
- Instance Actions
- Message Actions
- Group Actions
- Contact Actions
- Media Actions
- Webhook Actions
- Profile Actions
Overview
This node integrates with the Evolution API to automate WhatsApp messaging, specifically enabling sending video files under the Media resource. It allows users to send videos directly to a specified phone number via WhatsApp, optionally including captions and additional message options such as delay or mentions.
Common scenarios include:
- Marketing campaigns where personalized video messages are sent to customers.
- Customer support sending tutorial or troubleshooting videos.
- Automated notifications with video content for events or updates.
Example: Sending a product demo video to a client’s WhatsApp number with a caption describing the product features.
Properties
| Name | Meaning |
|---|---|
| Phone Number | The recipient's phone number including country code (without the "+" sign). |
| Media URL | URL or base64 encoded data of the video file to be sent. |
| Caption | Optional text caption accompanying the video message. |
| Additional Fields | Optional extra settings: • Delay: Time in milliseconds to wait before sending the message. • Link Preview: Enable or disable link preview in messages. • Quoted Message ID: ID of a message to quote or reply to. • Mentions: Comma-separated list of phone numbers to mention in the message. |
Output
The node outputs an array of JSON objects corresponding to each input item processed. Each output JSON contains the response from the Evolution API after attempting to send the video message. This typically includes status information about the message delivery.
If an error occurs and "Continue On Fail" is enabled, the output JSON will contain an error field with the error message.
No binary data is output by this node.
Dependencies
- Requires valid credentials for the Evolution API, including:
- Base URL of the API.
- API key for authentication.
- Instance name identifying the WhatsApp instance.
- Optionally uses credentials for an auxiliary API ("N8N Tools API") for subscription validation.
- The node makes HTTP requests to the Evolution API endpoints.
- Proper configuration of these credentials in n8n is necessary for successful operation.
Troubleshooting
- Invalid Subscription or API Key: If the node throws errors related to invalid subscription or API key, verify that the provided API keys and credentials are correct and active.
- Unknown Operation or Resource Errors: These indicate misconfiguration of the node parameters; ensure the Resource is set to "Media" and Operation to "Send Video".
- Network or API Endpoint Issues: Check network connectivity and that the Evolution API base URL is reachable.
- Message Delivery Failures: Could be due to incorrect phone number format or WhatsApp restrictions; confirm the phone number includes the country code without "+" and that the recipient is reachable on WhatsApp.
- Delay Not Working: Ensure the delay value is set correctly in milliseconds if used.
Links and References
- Evolution API Documentation (hypothetical link for reference)
- WhatsApp Business API guidelines for media messages
- n8n documentation on creating custom nodes and using HTTP Request helpers