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 新建实例时会用到这四项。

3. 在 Semibot 创建 Bot 实例

打开 Semibot 配置中心，进入 Bots > 新建，选择 Feishu。把 App ID、App Secret、Verification Token 和 Encrypt Key 填进去，再选好默认智能体并保存。

4. 配置事件订阅

在飞书开放平台的「事件订阅」里，把请求地址设成：https://<your-domain>/v1/integrations/feishu/events。再加上 im.message.receive_v1 这个事件。保存后飞书会发一次验证请求，Semibot 会自动完成校验。

5. 配置卡片动作回调

如果你要用审批卡片，在飞书开放平台的「卡片回调」里，把请求地址设成：https://<your-domain>/v1/integrations/feishu/card-actions。这样用户在卡片上点同意或拒绝时，Semibot 才能收到。

6. 联调与验证

先在 Semibot 里点「测试」，确认消息能发出去。然后在飞书群里 @机器人 发一条消息，再去事件中心看有没有收到入站事件，最后到会话详情里确认执行和回传结果。常见问题一般就三类：URL 不可达、Verification Token 不对，或者权限没开全。