对接钉钉机器人

更新时间：2026-07-23 14:06:04

概述

通过对接钉钉机器人，可以把 DecideX 智能体发布到钉钉。配置完成后，用户可以在钉钉客户端向机器人提问，机器人会调用已绑定的 DecideX 智能体返回回答。

本文介绍钉钉开发者平台侧的机器人准备工作，以及 DecideX 智能体侧的「渠道入口」配置方法。

前提条件

开始前，请确认已具备以下条件：

• 已创建并保存一个 DecideX 智能体。若只验证机器人是否接通，可先使用测试智能体；若需要回答业务问题，再为智能体绑定对应的 BI 资产、业务本体、参考文件或 Skill。
• 当前账号具备编辑智能体和配置渠道入口的权限。
• 已具备钉钉开发者平台的企业内部应用管理权限。
• 需要使用机器人的成员已获得该智能体的发布授权。未授权成员即使完成钉钉账号绑定，也无法使用该智能体。

创建钉钉机器人

参考 创建钉钉机器人，创建一个用于 DecideX 的钉钉机器人，并准备机器人消息回调所需的加密 Secret。

1. 以管理员身份登录 钉钉开发者平台 > 应用开发模块，创建一个新应用。
2. 在应用详情页，点击「添加应用能力」，选择「机器人」能力并添加。
3. 在机器人配置页面，打开「机器人配置」开关，配置完成机器人信息后点击「发布」。
4. 进入「版本管理与发布」，点击「创建新版本」。填写版本号与描述，选择「应用可见范围」后，点击「保存」完成发布。
5. 进入「凭证与基础信息」，记录「Client Secret」。

在 DecideX 配置钉钉渠道入口

在 DecideX 中把钉钉机器人绑定到指定智能体。

1. 进入 DecideX，点击左侧导航「智能体」，找到需要接入钉钉的智能体，点击「设置」进入智能体配置页。

   

2. 在左侧导航栏点击「渠道入口」，点击右上角「+」，选择「钉钉」。

   

3. 按页面提示填写 Callback Signing Secret。该字段来源于钉钉机器人开放平台应用凭证中的 OpenAPI Client Secret。

   

4. 填写完成后，点击「添加频道」完成机器人添加，同时保存「钉钉回调地址」，用于钉钉机器人配置事件回调。

   

   添加完成后，可以看到「渠道入口」新增了一个钉钉入口，显示为「待回调激活」。

   

配置钉钉机器人回调地址

返回钉钉开发者平台机器人配置页面，选择「消息接收模式」为「HTTP 模式」，并将「钉钉回调地址」填入。

填写完成后，进入「版本管理与发布」，创建新版本并重新发布应用。前一次发布用于让机器人能力生效；本次重新发布用于让消息接收地址和回调配置生效。

注意

「消息接收模式」需要在 DecideX 配置完成渠道入口后再添加。

钉钉客户端提问

配置完成后，在钉钉客户端验证机器人是否可以正常回答问题。首次使用时，系统会先要求用户绑定 DecideX 账号；绑定完成后，再回到钉钉向机器人发送问题。

1. 在钉钉客户端搜索机器人名称，在搜索结果中点击目标机器人。

   

2. 进入机器人对话窗口后，先发送一条消息，例如「你好」。如果当前钉钉用户尚未绑定 DecideX 账号，机器人会返回账号绑定链接。

   

3. 点击绑定链接，进入 DecideX 账号绑定页面，确认当前 DecideX 用户无误后，点击「确认绑定」。

   

4. 页面提示「钉钉用户已绑定成功」后，回到钉钉客户端，重新给机器人发送消息。

   

   此时回到「渠道入口」页面，钉钉渠道从「待回调激活」变为「已启用」，表示回调已生效。

   

5. 输入一个智能体可回答的问题，例如「本周销售情况怎么样」。检查机器人是否返回回答，并确认回答内容符合该智能体的数据权限和业务范围。

   

   回到 DecideX 智能体会话页，可以看到来自钉钉的会话记录。该记录可用于排查问题、复盘回答过程和查看最终回复。

   

6. 也可以将机器人添加至群聊，在群聊中通过 @ 机器人提问。

   

常见问题

钉钉机器人没有响应

按以下顺序排查：

• 确认钉钉应用已发布，且应用可见范围包含当前测试用户。
• 确认钉钉机器人已开启，并已配置机器人名称、图标和简介等基础信息。
• 确认「消息接收模式」为「HTTP 模式」，且消息接收地址使用的是 DecideX 生成的「钉钉回调地址」。
• 确认消息接收地址填写后，已进入「版本管理与发布」重新发布应用。
• 确认 DecideX 渠道入口中的 Callback Signing Secret 填写正确。
• 确认 DecideX 渠道入口状态已从「待回调激活」变为「已启用」。
• 如果在群聊中提问，确认机器人已加入当前群，并按钉钉要求唤起机器人。

机器人能响应，但无法返回业务数据

请检查以下配置：

• 当前钉钉用户是否已完成 DecideX 账号绑定。
• 当前 DecideX 用户是否获得该智能体的发布授权。
• 智能体是否已绑定正确的 BI 资产、业务本体或参考文件。
• 当前用户是否拥有相关数据权限。
• 提问内容是否超出该智能体的角色指令、数据范围或工具能力。

钉钉账号绑定链接打不开或绑定后仍无权限

请检查以下配置：

• 打开绑定链接前，确认浏览器中已登录正确的 DecideX 账号。
• 如果绑定后仍提示无权限，确认该 DecideX 账号已被加入智能体的「发布授权」范围。
• 如果企业启用了统一身份映射，确认钉钉账号与企业账号已完成关联。
• 如更换了测试用户，建议重新触发机器人消息，使用新生成的绑定链接完成绑定。

使用建议

• 群聊机器人适合经营复盘、异常追踪、门店巡检、销售日报等多人协同场景。
• 机器人绑定的智能体应有清晰职责，避免一个群机器人同时承担过多分析任务。
• 对涉及经营数据的问题，应先在 DecideX 调试页验证回答质量，再开放到钉钉群。
• 如需区分不同团队或业务线，可为不同群配置不同机器人或不同智能体。