Only the Chinese version of this page is provided currently. The English version will be provided soon.

将应用发布到微信客服

Last updated: 2026-03-18 10:23: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. 单击下一步,从 微信客服后台 > 企业信息 > 获取企业 secret。



在智能开发平台发布页面,填写企业 secret。



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



注意:
仅需指定一个客服形象,单击保存即可。
4. 将智能体开发平台中微信客服渠道详情中配置的服务器地址(URL)、Token、EncodingAESKey 信息填入微信客服后台。



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




分享二维码

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




常见问题

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

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




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

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

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

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