配置微信客服
快速配置让云开发 AI 对接微信客服,实现智能客服功能。
前置条件
步骤 1:获取企业 ID
进入 微信客服平台,复制「企业 ID」。

步骤 2:获取 Token 和 EncodingAESKey
进入微信客服后台「开发配置」模块,点击「开始使用」

点击「随机获取」,生成 Token 和 EncodingAESKey

⚠️ 注意:此时先不要点「完成」,需要先完成下一步获取回调 URL。
步骤 3:授权微信客服
进入云开发 AI 控制台,选择「Agent」模块
在「接入指引」中找到「微信平台」,选择「微信客服」
点击「立即授权」,填入上一步获取的 Token 和 EncodingAESKey,点击「下一步」
系统会生成回调 URL,复制该地址

回到微信客服后台,将回调 URL 填入,点击「完成」

回到云开发 AI 控制台,点击「下一步」,填入 Secret 和客服名称

点击「完成」,授权配置完成
📝 说明:只有填入的客服账号名称对应的客服才会被 AI 托管。
步骤 4:开发
完成授权后,需要对 Agent 进行改造以支持微信平台消息格式。根据你的 Agent 类型选择对应的开发文档:
agent-前缀的 Agent:请参考 微信平台适配器开发文档ibot-前缀的 Agent:请参考 ibot-前缀的Agent接入微信回调消息
步骤 5:测试
完成开发部署后,即可测试智能客服功能:
进入微信客服后台「开始接入」模块

滑到下方选择「在微信外 App/网页中接入」

选择对应客服,点击「生成二维码」进行测试

扫码进入客服对话,发送消息测试

注意事项
配置完成后,不要在微信客服后台的「客服服务」中修改配置,否则会覆盖当前设置。

如果不慎覆盖了配置,可以在 微信客服后台 重新打开客服服务:

优化建议
提升回复速度
在 Agent 提示词中添加以下设定,可显著提升回复速度:
- 智能体以极简风格回应问题
- 简化复杂问题的回答,提炼核心信息
- 严格限制回复内容的长度和相关性,避免冗余
- 不要输出 Markdown 格式,直接输出纯文本
⚠️ 注意:更改提示词后,历史对话记录可能会影响模型的输出效果。
模型选择
- 推荐:混元模型、DeepSeek V3(响应速度快)
- 不推荐:DeepSeek R1 等深度思考模型(响应时间较慢)
更好的体验
如需更丰富的对话体验(如 Markdown 渲染、多轮对话展示),可考虑在网页或 App 中嵌入自定义的 AI 对话页面。