Overview
This node sends messages to a DingTalk group via a custom robot webhook. It supports multiple message types including text, link, markdown, and action card, allowing users to customize the content and format of notifications sent to DingTalk groups. This is useful for automating alerts, updates, or notifications in team collaboration environments.
Use Case Examples
- Sending a simple text notification to a DingTalk group.
- Sending a link message with a title, image, and URL to provide more context.
- Sending a markdown message for rich text formatting.
- Sending an action card message with buttons for interactive notifications.
Properties
| Name | Meaning |
|---|---|
| Access Token | The access token of the DingTalk webhook used for authentication. |
| Secret | The secret key of the DingTalk webhook used for signing requests (optional). |
| Message Type | The type of message to send. Determines the message format and required fields. |
| Title | The title of the message, required for link, markdown, and action card message types. |
| Content | The main content or text of the message, required for all message types. |
| Link URL | The URL for the link message type. |
| Link Image URL | The image URL for the link message type. |
| Button Orientation | The orientation of buttons in an action card message (vertical or horizontal). |
| Actions | A collection of action buttons for the action card message, each with a title and URL. |
Output
JSON
dingbotMessage- The constructed DingTalk message object ready to be sent.
Dependencies
- ts-dingtalk-robot library for constructing and sending DingTalk messages
Troubleshooting
- Ensure the access token and secret (if used) are correct and valid to avoid authentication errors.
- Verify that the message type is supported and all required fields for that type are provided to prevent errors.
- Check network connectivity to DingTalk's API endpoint to ensure messages can be sent.
- If an unsupported message type is specified, the node will throw an error indicating the unsupported type.
Links
- DingTalk Custom Robot Access Documentation - Official documentation for DingTalk custom robot webhook message types and usage.