飞书集成配置
当前正式链路为 Webhook + OpenAPI。本页用于指引生产环境接入与联调检查。
第一步:创建飞书应用
在飞书开放平台创建企业自建应用,并开通当前链路需要的权限。
点击下方链接,在飞书开放平台创建一个企业自建应用。 创建完成后,将 App ID 和 App Secret 写入服务端环境变量。
打开飞书开放平台第二步:配置事件订阅
当前正式方案使用 Webhook 接收会议事件。
Webhook 回调地址
在飞书开放平台中选择 Webhook 订阅方式,并配置以下回调地址:
https://your-domain.com/api/feishu/webhook同时请在飞书后台填写与服务端环境变量 FEISHU_WEBHOOK_VERIFICATION_TOKEN 一致的 Verification Token。
在「事件订阅」中添加以下事件:
重要提示
`vc.bot.meeting_ended_v1` 用于覆盖“用户被邀请但未实际参会”的场景,这是当前从 CLI 切到 Webhook 的核心原因。
会议结束
vc.bot.meeting_ended_v1
会议整体结束时触发
参与的会议结束
vc.meeting.participant_meeting_ended_v1
用户参与的会议结束时触发
纪要生成
vc.note.generated_v1
智能纪要/转录稿生成完成时触发
第三步:配置服务端环境变量
当前运行时通过服务端环境变量读取飞书凭证、Webhook 验签信息和 Base 配置。
FEISHU_APP_ID
飞书应用凭证,用于服务端换取 tenant_access_token
FEISHU_APP_SECRET
飞书应用密钥
FEISHU_WEBHOOK_VERIFICATION_TOKEN
Webhook 验签 token,需与飞书开放平台保持一致
PROJECT_PUBLIC_URL
公网访问域名,用于生成报告链接
FEISHU_BASE_APP_TOKEN
当前运行时使用的多维表格 app_token
FEISHU_MEETING_TABLE_ID
当前运行时使用的会议信息表 table_id
当前状态说明
当前请先在飞书后台完成应用配置,再由运维或开发在部署环境中写入上述变量。