Feishu Bot 详细配置

1. 前置准备

前往飞书开放平台（open.feishu.cn）创建企业自建应用。在「权限管理」中开启以下权限：im:message、im:message.group_at_msg、im:resource、contact:user.id:readonly。确保应用已发布并通过审核。

2. 获取凭据

在应用的「凭证与基础信息」页面获取 App ID 和 App Secret。在「事件订阅」页面获取 Encrypt Key 和 Verification Token。这四个值将在 Semibot 中创建 Bot 实例时使用。

3. 在 Semibot 创建 Bot 实例

进入 Semibot 配置中心 > Bots > 新建，选择 Feishu 类型。填写 App ID、App Secret、Verification Token、Encrypt Key，选择默认 Agent，保存实例。

4. 配置事件订阅

在飞书开放平台的「事件订阅」中，将请求地址设为：https://<your-domain>/v1/integrations/feishu/events。添加事件：im.message.receive_v1（接收消息）。点击保存后飞书会发送验证请求，Semibot 会自动完成校验。

5. 配置卡片动作回调

在飞书开放平台的「卡片回调」中，将请求地址设为：https://<your-domain>/v1/integrations/feishu/card-actions。此回调用于处理审批卡片的同意/拒绝交互。

6. 联调与验证

1. 在 Semibot 中点击「测试」确认出站链路可达。2. 在飞书群中 @机器人 发送消息。3. 在 Semibot 事件中心确认收到入站事件。4. 在会话详情查看执行记录和回传结果。常见错误：URL 不可达（检查 HTTPS 和域名）、验证失败（检查 Verification Token）、无响应（检查权限和应用发布状态）。