用途:该技能用于通过 uxc 和 OpenAPI 执行钉钉消息相关操作,复用 uxc 的共享执行、鉴权与错误处理机制。
主要能力:覆盖一对一机器人发送、群机器人发送、服务群发送,以及通过 unionId 进行最小化的用户查询。不覆盖审批、考勤、管理员、更广泛的企业应用流程,也不包含旧版 oapi.dingtalk.com 端点、自定义机器人 webhook token/sign 流程,以及入站回调或 webhook 接收运行时。事件订阅方面,该技能目前仅验证请求/响应的消息操作,钉钉入站事件接收尚未通过 uxc subscribe 验证。
使用方式:需先安装 uxc 并可访问 https://api.dingtalk.com/v1.0 及精选 schema URL,并具备开通机器人消息权限的钉钉内部应用、appKey 与 appSecret(或手动回退用的 accessToken)、robotCode、会话与用户标识。优先使用 bootstrap 自动获取和刷新 access token:先执行 uxc auth credential set、uxc auth bootstrap set 与 uxc auth binding add;也可手动配置 bearer 凭证并绑定到 api.dingtalk.com 的 /v1.0。核心工作流通过 dingtalk-openapi-cli 执行,可先用 -h 查看操作 schema,再以键值或位置 JSON 方式执行。
适用场景与限制:适用于脚本化的钉钉消息发送与简单用户查询。三个发送操作均属高风险写入,执行前需用户明确确认。钉钉的 msgParam 是 JSON 编码字符串而非嵌套对象,需谨慎构造和校验;robotCode、openConversationId、coolAppCode 及目标标识等路由字段缺失通常会导致发送失败。自动化应保持 JSON 输出并解析 ok、kind、protocol、data、error 等字段,不建议使用 --text。该 v1 封装仅支持基于应用的 API。