Actions18
Overview
This node sends a video message to a specified user on a WeChat Official Account. It is useful for customer service scenarios where you want to deliver rich media content, such as product demos, tutorials, or promotional videos, directly to users via WeChat's customer messaging interface.
For example, a business can use this node to send a welcome video to new subscribers or provide visual support by sending instructional videos in response to user inquiries.
Properties
Name | Meaning |
---|---|
接收用户ID | The OpenID of the WeChat Official Account user who will receive the video message. |
视频媒体ID | The media ID of the video to be sent to the user. |
视频封面媒体ID | The media ID of the thumbnail image (cover) for the video. |
视频标题 | The title of the video message being sent. |
视频描述 | A description or caption for the video message. |
Output
The node outputs JSON data representing the response from the WeChat API after attempting to send the video message. This typically includes status information indicating success or failure of the message delivery.
No binary data output is involved in this operation.
Dependencies
- Requires an active WeChat Official Account with appropriate permissions to send customer messages.
- Needs an API authentication token or key configured in n8n credentials to authorize requests to the WeChat API.
- The base URL defaults to
https://api.weixin.qq.com/cgi-bin/
but can be overridden via credentials.
Troubleshooting
- Invalid or expired media IDs: If the video media ID or thumbnail media ID is incorrect or expired, the API will return an error. Ensure that media files are uploaded and valid before referencing their IDs.
- User OpenID issues: Sending to an invalid or unsubscribed user OpenID will fail. Verify the recipient’s OpenID is correct and that they have interacted with the Official Account.
- API authentication errors: Missing or incorrect API credentials will cause authorization failures. Confirm that the API key/token is correctly set up in n8n.
- Message size limits: Videos exceeding WeChat’s size or duration limits may be rejected. Check WeChat documentation for media constraints.