企微助理集成

注册一个企业微信智能机器人,让你和同事在企业微信里直接和助理对话。

两种接入方式

长连接(智能机器人):扫码即可,平台自动建机器人并回填凭证,桌面端只做这一种。HTTP 回调(自建应用):需要你在企业微信管理后台自建应用、手填五项凭证,只能在网页端「频道」页配置。

扫码接入(推荐)

  1. 1先确认你手机上的企业微信是「企业管理员账号」——普通成员扫不出结果。
  2. 2桌面端「设置 → 助理设置 → 集成(Beta)」→「企微助理集成」→「配置」→「扫码接入」;网页端则是「频道 → 新建 → 企业微信 → 长连接 → 扫码接入」。
  3. 3用企业微信扫码授权。企业微信会自动创建一个智能机器人,并把 Bot ID 与 Secret 交给云端加密保存,你一个字都不用填。
  4. 4卡片徽章变「已连接」后,在企业微信里私聊这个机器人即可。

手填凭证 / 回调模式(仅网页端)

  1. 1长连接手填:在「频道 → 新建」里把凭证方式切成手填,填 Bot ID 与 Bot Secret。
  2. 2回调模式:先去企业微信管理后台自建应用,取 corp_id、corp_secret、AgentId、Token、EncodingAESKey(必须 43 位)。
  3. 3创建后卡片上会出现一行「回调 URL」,把它复制到企业微信后台的「接收消息」配置里保存——保存时企业微信会来做一次验证握手。

关联你的渠道身份

如果该渠道开了「严格身份模式」,陌生触点的私聊不会为你建会话,只会回一句提示。在网页端「频道 → 我的渠道身份 → 生成关联口令」拿到形如 LK-XXXXXX 的口令,10 分钟内私聊发给机器人即可完成关联(发「link LK-XXXXXX」也认)。同时最多持有 3 个未使用的口令;群里发口令不生效,必须私聊。

停用与解绑

  1. 1临时不想收消息:在网页端「频道」页把这条应用停用,卡片会显示「已停用」,随时可再启用。
  2. 2彻底不用了:桌面卡片「配置 → 解绑」或网页端删除该应用,云端保存的凭证会一并删除,本机不留副本。
  3. 3解绑后需要重新扫码才能恢复;凭证任何时候都不会回传到你的电脑上。

常见失败与处置

扫码后没反应 / 扫码页打不开
企业微信的扫码建机器人接口是它管理后台的非公开接口,偶发不可用。退回网页端手填 Bot ID + Secret 一样能用,不影响已经接好的渠道。
提示「EncodingAESKey 必须为 43 位字符」
从企业微信后台复制时带了空格或少了字符。它固定 43 位,重新复制一次。
企业微信后台保存回调 URL 时提示验证失败
Token 或 EncodingAESKey 与你在「频道」里填的不一致,验签不过(我方会回 403)。两边对齐后重试。
回调模式的卡片一直不显示「已连接」
回调模式没有长连接,状态本来就不会变成「已连接」——它是被动等企业微信推消息过来。想确认通不通,用卡片上的「连通性测试」。
卡片显示「失败」,错误是 connect failed
机器人凭证在企业微信侧被删除或重置了。重新扫码接入一次。

还是没解决?

在「频道」页用卡片上的「连通性测试」看一眼云端此刻能不能连上; 如果错误信息仍然读不懂,把卡片上那行错误原文一起发给我们。

BidUltra · 投标 AI Agent 平台