将应用发布到微信客服

最近更新时间:2026-04-15 10:29:01

我的收藏
您可以将搭建的智能体发布到微信客服中。发布后,微信客服就可以使用智能体回复用户消息,可将微信客服应用于客服等场景。

使用限制

请确认应用已经发布。
仅标准模式的大模型应用支持在回复微信客服时上传图片,但图片大小不能超过 10 MB(微信限制)。

对接前准备

企业微信已认证企业,需要拥有企业微信认证主体名下已完成备案的域名。
企业微信未认证企业,需要自定义域名,但不能直接使用智能体开发平台的域名。
准备好的域名作为代理服务器,将企业微信请求转发到智能体平台,否则无法完成消息收发功能,如下为 Nginx 代理转发配置示例(需提前安装 Nginx,建议版本1.18+,配置步骤请参考 Nginx 官方文档)。
无论是企业微信已认证企业还是未认证企业,都需要配置 Nginx 。
server {
listen 443; # 为安全起见,要求您的域名为https协议
server_name www.example.com; # 请将server_name替换为您已备案的完整域名
location ~ ^/cgi-bin/ { # 请求企微代理
proxy_pass https://qyapi.weixin.qq.com;
proxy_http_version 1.1;
proxy_set_header Connection "close";
proxy_buffering off;
proxy_read_timeout 600s;
proxy_send_timeout 600s;
}
location ~ ^/online/channel/callback/ {
proxy_pass https://chan.lke.cloud.tencent.com; # 代理到腾讯云智能体平台回调接口
proxy_http_version 1.1;
proxy_set_header Connection "close";
proxy_buffering off;
proxy_read_timeout 600s;
proxy_send_timeout 600s;
}
}

步骤一:获取企业 ID

访问 微信客服后台 > 企业信息 > 获取企业 ID。




步骤二:配置发布渠道

1. 进入智能开发平台发布页面,单击新建发布渠道 > 微信客服。



2. 输入步骤一 中获取的企业 ID,单击确定



3. 填写回调设置,按企业微信要求填写域名,参考上述“对接前准备”中的指引。



4. 将智能体开发平台中微信客服渠道中回调设置服务器地址(URL)TokenEncodingAESKey 信息填入微信客服后台。



说明:
首次对接,在微信客服中填写回调配置后才能获取企业 secret 。
5. 微信客服后台 > 企业信息 > 获取企业 secret。



6. 在智能开发平台中,点击下一步,输入企业 secret 客服账号。






说明:
创建客服账号需在微信客服后台操作。



7. 发布应用时选择微信客服渠道。成功发布后,您可以前往微信客服与智能体对话。




分享二维码

单击服务状态 > 运行渠道 > 分享二维码,可以获取对应的微信客服形象二维码,实现通过微信扫码和大模型对话。




常见问题

智能体发布微信客服后,是否可以暂停使用?

可以。在服务状态中,选择对应的发布渠道单击下线,微信客服即可暂停使用。




用户发送图片消息时,模型不回复?

目前只有标准模式的应用,支持理解图片。

在微信客服后台绑定回调配置,提示“回调域名校验失败”

需要到 企业微信平台 做企业认证,认证后才能使用。