Actions10
- User Action Actions
- Message Action Actions
Overview
This node integrates with the Zalo Web API to send video messages to a specified user. It supports sending videos either by uploading binary data or by providing direct URLs to the video and its thumbnail. This functionality is useful for automating multimedia messaging in chat applications, marketing campaigns, customer support, or any scenario where sending video content programmatically via Zalo is needed.
For example, you can use this node to:
- Send promotional videos to customers automatically.
- Share tutorial or informational videos in response to user queries.
- Deliver personalized video messages as part of a workflow.
Properties
Name | Meaning |
---|---|
User ID | Unique identifier for the target chat or username. To find your chat ID, ask @get_id_bot on Zalo. |
Binary File | Whether the video data should be taken from a binary input field (true) or from URLs (false). |
Input Binary Field | The name of the binary property containing the video file to upload when Binary File is true. |
Video | Attachments to add when Binary File is false. Supports multiple videos, each with: |
- Video URL: The URL of the video to send. | |
- Thumbnail URL: The URL of the video's thumbnail image (optional). |
Output
The node outputs an array with one item per input, each containing a json
object with a data
field. This data
field holds the response from the Zalo Web API after attempting to send the video message. The exact structure depends on the API response but typically includes status information about the sent message.
If binary data is used, the node handles temporary file creation and cleanup internally but does not output binary data itself.
Dependencies
- Requires an API key credential for authenticating with the Zalo Web API.
- Needs proper configuration of the Zalo Web API credentials within n8n.
- Uses internal helper functions to handle binary data conversion and temporary file management.
- Relies on network access to fetch video files if URLs are provided.
Troubleshooting
Common Issues:
- Incorrect or missing User ID will cause the message sending to fail.
- Providing invalid video URLs or inaccessible resources will result in errors downloading the video.
- If Binary File is set to true but the specified binary property does not exist or is empty, the upload will fail.
- Temporary file creation or cleanup errors may occur if the environment restricts file system access.
Error Messages:
- "Operation not supported" or similar indicates that the chosen operation or resource is incorrect.
- Network errors during video download usually indicate unreachable URLs or permission issues.
- Authentication errors suggest invalid or expired API credentials; reconfigure the API key credential.
Resolutions:
- Verify the User ID is correct by using the recommended bot (@get_id_bot).
- Ensure video URLs are publicly accessible or provide valid binary data.
- Confirm the binary property name matches the actual input binary field.
- Check environment permissions for temporary file handling.
Links and References
- Zalo Official Developer Documentation
- n8n Documentation on Creating Custom Nodes
- How to Find Your Chat ID on Zalo (or use @get_id_bot on Zalo)