Actions37
- Message Actions
- Media Actions
- Contact Actions
- Group Actions
- Instance Actions
- Webhook Actions
Overview
The node integrates with a premium WhatsApp API service to send various types of media messages, including videos, through WhatsApp. Specifically, the Send Video operation under the Media resource allows users to send video files to specified WhatsApp numbers, optionally including captions and additional message options.
This node is beneficial in scenarios such as:
- Marketing campaigns where personalized video messages are sent to customers.
- Customer support workflows that require sending instructional or informational videos.
- Automated notifications involving multimedia content.
For example, a business can automate sending product demo videos to interested clients by providing the client's phone number and the video URL.
Properties
| Name | Meaning |
|---|---|
| Phone Number | The recipient's WhatsApp number including country code (e.g., 5511999999999). |
| Media URL | The URL or base64 string of the video file to be sent. |
| Caption | Optional text caption to accompany the video message. |
| Additional Fields | Optional extra settings: • Reply to Message ID: ID of a message to reply to. • Delay (seconds): Wait time before sending. • Disable Link Preview: Whether to disable link previews. • Mention Users: Comma-separated phone numbers to mention in the message. |
Output
The node outputs a JSON object containing the response from the WhatsApp API after attempting to send the video message. This typically includes status information about the message delivery, message IDs, timestamps, or error details if the request failed.
No binary data output is produced by this operation; all responses are JSON-formatted metadata about the sent message.
Dependencies
- Requires an active connection to the premium WhatsApp API service via an API key credential.
- Needs configuration of API URL, authentication token, and instance ID within the node credentials.
- The node sends requests through a proxy endpoint provided by the integration service.
Troubleshooting
Common Issues:
- Invalid or incorrectly formatted phone numbers may cause message sending failures.
- Incorrect or expired API tokens will result in authorization errors.
- Network issues or incorrect API URLs can lead to request timeouts or connection errors.
- Sending unsupported video formats or invalid media URLs may cause the API to reject the message.
Error Messages:
- Authorization errors typically indicate problems with the API token or credentials; verify and update them.
- "Unknown resource" errors suggest misconfiguration of the resource or operation parameters.
- Validation errors on input fields mean required properties like phone number or media URL are missing or malformed.
To resolve these, ensure all required fields are correctly filled, credentials are valid, and media URLs are accessible and properly formatted.
Links and References
- WhatsApp Business API Documentation
- Uazapi Premium WhatsApp API Service (vendor site for the integrated API)
- n8n Documentation on Creating Custom Nodes