跳到主要内容

对接企业微信

概述

将企业微信智能机器人与 DecideX 智能体关联后，成员可在企业微信中向机器人提问，由对应的智能体处理并返回回答。

本文采用企业微信智能机器人的「API 模式」，通过「使用 URL 回调」接入。配置顺序为：准备机器人及凭证 → 在 DecideX 添加频道并获取回调地址 → 返回企业微信保存回调配置 → 绑定账号并验证。

前提条件

  • 已创建并发布需要接入的 DecideX 智能体，当前账号有权编辑该智能体及配置渠道入口。
  • 具备企业微信智能机器人的创建与管理权限。
  • 回调地址可供企业微信访问，并满足企业微信页面要求的可信域名、IP 或域名备案条件。
  • 使用机器人的成员同时在企业微信机器人的可使用范围和 DecideX 智能体的发布授权范围内。

创建企业微信智能机器人

  1. 进入企业微信管理后台，在「安全与管理 > 管理工具」中点击「智能机器人」，在此页面点击「创建机器人」。

    进入企业微信智能机器人管理

    创建企业微信智能机器人

  2. 设置头像、名称和简介，选择「API 模式」。名称可按业务场景填写，例如「经销商经营分析助手」。记录页面中的「Bot ID」，后续填写到 DecideX 的「aibotid」。

  3. 在「API 配置」中选择「使用 URL 回调」，分别点击「Token」和「Encoding-AESKey」旁的「随机获取」，记录生成的值。先保留此页面，完成下一节的 DecideX 配置后，再回填「URL」。

    选择 URL 回调并生成凭证

说明

本流程使用 URL 回调的「Token」和「Encoding-AESKey」，无需填写长连接方式下的「Secret」。

在 DecideX 配置企业微信入口

  1. 在 DecideX 的「智能体」列表中找到目标智能体，进入配置页，选择「发布与集成 > 渠道入口」。在「聊天平台」区域点击添加按钮，选择「企业微信」。

    添加企业微信频道

  2. 填写机器人信息，并勾选「已启用」。各字段对应关系如下。

    DecideX 字段填写内容与用途
    aibotid企业微信智能机器人的 Bot ID，用于识别接入的机器人
    Token企业微信 URL 回调配置中的 Token，用于校验回调签名
    EncodingAESKey企业微信 URL 回调配置中的 Encoding-AESKey，长度为 43 位，用于解密回调消息
    企业微信回调地址添加频道后由系统生成，复制到企业微信的 URL 字段；每个机器人入口使用独立地址

    填写企业微信机器人凭证

  3. 点击「添加频道」。添加完成后，打开该企业微信入口，复制系统生成的「企业微信回调地址」。如修改了入口配置，点击「保存」。

    获取企业微信回调地址

回填 URL 并设置使用范围

  1. 返回企业微信机器人配置页，将 DecideX 生成的「企业微信回调地址」粘贴到「URL」。确认「Token」和「Encoding-AESKey」与 DecideX 中填写的值一致。

  2. 如需向团队成员开放，在「使用方式」中选择「多人使用」，点击「可使用成员」旁的「修改」，设置成员范围。

  3. 点击「保存」，完成机器人配置。如页面提示回调校验失败，按下方 常见问题 检查地址和凭证。

    填写回调地址并设置可使用成员

说明

企业微信的「可使用成员」决定哪些成员能够使用该机器人；DecideX 的「发布授权」决定绑定账号后能否调用对应智能体。向团队开放时，两处都需要配置。

在企业微信客户端使用与验证

  1. 回到 DecideX 的「渠道入口」，确认企业微信入口显示「已启用」。

    企业微信渠道入口已启用

  2. 按 [在企业微信中使用智能体](../../04-消费者使用指南/04-在企业 IM 中使用.md#ask-in-wecom) 打开机器人，完成账号绑定，再发送一个智能体可回答的问题。

  3. 确认机器人返回回答，并可通过回复中的「在 DecideX 中查看完整会话」打开会话记录。

入口显示「已启用」表示该入口允许接收消息；仍需实际提问，确认企业微信回调、账号绑定和智能体调用均正常。

常见问题

保存时提示 URL 或回调校验失败

  • 确认选择的是「使用 URL 回调」，并完整复制当前机器人入口生成的回调地址。
  • 确认 DecideX 中已添加对应频道并勾选「已启用」。
  • 核对两侧的「Token」和「EncodingAESKey」，避免多余空格或复制不完整；如重新生成凭证，需要同步更新两侧配置。
  • 若提示域名不符合要求，请企业微信管理员检查智能机器人管理页面中的「API 模式可信域名」，按页面要求完成配置。

找不到机器人或机器人没有回复

  • 确认企业微信机器人已保存，且「可使用成员」包含当前成员。
  • 确认 DecideX 入口已启用，「aibotid」与该机器人的「Bot ID」一致。
  • 确认企业微信的「URL」使用当前入口生成的地址，回调配置校验通过。
  • 若机器人返回绑定提示，先完成账号绑定，再重新发送问题。

绑定后仍无权限，或无法返回业务数据

  • 确认绑定的是正确的 DecideX 账号，且该账号已获得智能体的发布授权。
  • 确认智能体已配置相应的 BI 数据、连接或参考资料，并已发布相关配置。
  • 确认当前用户拥有相关数据的访问权限，提问内容在智能体的能力范围内。

机器人接入成功仅代表消息链路已打通；业务数据分析能力取决于智能体配置及用户权限。