IM机器人-钉钉
AI数字员工的IM机器人-钉钉 集成配置，让您可以通过钉钉里面直接使用安捷智用的AI数字员工功能。在钉钉中向智能机器人发送任务指令，AI数字员工在电脑上自动执行，并将结果同步回钉钉聊天窗口。
一、创建钉钉应用
1.1 登录开发者后台
打开浏览器，访问 [钉钉开发者后台](https://open.dingtalk.com/)，使用管理员账号登录，进入到【开发者管理后台】。
首次使用：如果系统提示「该账号还未加入组织」，您可以创建一个个人企业，按需填写信息即可。
1.2 创建应用
在开发者后台首页，点击「应用开发」，并点击「创建应用」
在弹出的创建窗口中，填写以下信息。完成后，点击「保存」
| 配置项 | 填写内容 | 说明 |
|---|---|---|
| 应用名称 | 自定义名称 | 后续都可以随意修改 |
| 应用描述 | 简单描述用途 | 后续都可以随意修改 |
| 应用类型 | 可以暂时不传 | — |
1.3 添加机器人能力
应用创建成功后，会自动跳转到「添加应用能力」页面：
-
找到「机器人」选项，点击「添加机器人」
-
填写机器人的基本信息：
-
机器人名称：给机器人起一个名字
-
机器人描述：简单描述功能
-
预览图：上传一张机器人头像
-
点击「确认发布」
二、配置钉钉应用权限
为了让机器人能够正常收发消息，需要开通以下权限：
- 在应用详情页左侧菜单中，点击「权限管理」
-
在搜索框中分别搜索以下权限，并点击「立即开通」：
-
Card.Streaming.Write -
Card.Instance.Write -
qyapi_robot_sendmsg
三、获取钉钉应用凭证
3.1 查看凭证信息
- 在应用详情页左侧菜单中，点击「凭证与基础信息」
-
在页面中找到以下两个重要信息：
-
Client ID（也叫 AppKey）
-
Client Secret（也叫 AppSecret）
重要：这两个凭证非常重要，请务必妥善保存，不要泄露给他人！
3.2 获取 AES Key 和 Token
在应用详情页左侧菜单中，点击「开发配置 → 事件订阅」，在「推送方式」中选择「HTTP推送」。
您可以点击刷新按钮自动生成您的 AES Key 和 Token。
重要：请务必妥善保管 AES Key 和 Token，不要泄露给他人！
四、在 AI数字员工 中配置钉钉
4.1 填写凭证
打开 AI数字员工，点击助理的设置 ⚙️ 图标后进入助理设置，选择钉钉集成：
将刚才获取的 Client ID 和 Client Secret 填入对应输入框：
-
WebSocket 长连接模式：适用于个人/家庭/办公室用户（没有公网 IP）。配置更简单，不需要公网地址，开箱即用。
-
使用 URL 回调模式：适用于有服务器、有公网 IP 的用户，需要额外在钉钉开发者后台填写生成的 Webhook 地址。
4.2 注册
WebSocket 长连接：点击「注册」，配置成功后显示「已连接」。
使用 URL 回调：点击注册后显示「已注册」，系统会生成一个 Webhook 地址，点击复制保存。
选择「使用 URL 回调」，还需要返回钉钉开发者后台，配置钉钉消息接收地址：
- 进入机器人配置页面
- 下滑到页面底部，找到消息接收配置
- 将「Stream 模式」切换为「HTTP 模式」
- 在「消息接收地址」中粘贴 Webhook 地址
- 重要：将地址中的
http改为https - 点击「发布」保存配置
五、发布应用
应用必须发布后才能在钉钉中使用。
5.1 创建版本
- 点击页面上方的「查看版本详情」
- 填写版本描述信息
5.2 提交发布
- 点击「确认发布」提交审核
- 等待审核通过（通常会很快自动审批）
六、开始使用
钉钉机器人支持两种使用方式：群聊使用和单聊使用。
6.1 在群聊中使用
如果您想在群里使用机器人：
第一步：创建或选择一个群聊
创建群聊时，请确保群的「归属组织」与创建机器人时的组织相同。
第二步：添加机器人到群聊
- 点击群右上角的设置按钮
- 选择「机器人」
- 点击「添加机器人」
- 搜索并选择您创建的机器人
- 确认添加
第三步：开始使用
在群里 @机器人 并发送您的需求，AI数字员工 会自动执行任务并回复结果。
6.2 单聊使用
如果您想直接与机器人私聊：
- 在钉钉顶部搜索框中，搜索机器人的名称
- 点击机器人进入对话窗口，直接发送消息即可
恭喜：您已成功将 AI数字员工 接入钉钉！现在可以通过钉钉随时随地远程控制 AI数字员工 完成各种编程任务了。
七、常见问题
Q1：机器人没有响应怎么办？
请按以下步骤排查：
- 检查应用状态：确认应用已发布并通过审批
- 检查 Webhook 配置：确认地址正确，且使用的是
https协议 - 检查 AI数字员工：确保电脑上的 AI数字员工 正在运行，且助理已开启
- 检查权限：确认三个权限都已正确开通
Q2：在群里找不到机器人怎么办？
- 确认机器人应用已发布
- 确认群聊的「归属组织」与机器人所属组织相同
- 尝试重启钉钉客户端