对接钉钉机器人

1.1 功能简介

本文将展开讲解如何创建钉钉机器人并对接至 Dora 平台的 Agent 中。

1.2 效果演示

以在钉钉端向机器人询问“帮我查一下26年4月份各办事处的分销金额排名”为例，效果如下所示：

内网环境下，请提前将以下域名加入白名单，确保服务正常访问：

• api.dingtalk.com

• oapi.dingtalk.com

3.1 创建钉钉自建应用

点击登录「钉钉开发者后台」创建企业内钉钉应用。

3.2 为应用添加机器人能力

创建完成后，进入应用能力添加页面，选择添加机器人能力。

3.3 配置并发布机器人基础信息

打开机器人配置开关按钮，配置机器人的名称、图标、简介、描述、预览图等基础信息，消息接收模式选择 Stream 模式。

3.4 配置机器人权限管理

为了使机器人具有收发消息的基础功能，需要前往「开发配置>权限管理」中配置如下权限：

• 个人手机号信息
  

• 调用SNS API时需要具备的基本权限

• 企业员工手机号信息

• 通讯录部门信息读权限

• 通讯录部门成员读权限

• 调用企业API时需要具备的基本权限

• 企业内机器人发消息权限

• 互动卡片实例写权限

• AI卡片流式更新权限

3.5 配置机器人事件订阅

进入「事件订阅」页面，选择机器人的推送方式为「Stream模式推送」，验证连接通道后保存操作。

3.6 发布应用

完成以上配置后，点击查看版本详情，进入「版本管理与发布」中，保存并发布当前应用版本。

3.7 获取应用与机器人信息

发布成功后，获取如下信息：

1）进入「基础信息>凭证与基础信息」中，复制 Client ID 与 Client Secret

2）以开发者身份右上角账户中心中获取 CorpId

3）进入「应用能力>机器人」中，复制 RobotCode

4.1 创建模板

进入「钉钉开发者平台>卡片平台」，点击「新建模板」。

4.2 设置模板信息

设置如下模板信息后点击「创建」：

• 卡片名称：自定义即可

• 卡片类型：选择「消息卡片」

• 卡片模板场景：选择「AI 卡片」

• 关联应用：选择本文第 3 节中创建的钉钉应用

4.3 打开卡片流式组件开关

进入卡片配置页面后，点击「流式富文本内容」后，在「页面右侧>属性>内容」中完成以下设置后，点击保存即可。

• 内容：选择 context

• 流式组件：打开

4.4 复制模板 ID

完成 AI 模板卡片配置后，复制左上角模板 ID。

Dora 平台的超级管理员将上述操作中获取到的 CorpId、Client ID、Client Secret回填至「用户管理>IM用户映射」钉钉机器人的应用对接中，完成钉钉与 Dora 平台的连接与用户映射。

将上述操作中获取到的 Client ID、Client Secret、RobotCode、模板 ID 添加到 Agent 配置页面中。

1）初次使用，需手动搜索机器人

完成以上配置后，进入钉钉应用，直接搜索「经营报告分析」找到创建的机器人，点击即可进入与机器人的单聊界面。

2）在对话中，向机器人发送问题，测试机器人与Agent是否连通。