跳转到主要内容

​
第一步：确认权限

在飞书开放平台 → 你的应用 → 权限管理中,确保已开通以下权限:
权限标识说明
im:chat:readonly获取群列表
im:message:readonly读取历史消息
im:message.receive_v1接收新消息事件（需在事件订阅中配置）

​
第二步：配置事件订阅

在飞书开放平台 → 事件与回调 → 事件订阅中:
  1. 设置请求地址为 Edge Function 的 Webhook URL
  2. 添加事件：im.message.receive_v1（接收消息 v2.0）
  3. 保存后,飞书会发送 challenge 验证,系统自动通过

​
第三步：使用看板

  1. 点击「加载群列表」获取机器人所在的群
  2. 选择目标群,点击「同步历史」拉取已有消息
  3. 新消息会通过事件订阅实时出现在看板上

​
常见问题

确认机器人已被添加到目标群中,且已开启 im:message:readonly 权限并发布版本.
图片和文件消息只存储了类型标记,实际内容需要通过飞书 API 下载.当前版本展示摘要信息.
每次拉取最多 50 条（飞书 API 限制）,支持分页.看板中消息按时间倒序展示最近 200 条.

​
附录：Agent 权限与安全配置参考

​
Agent 权限配置

scopenametype
im:chat:readonly获取群列表tenant
im:message:readonly读取历史消息tenant
im:message.receive_v1接收新消息事件（需在事件订阅中配置）tenant
permissions： 
[
  { "scope": "im:chat:readonly", "name": "获取群列表", "type": "tenant" },
  { "scope": "im:message:readonly", "name": "读取历史消息", "type": "tenant" },
  { "scope": "im:message.receive_v1", "name": "接收新消息事件（需在事件订阅中配置）", "type": "tenant" }
]
batch_import_json： 
{
  "scopes": {
    "tenant": ["im:chat:readonly", "im:message:readonly", "im:message.receive_v1"],
    "user": []
  }
}