企业微信集成
Xpert AI 多智能体平台已支持企业微信集成功能。通过本集成,企业用户可直接在企业微信中调用数字专家的智能对话能力,包括使用 ChatBI 工具集进行数据分析,并以截图形式返回分析结果。
本教程将一步步指导您完成企业微信集成配置。
第一步:创建企业微信应用并获取必要信息
登录 企业微信管理后台,进入“应用管理”。
点击“自建应用”,创建一个新的应用,填写应用名称、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 是否与企业微信一致。
2. ChatBI 分析请求失败,或收不到截图返回
可能原因及解决方法:
智能体未启用“与企业微信对话 BI”工具集 👉 请检查智能体工具集中是否正确选择了“与企业微信对话 BI”。
分析结果生成失败或截图服务异常
👉 请联系平台管理员,查看日志是否存在异常。
3. 企业微信提示“URL验证失败”
可能原因及解决方法:
Token 或 EncodingAESKey 填写错误
👉 请与企业微信设置页面中的内容严格一致。回调地址无法从公网访问
👉 请确保服务器部署在公网可访问的地址,且端口放通。企业微信服务器请求被防火墙或代理拦截
👉 检查是否有安全组、WAF 等拦截企业微信的请求。
4. 企业微信应用用户无法看到该应用或入口
可能原因及解决方法:
- 应用可见范围未设置
👉 请到企业微信应用设置中,添加用户、部门等,使其有权限访问该应用。
如需进一步了解 ChatBI 功能或企业定制化需求,欢迎联系我们的产品支持团队!