第一步：创建企业微信应用并获取必要信息
- 登录 企业微信管理后台，进入**“应用管理”**。
- 点击“自建应用”，创建一个新的应用，填写应用名称、logo、简介等信息。
-
创建成功后，记录以下信息：
- AgentId
- Secret
-
继续在该应用的设置页面中，启用并打开接收消息功能，设置 Token 和 EncodingAESKey，平台会返回如下信息：
- Token
- EncodingAESKey
-
最后，前往“我的企业”页面，获取企业唯一标识：
- 企业ID（CorpID）
- 企业ID（CorpID）
- AgentId
- Secret
- Token
- EncodingAESKey
第二步：配置数字专家与企业微信集成
- 登录 Xpert AI 平台，前往“数字专家”模块，创建一个新的数字专家智能体。
- 在配置工具集时，若该智能体用于数据分析，请选择工具集类型为 “与企业微信对话 BI”，以启用 ChatBI 分析能力。
- 完成智能体配置后，点击“发布版本”，并在发布到第三方平台步骤中添加“企业微信”发布渠道。
-
填写刚才在企业微信管理后台中获取的五项信息：
- 企业ID（CorpID）
- AgentId
- Secret
- Token
- EncodingAESKey
- 保存配置后，系统将生成一个回调地址（Callback URL）。
第三步：将回调地址填入企业微信以完成验证
- 返回企业微信管理后台，打开该应用的“接收消息”设置。
- 将 Xpert AI 提供的 Callback URL 填入 “接收消息服务器地址” 字段中。
- 点击保存，平台会自动发起验证请求。
- 若配置无误，即可看到验证成功提示。
第四步：在企业微信中对话数字专家
现在，企业微信的用户就可以：- 直接与 Xpert AI 智能体对话
- 使用 ChatBI 进行 BI 数据分析
- 收到以截图形式返回的分析图表和结论
常见问题（FAQ）
在将 Xpert AI 数字专家集成到企业微信的过程中，您可能会遇到一些常见问题，以下是问题汇总与对应的解决建议：1. 配置完成后，发送消息给企业微信应用没有任何回应
可能原因及解决方法：-
应用未开启“接收消息”功能
👉 请在企业微信管理后台，确保“接收消息”功能已启用。 -
回调地址未正确填写或验证未通过
👉 请确认 Callback URL 填写无误，且平台验证成功。 -
AgentId 填错或 Secret 配置错误
👉 检查在 Xpert AI 平台中填写的 AgentId 和 Secret 是否与企业微信一致。 - 企业微信应用的企业可信IP 👉 检查企业可信IP是否配置了服务器出口 IP （XpertAI 在线系统的 IP 可以联系我们的技术人员获取）
2. ChatBI 分析请求失败，或收不到截图返回
可能原因及解决方法：- 智能体未启用“与企业微信对话 BI”工具集 👉 请检查智能体工具集中是否正确选择了“与企业微信对话 BI”。
-
分析结果生成失败或截图服务异常
👉 请联系平台管理员，查看日志是否存在异常。
3. 企业微信提示“URL验证失败”
可能原因及解决方法：-
Token 或 EncodingAESKey 填写错误
👉 请与企业微信设置页面中的内容严格一致。 -
回调地址无法从公网访问
👉 请确保服务器部署在公网可访问的地址，且端口放通。 -
企业微信服务器请求被防火墙或代理拦截
👉 检查是否有安全组、WAF 等拦截企业微信的请求。
4. 企业微信应用用户无法看到该应用或入口
可能原因及解决方法：- 应用可见范围未设置
👉 请到企业微信应用设置中，添加用户、部门等，使其有权限访问该应用。
如需进一步了解 ChatBI 功能或企业定制化需求，欢迎联系我们的产品支持团队！