dingtalk-ding

DingTalk DING Urgent Message Skill

🧪 EXPERIMENTAL · Trial version / Preview — multi mode currently does not meet the stable standard. All dingtalk-* skills have passed the dispatch verifier, but interfaces, naming, and cross-skill references may be adjusted later; for production / shared environments, please prefer mono mode (dws skill setup --mode mono). For issues, please file an issue.

PREREQUISITE: Read the dws-shared skill first for auth, global flags, product routing, URL preflight, error codes, and safety rules. The dws binary must be on PATH.

⚠️ Command availability is subject to the current dws binary. Service discovery has been taken offline; this document is released along with the built-in skill; if dws <cmd> --help does not exist, it means the current version does not expose this command. If the command exists but the call fails, please follow the endpoint or tool prompts in the error to confirm the static endpoint catalog and backend tool registration. Before actually calling, you can use dws <cmd> --help or --dry-run to verify.

Command reference:ding.md。

Shortcuts (preferred when there is no dedicated script/recipe)

The following shortcuts come from a public catalog independent of the Runtime Schema. First route by this skill's intent table, scripts, and recipes: when a dedicated script/recipe precisely covering the scenario exists, execute according to it; otherwise, when the user's intent matches, shortcuts take precedence over hand-written atomic commands. Use dws shortcut list --service ding --format json to read parameters, constraints, risks, and examples, and use dws ding <shortcut> --help to check the current Cobra flags; do not call + on dws schema。

Shortcut	Risk	Applicable scenario
dws ding +list	read	Query the DING message list
dws ding +recall-personal	high-risk-write	Recall a DING initiated by yourself
dws ding +receiver-status	read	Query the read status of DING message recipients
dws ding +send-personal	write	Send a DING to specified people as yourself

Intent table

User says	Command
"DING Zhang San" / "in-app urgent notification"	dws ding message send --type app --users <userId> --content "<内容>"
"SMS DING"	dws ding message send --type sms --users <userId> --content "<内容>"
"phone DING" / "phone someone"	dws ding message send --type call --users <userId> --content "<内容>"
"recall DING"	dws ding message recall --id <openDingId>

Cross-product collaboration

• If the recipient is a person's name → first use dingtalk-aisearch to get userId
• Regular notification (no guaranteed delivery required) → switch to dingtalk-chat