IM 集成用于把当前空间中的 CuppyClaw 机器人连接到即时通讯平台。当前配置入口面向飞书自建应用。 路径：空间设置 → IM 集成Documentation Index
Fetch the complete documentation index at: https://help.teable.ai/llms.txt
Use this file to discover all available pages before exploring further.
该设置是空间级配置。不同空间可以使用不同的飞书自建应用凭证。
一、 创建飞书自建应用
- 打开 飞书开放平台
- 创建企业自建应用
- 在应用能力中启用 机器人
二、 填写应用凭证
在飞书应用的 凭证与基础信息 页面获取：- App ID
- App Secret
三、 导入权限范围
在飞书应用的 权限管理 中，使用 批量导入/导出权限 导入页面中提供的 Scopes JSON。 这些权限用于让机器人处理所在会话中发给机器人的消息、访问必要的会话信息，并以机器人身份发送回复。导入后请按飞书页面要求提交或保存权限变更。四、 配置事件订阅
在飞书应用的 事件与回调 → 事件配置 中配置事件订阅：- 订阅方式选择 将事件发送至开发者服务器，不要选择长连接。
- 将请求地址设置为 Teable 页面中显示的 Webhook URL。格式通常是：
- 添加事件：
五、 发布应用并设置可用范围
在飞书应用的 版本管理与发布 中创建新版本并发布应用。 发布时请确认 可用范围 设置为 全员，这样空间成员才能搜索并添加机器人。六、 测试连接
回到 Teable 的 IM 集成 页面，点击 测试连接。 测试通过后，将机器人添加到飞书群组，并在群内验证 CuppyClaw 是否能收到消息和响应。七、 常见排查
- 测试连接失败：先确认 App ID 和 App Secret 是否来自同一个飞书应用。
- 群里无法使用机器人：确认应用已发布，并且可用范围包含当前成员。
- 机器人收不到消息：检查事件订阅方式是否为 将事件发送至开发者服务器，以及是否添加了
im.message.receive_v1事件。 - 更换应用密钥：在 IM 集成页面重新填写 App Secret 并保存。