Actions21
Overview
This node enables sending WhatsApp video messages using the DinastiAPI service. It supports multiple ways to provide the video content, including binary data from a previous node, base64-encoded strings, or direct URLs to video files. Users can add captions and customize message options such as message duration, presence simulation (typing/recording indicators), view-once mode, and context information like replies or mentions.
Typical use cases include:
- Automating video message broadcasts to customers or groups.
- Sending personalized video updates or announcements.
- Integrating AI workflows that generate or select videos dynamically and send them via WhatsApp.
Example: A marketing automation workflow could generate a promotional video, encode it in base64, and send it with a caption to a customer list.
Properties
| Name | Meaning |
|---|---|
| Recipient | Phone number, Group ID (@g.us), Newsletter ID (@newsletter), or LID (@lid) identifying the message recipient. |
| Video Source | Method to provide the video: • Binary Data (from previous node) • Base64 encoded video string • URL to the video file |
| Binary Property | Name of the binary property containing the video data when using Binary Data source (default: "data"). |
| Base64 Video | Base64 encoded video string (H.264 codec, AAC audio). Required if Video Source is Base64. |
| Video URL | URL to the video file. Required if Video Source is URL. |
| Caption | Optional caption text for the video message. |
| Additional Options | Collection of optional settings: • Message ID: Custom identifier for the message. • Presence Simulation: Duration in milliseconds to simulate typing/recording indicator. • Message Duration: Disappearing message timer. • View Once: Whether the video can be viewed only once. • Context Information: Reply, forward, mention details for the message. |
Output
The node outputs JSON data representing the API response from DinastiAPI after sending the video message. This includes status information about the sent message and any metadata returned by the API.
If the operation fails, the output JSON will contain an error message describing the issue.
No binary data is output by this node for the Send Video operation.
Dependencies
- Requires an active DinastiAPI account with a valid API key credential configured in n8n.
- The node uses the DinastiAPI endpoints to send WhatsApp messages.
- For binary data sources, the input must contain properly formatted binary data with correct MIME types (e.g., "video/mp4").
- Network access to the provided video URLs or external resources is necessary if using URL or Base64 sources.
Troubleshooting
- Binary Property Not Found: If you select "Binary Data" as the video source but the specified binary property does not exist in the input item, the node will throw an error like
Binary property "data" not found. Ensure the previous node outputs the binary data under the correct property name. - Invalid Video Format: Videos should be encoded with H.264 codec and AAC audio for compatibility. Using unsupported formats may cause delivery failures.
- Missing Required Fields: When using Base64 or URL sources, the corresponding fields (
videoBase64orvideoUrl) are required. Omitting them will cause errors. - API Errors: Errors returned from DinastiAPI (e.g., invalid phone numbers, authentication issues) will appear in the output JSON's error field. Verify credentials and recipient formatting.
- View Once Option: Setting "View Once" to true restricts the recipient to viewing the video only once; ensure this matches your intended use case.
Links and References
- DinastiAPI GitHub Repository
- WhatsApp Media Guidelines (for supported codecs and formats): https://developers.facebook.com/docs/whatsapp/api/media/
- n8n Documentation on Binary Data Handling: https://docs.n8n.io/nodes/expressions/#binary-data