飞书

介绍

认证:飞书 插件支持用户使用飞书账号登录 Data Agent.

激活插件

飞书相关功能集成在data agent系统中,无需手动激活插件。

在飞书开发者后台创建或选择应用

  • 进入飞书开发者后台,创建企业自建应用。
  • 添加应用能力,选择“网页应用”。填写桌面端主页和移动端主页地址为dataagent系统域名。 飞书网页应用配置
  • 添加应用能力,添加”机器人“。
  • 进入权限管理,批量导入以下权限:
{
  "scopes": {
    "tenant": [
      "application:application:self_manage",
      "auth:user_access_token:read",
      "bitable:app",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.basic_profile:readonly",
      "contact:user.employee_id:readonly",
      "docs:doc",
      "docx:document:readonly",
      "im:chat",
      "im:chat:read",
      "im:chat:update",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource"
    ],
    "user": [
      "base:app:copy",
      "base:app:create",
      "base:app:read",
      "base:app:update",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:record:create",
      "base:record:delete",
      "base:record:retrieve",
      "base:record:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "board:whiteboard:node:create",
      "board:whiteboard:node:read",
      "calendar:calendar.event:create",
      "calendar:calendar.event:delete",
      "calendar:calendar.event:read",
      "calendar:calendar.event:reply",
      "calendar:calendar.event:update",
      "calendar:calendar.free_busy:read",
      "calendar:calendar:read",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.basic_profile:readonly",
      "contact:user.employee_id:readonly",
      "contact:user:search",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.media:download",
      "docs:document.media:upload",
      "docs:document:copy",
      "docs:document:export",
      "docx:document:create",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive.metadata:readonly",
      "drive:file:download",
      "drive:file:upload",
      "im:chat.members:read",
      "im:chat:read",
      "im:message",
      "im:message.p2p_msg:get_as_user",
      "im:message:readonly",
      "offline_access",
      "search:docs:read",
      "search:message",
      "sheets:spreadsheet.meta:read",
      "sheets:spreadsheet:create",
      "sheets:spreadsheet:read",
      "sheets:spreadsheet:write_only",
      "space:document:delete",
      "space:document:move",
      "space:document:retrieve",
      "task:comment:read",
      "task:comment:write",
      "task:task:read",
      "task:task:write",
      "task:task:writeonly",
      "task:tasklist:read",
      "task:tasklist:write",
      "wiki:node:copy",
      "wiki:node:create",
      "wiki:node:move",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:read",
      "wiki:space:retrieve",
      "wiki:space:write_only"
    ]
  }
}
  • 进入开发配置 > 安全设置,配置重定向URL(redirect_uri)为http(s)://<dataagent系统域名>/api/feishu:redirect
  • 进入开发配置 > 事件与回调,订阅方式选择长连接,并添加如下事件: alt text
  • 进入基础信息 - 凭证与基础信息,复制App ID和App Secret。

基本配置

Warning

修改任何配置项后,必须点击系统右上角头像,选择重启应用,才能生效

  1. 进入 设置 > 认证
  2. 点击 添加 并选择 飞书
  3. 配置以下设置项

配置截图1

把App ID和App Secret填写到认证器的客户端 ID和客户端密钥字段中。