钉钉机器人集成
注册一个钉钉机器人，在钉钉里和助理对话。只有长连接一种接入方式，扫码即可完成。
扫码接入
- 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
应用凭证在钉钉侧被重置或应用被下架了。到钉钉开放平台确认后重新扫码接入。
还是没解决？
在「频道」页用卡片上的「连通性测试」看一眼云端此刻能不能连上； 如果错误信息仍然读不懂，把卡片上那行错误原文一起发给我们。