微信客服接入

本项目使用「企业内部开发 + 自建应用内部授权管理客服账号」模式，复用自建应用 Token/AESKey，无需单独配置客服回调参数。后台绑定可管理客服账号后，此处可自检授权状态并查看可管理客服账号。

重要：下方「可管理客服账号」列表来自 API，表示应用有权限管理的账号数量；只有已在企微后台为该客服账号配置了「事件接收服务器」（填写下方回调 URL）的账号，才会把客户发来的消息推送到本系统。若列表显示 2 个账号但后台只配置了 1 个账号的回调，则只有那 1 个账号的会话会出现在「最近会话」和「外部会话」中。

客服回调 URL

请在企业微信管理后台「微信客服」中，对需要由本系统接收消息的客服账号，在「事件接收服务器」里填写下方客服回调 URL（需在 Nginx 中配置 /dev/wecom/kf/callback 转发到 Gateway）。未配置此 URL 的客服账号不会向本系统推送任何消息。

注意：必须填「客服回调」地址（路径含 /wecom/kf/callback），不要填成自建应用回调（/wecom/callback），否则客户发来的消息会因加密不一致导致解密失败（Invalid padding）。

回调诊断

最近收到客服事件时间：从未收到

若一直显示「从未收到」，请按下面顺序排查：

1. 企微后台：确认要在本系统接消息的客服账号已在「微信客服 → 事件接收服务器」里配置，URL 填上方回调 URL，Token/EncodingAESKey 与自建应用一致（或与 Gateway 环境变量 WECOM_TOKEN / WECOM_ENCODING_AES_KEY 一致）。
2. 客户发消息的入口：确认客户是通过已配置回调的那一个客服账号发起会话（例如从该账号的客服链接/小程序进入）。另一个未配置回调的账号不会推送消息到本系统。
3. Nginx：确认站点已配置 location ^~ /dev/wecom/kf/callback 并转发到 Gateway 端口（默认 18080），且已重载 Nginx。
4. Gateway 日志：在服务器上查看 Gateway 容器日志，搜索 kf_callback 或 wecom_kf。若能看到 kf_callback POST received 说明请求已到 Gateway；若出现 signature invalid 说明 Token/AESKey 与企微后台不一致；若完全没有 POST 日志，说明请求未到 Gateway（检查 Nginx 或企微是否未推送）。

授权状态

状态: already use in wecom, hint: [1770490318445411051315307], from ip: 43.165.195.151, more info at https://open.work.weixin.qq.com/devtool/query?e=95011

already use in wecom, hint: [1770490318445411051315307], from ip: 43.165.195.151, more info at https://open.work.weixin.qq.com/devtool/query?e=95011

测试发送

输入 open_kfid、external_userid 和文本，点击发送后查看成功/失败码。

最近会话

暂无客服会话记录。事件落库后此处展示最近会话。