飞书

本文介绍如何创建飞书企业自建应用机器人，将单聊文本或群聊中 @机器人的消息发送到腾讯云 EdgeOne Makers ，由 Agent 生成结果并返回原会话。

前提条件和适用范围

1. 已有飞书组织及账号，具有创建企业自建应用的权限；测试成员属于该组织。

2. 可以完成应用发布所需的管理员审核，并设置应用可用范围。

3. 已开通 Makers。

4. 本文使用飞书中国版企业自建应用，验证单聊和群聊提及的文本消息，不覆盖 Lark、多租户商店应用或卡片交互。

创建应用并启用机器人

1. 登录飞书开发者后台。

2. 单击 创建企业自建应用，输入名称、描述并上传图标，完成创建。

3. 进入应用详情，在 添加应用能力 中添加 机器人。参见启用机器人能力。

4. 进入 凭证与基础信息，复制 App ID 和 App Secret。

申请权限

1. 在应用详情中进入 权限管理。

2. 搜索下表中的权限标识，申请所需的应用身份权限。

权限	用途	配置要求
im:message.p2p_msg:readonly	读取用户发给机器人的单聊消息	单聊必需
im:message.group_at_msg:readonly	接收群聊中用户 @当前机器人的消息	群聊必需
im:message:send_as_bot	以应用机器人身份发送回复	必需

获取事件加密配置

1. 进入 开发配置 > 事件与回调 > 加密策略。

2. 复制 Verification Token。

3. 配置并复制 Encrypt Key，后续与 Makers 中的值保持一致。





以上获取的参数用途

配置	用途
App ID / App Secret	获取飞书应用访问凭证，用于发送回复
Verification Token	校对事件 Token
Encrypt Key	解密事件正文，并参与事件签名验证

部署 Makers 模板

1. 打开 Makers Agent for IM 模板。

2. 在项目环境变量设置中填写以下变量（负责一份.env.example 为.env）。

环境变量	是否必填	填写说明
FEISHU_APP_ID	是	App ID
FEISHU_APP_SECRET	是	App Secret
FEISHU_ENCRYPT_KEY	是	Encrypt Key
FEISHU_VERIFICATION_TOKEN	是	Verification Token

3. 保存配置并部署

4. 复制生产环境 HTTPS 域名，在末尾添加 /feishu

5. 注意服务应该部署大陆可用区，飞书服务才能正确访问。

配置事件请求地址

1. 返回飞书应用详情，进入 开发配置 > 事件与回调 > 事件配置。

2. 将订阅方式选择为 将事件发送至开发者服务器，填写上面步骤中的完整请求地址。

3. 保存地址并等待 URL 校验成功。

4. 单击 添加事件，选择消息事件 im.message.receive_v1。官方文档中对应 接收消息 v2.0，以事件标识为准。

5. 保存事件配置，确认事件要求的接收权限已申请。





发布应用并添加机器人

1. 进入 应用发布 > 版本管理与发布，创建版本，填写版本号及更新说明。

2. 在应用可用范围中加入测试成员或测试部门，提交发布。

3. 如组织要求管理员审核，等待审核通过，确认版本已发布。

4. 使用可用范围内的账号，在飞书客户端搜索该应用机器人并打开单聊。

5. 如需测试群聊，在目标群的设置中进入 群机器人，添加当前应用机器人。

发送消息并验证

1. 在机器人单聊中发送 `请用一句话介绍腾讯云 EdgeOne Makers。`。

2. 等待 Agent 完成，确认原单聊收到新的文本回复。

3. 在测试群输入 `@`，从候选列表选择当前机器人，发送同样的问题，确认该群收到新的文本回复。

4. 在单聊发送 `请把上一条回答缩短为十个字以内。`；群聊中发送追问时仍需 @机器人。