- 版本要求：
- 飞书客户端升级到 7.68+（飞书 → 头像 → 关于飞书 → 检查更新）
- lark-cli 升级到 v1.0.55+：
npm install -g @larksuite/cli@latest
- 会议开启「允许智能体入会」：
- 每场会议由 owner 在 安全设置 里打开该开关。
- 若找不到该选项，先打开「AI 总结」，再返回查看。
- 该开关仅对灰度范围内账号可见。
# 三、接入流程
```
用户本人在飞书会议中
↓
Agent 调用 GetUserActiveMeeting → 拿到 meeting_id
↓
Agent 调用 ListMeetingEvents 拉取会中事件（字幕、聊天等）
↓
Agent 通过飞书 IM 将分析结果发给用户
```
lark-cli 示例：
```bash
# 查询用户当前所在会议
lark-cli vc +meeting-list-active --as user
# 拉取会中事件（首次全量，后续用 page_token 增量）
lark-cli vc +meeting-events --as user --meeting-id GET /open-apis/vc/v1/bots/user_active_meeting
返回用户当前所在的会议列表，每项含 meeting_id、meeting_no、meeting_title。有多个会议时让用户选一个。详情参考 获取用户活跃会议。
## ListMeetingEvents — 获取会议事件
GET /open-apis/vc/v1/bots/events
获取会议中的事件列表，包括参会人加入或离开、发言、聊天、共享等事件。详情参考获取会议事件。
# 五、事件数据结构
通过 ListMeetingEvents 返回的事件，按 activity_event_type 区分类型。
## 字幕 transcript\_received\_items
```json
{
"speaker": { "id": "xxx", "user_type": 1, "user_name": "张三" },
"text": "今天来讨论一下这个方案",
"language": "zh-CN",
"start_time_ms": "1716699012000",
"end_time_ms": "1716699014000",
"sentence_id": "100001"
}
```
user_type 可能为声纹检测类型（100/101/102），需兼容处理。
## 聊天消息 chat\_received\_items
```json
{
"operator": { "id": "xxx", "user_name": "张三" },
"message_id": "om_xxx",
"message_type": 1,
"content": "大家好",
"send_time": "1716699030000"
}
```
message_type：1=文本，2=系统，3=表情，4=加密。
## 参会人进入 participant\_joined\_items
```json
{
"participant": { "id": "xxx", "user_type": 1, "user_role": 1, "user_name": "张三" },
"join_time": "1716699010000"
}
```
## 参会人离开 participant_left_items
```json
{
"participant": { "id": "xxx", "user_name": "张三" },
"leave_reason": 1,
"leave_time": "1716700000000"
}
```
leave_reason：1=主动离会，2=会议结束，3=被踢出。
# 六、排查清单
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 拉事件报无权限 | 用户不在会，或会议未开「允许智能体入会」 | 确认用户在会中且开关已开 |
| meeting_id 用错 | 用了 9 位会议号 | 用 GetUserActiveMeeting 查到的长 ID |
| 拿不到实时字幕 | 旁听模式无推送 | 正常，需轮询调 ListMeetingEvents |