Dingbot - Send Message

Send message from Dingbot

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

  1. Sending a simple text notification to a DingTalk group.
  2. Sending a link message with a title, image, and URL to provide more context.
  3. Sending a markdown message for rich text formatting.
  4. 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

Discussion