配置飞书集成

打开系统设置，选择「应用与集成」- 「飞书集成」。

目前，LigaAI的飞书集成通过创建飞书自建应用的方式完成，根据集成配置页的步骤创建应用并完成相关的配置后，即可使用飞书应用管理你在LigaAI的工作。

在配置前，请确保你具备LigaAI组织和飞书后台的管理权限。

第一步：创建飞书应用

1、匹配飞书企业

打开飞书管理后台，点击「企业设置 」- 「企业信息」，把企业信息中的「企业编号」填写在 LigaAI 飞书集成配置页-创建应用中。

2、创建应用

打开飞书开放平台，点击「创建应用」打开开发者后台。

2.1 点击「创建企业自建应用」，按照提供的信息创建应用:

• 应用名称：LigaAI 助手
• 应用描述：新一代智能研发管理平台-LigaAI
• 应用图标：点击下载LigaAI-logo（详见配置详情页下载地址）

2.2 完成创建后，将在企业自建应用列表看到新创建的应用，点击进入应用详情页；在左侧导航选择「凭证与基础信息」，把「应用凭证」的 App ID 和 App Secret 填写在 LigaAI 飞书集成配置页步骤2-（2）的输入框中。

第二步：配置飞书应用

1、添加应用能力

在飞书应用详情的左侧导航点击「添加应用能力」展开二级菜单

(1) 选择「网页应用」，点击「添加能力」按钮，在网页应用配置「桌面端主页」及「移动端主页」填写地址并保存

桌面端主页和移动端主页地址，详见配置详情页-配置说明

(2) 在「应用能力-网页应用」详情下方，找到「网页应用的扩展场景-消息快捷操作」，点击「添加场景」按钮，在「桌面端」及「移动端」填写地址，并把提供的信息填写在「操作名称」及「操作介绍」中

• 跳转链接：详见配置详情页-配置说明
• 操作名称：添加LigaAI待办
• 操作介绍：一键将对话消息添加为LigaAI个人或项目待办

(3) 返回「添加应用能力」，选择「机器人」，点击「添加能力」，在「机器人配置-消息卡片请求网址」中填写地址并保存

• 如何开始使用：使用说明文档详见https://doc.ligai.cn/zh/docs/feishu-integration-features
• 机器人自定义菜单
• 菜单状态：开启
• ① 菜单配置：
• 主菜单配置-名称：进入 LigaAI
• 响应动作-跳转到指定链接：
• 桌面端主页：详见配置详情页-配置说明
• 移动端主页：详见配置详情页-配置说明
• ② 菜单配置：
• 主菜单配置-名称：LigaAI 客服
• 响应动作-跳转到指定链接：
• 桌面端主页：详见配置详情页-配置说明
• 移动端主页：详见配置详情页-配置说明

2、权限管理

在飞书应用详情左侧导航点击打开「权限管理」，选择以下权限：

•获取部门组织架构信息

•以应用身份读取通讯录

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

•给多个用户批量发消息

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

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

•接收群聊中@机器人消息事件

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

•获取与更新群组消息

•读取群消息

•获取群组消息

3、事件订阅

在飞书应用详情左侧导航点击打开「事件订阅」

(1) 在「请求地址配置」下方填写地址：详见配置详情页-配置说明

(2) 点击「事件订阅-添加事件」，搜索到下列事件勾选，点击完成

事件名称：

• 用户和机器人的会话首次被创建（V1.0）
• 通讯录范围权限被更新（V2.0）
• 通讯录变更（V1.0）
• 接收消息（V2.0）
• 消息撤回（V2.0）
• 解散群（V2.0）
• 群配置修改（V2.0）
• 机器人进群（V2.0）
• 机器人被移出群（V2.0）

(3) 在「回调配置-订阅方式」下方填写地址：详见配置详情页-配置说明

(4) 点击「添加回调」，在「卡片」分类中找到「消息卡片回传交互（旧）」勾选后点击确认添加

4、 安全设置

在飞书应用详情左侧导航点击打开「安全设置」，在「H5 可信域名」处填写地址：详见配置详情页-配置说明

5、应用发布

在飞书应用详情左侧导航点击「版本管理与发布」

(1) 点击「创建版本」

• 填写应用版本号及更新说明（自定义）；将「移动端默认的应用功能」选择为「机器人」、「PC客户端默认的的应用功能」选择为「网页应用」
• 根据团队的需要，设置自建应用的「可用范围」；如后续需要变更可用范围，可重新创建版本再发布
• 保存设置后，点击「申请发布」

(2) 设置应用可用范围

注意：应用发布成功后，LigaAI 助手将通过飞书给设置范围内的所有成员发送授权邀请消息;

• 如果整个企业将正式启用LigaAI飞书集成：可选全部成员；
• 如果仅个别部门开始使用：可选部分成员，仅勾选使用的部门；
• 如果当前仍在试用阶段，可仅勾选自己，或其他参与试用的同事，以免打扰其他同事。

(3) 创建版本申请发布后，管理员将在飞书应用中接收到应用审核的信息，点击前往通过审核，创建人则将在飞书收到审核通过的消息。

6、应用授权

应用发布成功后，将收到LigaAI助手欢迎卡片。点击欢迎卡片下方的「去授权」按钮，完成LigaAI账号的飞书授权操作。

完成以上所有步骤后，LigaAI-飞书应用即可使用。