Actions18
Overview
This node enables sending a music message to a user via a WeChat Official Account's customer service messaging interface. It is useful for scenarios where you want to share music content directly with your followers or customers on WeChat, such as promoting songs, sharing playlists, or providing audio content as part of customer engagement.
Practical examples include:
- Sending a new song release link to subscribers.
- Sharing background music during customer support interactions.
- Delivering curated music recommendations in marketing campaigns.
Properties
| Name | Meaning |
|---|---|
| 接收用户ID | The OpenID of the WeChat Official Account user who will receive the music message. |
| 音乐链接 | URL of the music to be sent to the user. |
| HQ音乐链接 | URL of the high-quality version of the music, preferred when the user is on WiFi. |
| 音乐封面媒体ID | Media ID of the music cover image to be displayed with the music message. |
| 音乐标题 | Title of the music being sent. |
| 音乐描述 | Description or additional information about the music. |
Output
The node outputs JSON data representing the response from the WeChat API after attempting to send the music message. This typically includes status information indicating success or failure of the message delivery.
If binary data were involved (e.g., media files), it would represent the media content or references, but in this case, the node primarily handles JSON responses related to message sending status.
Dependencies
- Requires an API key credential for authenticating with the WeChat Official Account API.
- Needs proper configuration of the base URL for the WeChat API endpoint (defaulted to
https://api.weixin.qq.com/cgi-bin/). - The music cover image must already be uploaded to WeChat and referenced by its media ID.
Troubleshooting
- Common issues:
- Invalid or expired user OpenID may cause message sending failures.
- Incorrect or missing media ID for the music cover image will result in errors.
- Network or authentication errors if the API key credential is misconfigured.
- Error messages:
- "invalid openid": Check that the recipient user ID is correct and corresponds to a follower of the official account.
- "media_id is invalid": Ensure the music cover image has been uploaded and the media ID is valid.
- Authentication errors: Verify the API key credential and permissions.