微信客服
将 通千算智 接入微信客服（WeChat Customer Service）
通过把企业微信自建应用绑定到「微信客服」账号，通千算智 可以接管来自外部微信用户的客服咨询，并可在小程序、公众号、视频号及视频号小店等场景中通过链接或二维码触达微信用户。
微信客服只能使用 Docker 部署或服务器 Python 部署，需要公网可达的回调地址，不支持本地运行模式。
一、准备
需要的资源：
- 一台服务器（有公网 IP）
- 注册并已认证的企业微信
- 已开通「微信客服」能力
建议单独再创建一个企微自建应用用于微信客服，不要复用已有的 wechatcom_app 应用，否则两个通道会争抢同一个回调地址。
二、创建企业微信自建应用
- 在 企业微信管理后台，点击 应用管理 → 创建应用：
- 点击 我的企业，在最下方获取 企业ID（后续填写到
wechat_kf_corp_id）：
- 进入上一步创建的应用，点击 Secret 旁的「查看」，Secret 会推送到管理员手机端的企业微信里查看：
- 进入应用 接收消息 → 设置API接收，点击右侧「随机获取」生成 Token 和 EncodingAESKey 并保存：
此时保存 API 接收配置会失败，因为程序还未启动，等项目运行后再回来保存。
三、配置和运行
填入上一步收集到的 4 个字段（Corp ID / Secret / Token / EncodingAESKey）：
接入完成后启动程序（Web 控制台方式会自动重启），日志中出现 Listening on http://0.0.0.0:9888/wxkf/ 表示运行成功，需要将该端口对外开放（如在云服务器安全组中放行）。
接着回到企业微信「接收消息 → 设置API接收」，将回调 URL 填为 http://<your-host>:9888/wxkf/，点击保存。保存成功后还需将服务器 IP 添加到 企业可信IP 中，否则无法收发消息：
如遇到 URL 配置回调不通过或配置失败： 1. 确保服务器防火墙关闭且安全组放行监听端口（默认 9888） 2. 仔细检查 Token、Secret、EncodingAESKey 等参数配置是否一致，URL 格式是否正确 3. 认证企业微信需要配置与主体一致的备案域名
四、绑定微信客服账号
进入企业微信管理后台 微信客服 页面，创建客服账号并与上一步的企微自建应用绑定：
绑定完成后，进入 微信客服 → 微信客服账号详情，在「接入链接」一栏：
- 点击「复制链接」可获得形如
https://work.weixin.qq.com/kfid/kfcd83e5896b9ba07be的访问链接 - 点击「生成二维码」可获得对应的二维码
把链接或二维码推给微信客户使用即可：
五、使用
微信用户通过链接或二维码进入客服对话后，即可与 AI 进行多轮对话，支持文本、图片、语音等消息：
除此之外，基于微信生态官方能力，还可将微信客服应用在公众号、小程序、视频号及视频号小店等场景，详情可查看企业微信管理后台 微信客服 → 接入场景 的相关说明：
常见问题
需要确保已安装以下依赖：
pip install websocket-client pycryptodome