钉钉办公自动化助手

要解决的问题

钉钉办公自动化里，常见卡点不是“能不能调接口”，而是把工作通知、群机器人、审批、考勤几类入口混在一起后，凭证、权限、错误码容易错位。它面向这类场景：用企业自建应用发工作通知、用群机器人 webhook 推送告警、创建或查询审批实例、拉取考勤打卡记录，并在调用失败时快速定位是 appkey 错误、应用未发布，还是接口未授权。

技能如何工作

• 先确认目标：区分工作通知、群机器人、审批、考勤四类路径，避免拿群机器人 token 去调企业接口。
• 再检查凭证：自建应用通常需要 appkey、appsecret、agentId；群机器人通常只需要 webhook token；审批和考勤依赖对应应用权限。
• 获取并缓存 token：通过 gettoken 获取 access_token，资料标注有效期约 7200 秒，适合本地缓存复用。
• 调用对应 OpenAPI：工作通知走 asyncsend_v2，群机器人走 robot/send，审批和考勤走各自 topapi 接口，并按返回错误码排查。

适用边界

它更适合作为接入方法指引和调用骨架，不替用户持有凭证直接访问真实接口。AppSecret、机器人 token 和员工考勤、审批数据都应按企业合规要求处理；群发要遵守钉钉频控与防骚扰规则。最终行为仍以钉钉开放平台最新文档和实际授权为准。