SuperAPI AI 工具集

dingtalk-message

通用与其它

查看项目

更新于 10-15 17:29

技能介绍

用途:负责钉钉消息发送相关操作,按通道路由不同场景。四种通道:Webhook 机器人(往指定群发通知,无需 Token,URL 自带凭证);企业内部应用机器人(单聊私信/群聊,用 --token,可撤回、查已读);工作通知(推送到工作通知,用 --old-token,可推全员/部门);sessionWebhook(回调中直接回复,无需 Token)。

执行流程:识别通道 → 用 bash scripts/dt_helper.sh --get KEY 校验配置 → 收集缺失项并 --set KEY=VALUE 写入 → 获取 Token(机器人 --token,工作通知 --old-token)→ 执行 API,多行逻辑写入 /tmp/<task>.sh 再执行,禁止 heredoc。

配置来源:Webhook 需 DINGTALK_WEBHOOK_URL(加签另需 DINGTALK_WEBHOOK_SECRET),来自群设置→智能群助手→添加自定义机器人;机器人消息需 DINGTALK_APP_KEY + DINGTALK_APP_SECRET;工作通知另需 DINGTALK_AGENT_ID;robotCode 等于 appKey。凭证禁止完整打印,确认仅显示前 4 位加 ****。消息内容缺失时先询问用户,不得编造。

身份标识:消息 API 只接受 userId(staffId),不接受 unionId,可用 dt_helper.sh --to-userid 转换。发群消息前须询问用 Webhook 还是企业机器人。Token 异常时用 --token --nocache 或 --old-token --nocache。

限制:完整 API 请求格式、场景路由、消息类型、错误码与所需权限见 references/api.md;价格、收费等信息资料未提供。