Actions50
- Account Actions
- Call Actions
- Chat Actions
- Contact Actions
- Group Actions
- Instance Actions
- Media Actions
- Message Actions
- Session Actions
- User Actions
Overview
This node enables sending various types of WhatsApp messages through the WSAPI WhatsApp API, specifically focusing here on the Send Video operation within the Message resource. It allows users to send video files to individual contacts or groups by specifying a publicly accessible media URL. This is useful for automating multimedia communication such as sharing promotional videos, tutorials, or personal video messages.
Practical examples include:
- Sending a product demo video to customers.
- Sharing event highlights with a group chat.
- Automatically replying with a video tutorial in customer support workflows.
Properties
| Name | Meaning |
|---|---|
| To | The recipient's WhatsApp ID. For individual contacts, this is the phone number with country code (no plus sign) followed by @s.whatsapp.net (e.g., 1234567890@s.whatsapp.net). For groups, use the group ID followed by @g.us. |
| Media URL | The direct HTTP/HTTPS URL of the video file to send. Must be publicly accessible. Supported format for videos is MP4. |
| Caption | Optional text caption to accompany the video message. Supports emojis and formatting. |
| Advanced Options | Additional optional settings: - Mentions: Comma-separated list of phone numbers (without @) to mention in the message.- Reply To Message ID: ID of a message to reply to. - Is Forwarded: Boolean flag indicating if the message is forwarded. - View Once: Boolean flag to make the video disappear after being viewed (only applicable for images and videos). |
Output
The node outputs JSON data representing the result of the send video operation. This typically includes metadata about the sent message such as message ID, status, timestamps, and any server response confirming delivery or errors.
If the operation supports binary data output (not indicated explicitly here), it would represent media content or attachments, but for sending video, the output is primarily JSON metadata confirming the action.
Dependencies
- Requires an active connection to the WSAPI WhatsApp API service.
- Needs an API key credential configured in n8n for authentication.
- The media URL must be publicly accessible over HTTP or HTTPS; private or protected URLs will not work.
- Proper permissions and quota on the WSAPI WhatsApp API account to send media messages.
Troubleshooting
- Invalid Recipient ID: Ensure the "To" field uses the correct format (
phone@s.whatsapp.netfor contacts orgroup@g.usfor groups). Missing country codes or incorrect suffixes cause failures. - Media URL Issues: The media URL must be directly accessible without authentication and point to a supported video format (MP4). Broken links or unsupported formats will cause errors.
- Caption Formatting: Unsupported characters or excessive length in captions might lead to message rejection.
- API Authentication Errors: Verify that the API key credential is correctly set up and has sufficient permissions.
- View Once Option: If enabled, ensure the receiving client supports disappearing media; otherwise, the message may not behave as expected.
- Forwarded Flag: Setting the forwarded flag incorrectly might affect message tracking or display on the recipient side.
Common error messages usually indicate invalid parameters, authentication failure, or media access issues. Checking logs and verifying each input property against the API documentation helps resolve these.