钉钉机器人集成

扫码接入

1. 桌面端「设置 → 助理设置 → 集成（Beta）」→「钉钉机器人集成」→「配置」→「扫码接入」；网页端是「频道 → 新建 → 钉钉 → 扫码接入」。
2. 使用钉钉 App 扫码授权。
3. 钉钉将创建应用，并由云端加密保存 AppKey 和 AppSecret。
4. 卡片状态变为「已连接」后，即可在钉钉中私聊机器人。

扫码页显示其他品牌名称

注册扫码页由钉钉平台提供，页面展示的品牌名称由钉钉侧配置，不影响当前接入流程。确认页面来自钉钉官方授权入口后，可继续授权。

手填凭证与高级选项（仅网页端）

1. 手动配置：在「频道 → 新建」中选择手动填写凭证，输入 App Key（Client ID）和 App Secret（Client Secret）。
2. 高级设置可选填「AI 卡片模板 ID」（形如 xxxx.schema）。配置后，运行中的回复将以钉钉流式卡片呈现。

关联渠道身份

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

停用与解绑

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

常见失败与处置

• 「二维码已过期」：扫码会话有效期为 5 分钟。请选择「重新获取二维码」并再次扫码。
• 「授权失败，请重新获取二维码」：钉钉授权被拒绝，或当前账号没有创建应用的权限。请使用有权限的账号重试。
• 扫码显示成功，但提示凭证不完整：钉钉授权回执缺少 AppKey 或 AppSecret。请重新获取二维码并扫码；如连续失败，稍后再试。
• 卡片显示「失败」，错误是 connect failed：钉钉侧的应用凭证已重置，或应用已下架。请在钉钉开放平台核对后重新扫码接入。

进一步排查

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