飞书集成

两种接入方式

长连接（WebSocket）：扫码后由平台创建应用并回填凭证，支持在群聊中识别 @ 机器人；桌面端仅支持此方式。HTTP 回调：须在飞书开放平台创建应用、填写凭证并配置事件订阅地址，仅支持在网页端「频道」页配置。

扫码接入（推荐）

1. 桌面端「设置 → 助理设置 → 集成（Beta）」→「飞书集成」→「配置」→「扫码接入」；网页端是「频道 → 新建 → 飞书 → 长连接（WebSocket，推荐）→ 扫码接入」。
2. 使用飞书 App 扫码授权；当前不支持 Lark 国际版账号。
3. 飞书将创建应用，并由云端加密保存 App ID 和 App Secret。
4. 卡片状态变为「已连接」后，即可在飞书中私聊机器人；在群聊中默认需要 @ 机器人才能收到回复。

回调模式（仅网页端）

1. 在飞书开放平台创建应用，获取 App ID（以 cli_ 开头）、App Secret、Encrypt Key 和 Verification Token。
2. 进入「频道 → 新建 → 飞书 → HTTP 回调」，填写四项凭证并创建。
3. 将卡片上的「回调 URL」填入飞书开放平台的「事件订阅 → 请求地址」并保存，飞书会验证该地址。

关联渠道身份

启用「严格身份模式」后，未关联身份的私聊不会创建会话，仅返回关联提示。在网页端选择「频道 → 我的渠道身份 → 生成关联口令」，获取形如 LK-XXXXXX 的口令。在 10 分钟内私聊机器人并发送口令，或发送「link LK-XXXXXX」，即可完成关联。每个账号最多同时持有 3 个未使用口令；群聊发送口令无效。

停用与解绑

1. 临时停用：在网页端「频道」页停用对应应用。卡片显示「已停用」后，可随时重新启用。
2. 永久解绑：在桌面端卡片选择「配置 → 解绑」，或在网页端删除该应用。云端保存的凭证将一并删除，本机不保留副本。
3. 解绑后须重新扫码接入。渠道凭证不会回传至本机。

常见失败与处置

• 用 Lark（国际版）账号扫码直接失败：当前仅支持 open.feishu.cn 的飞书租户，不支持 Lark 租户。请使用飞书账号接入。
• 在扫码授权页选择「拒绝」后提示授权失败：请重新获取二维码并扫码，在授权页选择同意。二维码有效期为 5 分钟。
• 飞书后台事件订阅地址校验失败，或消息接入后无回复：Encrypt Key 或 Verification Token 填写错误时，接口会返回 401（签名不符、Token 不符或解密失败）。凭证不支持在线修改，请在「频道」页删除并重新创建应用。
• 回调模式下群聊 @ 机器人无回复：回调模式无法获取机器人自身身份，在群聊中仅能识别「@所有人」。如需通过 @ 机器人触发回复，请改用长连接，或关闭群策略中的「需要 @ 才回复」。
• 卡片显示「失败」，错误是 connect failed：应用可能已停用或凭证已重置。请在飞书开放平台核对应用状态，必要时重新扫码接入。

进一步排查

可在「频道」页使用渠道卡片的「连通性测试」检查连接状态。 如仍无法解决，请联系支持并提供卡片显示的错误原文。