对接飞书机器人

1.1 功能简介

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

1.2 效果演示

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

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

• open.feishu.cn

• open.larksuite.com

3.1 创建飞书自建应用

点击进去「飞书开发者后台」页面，创建企业自建应用。

3.2 为应用添加机器人能力

创建完成后，进入应用能力配置页面，在「添加应用能力>按能力添加」中选择机器人，点击添加按钮。

3.3 配置机器人权限管理

为了使机器人具有收发消息的基础功能，需要前往「开发配置>权限管理」中配置相关，可选择批量添加或手动添加，添加方式如下：

1）批量添加

通过如下代码批量导入权限：

{
  "scopes": {
    "tenant": [
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.department:readonly",
      "contact:user.employee_id:readonly",
      "im:app_feed_card:write",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "cardkit:card:write"
    ],
    "user": []
  }
}

2）手动添加

为机器人配置以下权限：

• 获取通讯录基本信息

• 获取通讯录部门组织架构信息

• 获取用户基本信息

• 获取用户 user ID

• 创建、更新、删除应用消息流卡片

• 读取用户发给机器人的单聊消息

• 获取单聊、群组消息

• 以应用的身份发消息

• 发送特定模板系统消息

• 更新消息
  

• 获取与发送单聊、群组消息

• 获取群组中用户@机器人消息

• 创建与更新卡片
  

3.4 配置机器人事件与回调

进入「事件与回调」页面中为机器人添加「接收消息」事件。

3.5 发布应用

完成以上配置后，点击「创建版本」，进入「版本管理与发布」中，保存并发布当前机器人应用的版本。

注：若非飞书管理员创建，需向飞书管理员申请线上发布。

3.6 获取 App ID 与 App Secret

发布成功后，进入「基础信息>凭证与基础信息」中，复制 App ID 与 App Secret。

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

将上述操作中获取到的 App ID 与 App Secret 添加到 Agent 配置页面中。

1）初次使用，需手动搜索机器人
完成以上配置后，进入飞书端搜索「经营情况统计推送」找到创建的机器人，点击即可进入与机器人的单聊界面。

2）在对话中，向机器人发送问题，即可通过机器人开启与 Agent 的对话。