跳到主要内容

企业微信集成

Xpert AI 多智能体平台已支持企业微信集成功能。通过本集成,企业用户可直接在企业微信中调用数字专家的智能对话能力,包括使用 ChatBI 工具集进行数据分析,并以截图形式返回分析结果。

本教程将一步步指导您完成企业微信集成配置。


第一步:创建企业微信应用并获取必要信息

  1. 登录 企业微信管理后台,进入“应用管理”

  2. 点击“自建应用”,创建一个新的应用,填写应用名称、logo、简介等信息。

  3. 创建成功后,记录以下信息:

    • AgentId
    • Secret
  4. 继续在该应用的设置页面中,启用并打开接收消息功能,设置 Token 和 EncodingAESKey,平台会返回如下信息:

    • Token
    • EncodingAESKey
  5. 最后,前往“我的企业”页面,获取企业唯一标识:

    • 企业ID(CorpID)

✅ 至此,你已经获得了以下五项重要信息:

  • 企业ID(CorpID)
  • AgentId
  • Secret
  • Token
  • EncodingAESKey

第二步:配置数字专家与企业微信集成

  1. 登录 Xpert AI 平台,前往“数字专家”模块,创建一个新的数字专家智能体。

  2. 在配置工具集时,若该智能体用于数据分析,请选择工具集类型为 “与企业微信对话 BI”,以启用 ChatBI 分析能力。

  3. 完成智能体配置后,点击“发布版本”,并在发布到第三方平台步骤中添加“企业微信”发布渠道。

  4. 填写刚才在企业微信管理后台中获取的五项信息:

    • 企业ID(CorpID)
    • AgentId
    • Secret
    • Token
    • EncodingAESKey
  5. 保存配置后,系统将生成一个回调地址(Callback URL)。


第三步:将回调地址填入企业微信以完成验证

  1. 返回企业微信管理后台,打开该应用的“接收消息”设置。
  2. 将 Xpert AI 提供的 Callback URL 填入 “接收消息服务器地址” 字段中。
  3. 点击保存,平台会自动发起验证请求。
  4. 若配置无误,即可看到验证成功提示。

🎉 恭喜你,数字专家智能体已成功接入企业微信!


第四步:在企业微信中对话数字专家

现在,企业微信的用户就可以:

  • 直接与 Xpert AI 智能体对话
  • 使用 ChatBI 进行 BI 数据分析
  • 收到以截图形式返回的分析图表和结论

常见问题(FAQ)

在将 Xpert AI 数字专家集成到企业微信的过程中,您可能会遇到一些常见问题,以下是问题汇总与对应的解决建议:

1. 配置完成后,发送消息给企业微信应用没有任何回应

可能原因及解决方法:

  • 应用未开启“接收消息”功能
    👉 请在企业微信管理后台,确保“接收消息”功能已启用。

  • 回调地址未正确填写或验证未通过
    👉 请确认 Callback URL 填写无误,且平台验证成功。

  • AgentId 填错或 Secret 配置错误
    👉 检查在 Xpert AI 平台中填写的 AgentId 和 Secret 是否与企业微信一致。


2. ChatBI 分析请求失败,或收不到截图返回

可能原因及解决方法:

  • 智能体未启用“与企业微信对话 BI”工具集 👉 请检查智能体工具集中是否正确选择了“与企业微信对话 BI”。

  • 分析结果生成失败或截图服务异常
    👉 请联系平台管理员,查看日志是否存在异常。


3. 企业微信提示“URL验证失败”

可能原因及解决方法:

  • Token 或 EncodingAESKey 填写错误
    👉 请与企业微信设置页面中的内容严格一致。

  • 回调地址无法从公网访问
    👉 请确保服务器部署在公网可访问的地址,且端口放通。

  • 企业微信服务器请求被防火墙或代理拦截
    👉 检查是否有安全组、WAF 等拦截企业微信的请求。


4. 企业微信应用用户无法看到该应用或入口

可能原因及解决方法:

  • 应用可见范围未设置
    👉 请到企业微信应用设置中,添加用户、部门等,使其有权限访问该应用。

如需进一步了解 ChatBI 功能或企业定制化需求,欢迎联系我们的产品支持团队!