消息、移动与外部渠道 / 微信渠道

微信联系人同步与情报

部分验证Web · 已验证代码更新于 2026-10-25

微信联系人身份解析入客户档案,并在对话上下文中注入联系人情报。

功能价值

微信联系人身份解析入客户档案,并在对话上下文中注入联系人情报。

使用方式

同步后联系人自动匹配客户档案;AI 员工对话时自动携带客户背景。

所属模块

消息、移动与外部渠道 / 微信渠道

适用平台

Web · 已验证

已知限制

  • 身份匹配依赖备注名/显示名质量

平台验证状态

本项适用于 1 个平台,逐平台独立判定:平台状态只由该平台的实机验收记录产生,总体状态由平台状态自动汇总,目录与页面都不存放可手写的状态。验收结论仅覆盖记录所列版本、Git SHA 与产物;当前源码或新安装包仍需独立验收。

Web

已验证

验收结果:PASS;通过 3 / 失败 0;产品版本 1.0.0.5;Git SHA 984791d03ac0debbdf867e87635bab6668e94c18;验证时间 2026-09-29。Acceptance JSON SHA-256 8c5ba84674450cdcd09be08be076c978d56c452e565b712fbfb4ce43d70e34bb

实机录像 / 操作流程

媒体内容已复核,记录结论:验收结果:通过;画面内容:本轮真实浏览器会话录像(webm,14.16s,ffmpeg 实测):管理员登录 → 联系人同步+读回 → 无令牌 401 → 单联系人子路径 404。;SHA-256:b6dbc91870e784b37ed444c3e3dcfbbb4c87555c877a48f145b8d1fd18958ccf(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/ch-wechat-contacts/video/ch-wechat-contacts-web-20260929-191024.webm) 下载原始录像

实机截图

微信联系人同步与情报 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:管理端登录页「XCMAX 服务器后台 · 管理员登录」,账号框已填 admin、密码框为掩码。;SHA-256:1dc3a403a66c85eba0dc49b11fc0c7cb435430dfd3e30068dff8c0ada88b9bd3(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/ch-wechat-contacts/shot/00-login-form.png) 查看原图
微信联系人同步与情报 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:卡片显示核心闭环通过:POST /api/ops/wechat/ingest(Bearer 令牌,同步联系人)→ {status:200,body:{success:true,contacts_upserted:1,messages_inserted:0}};GET /api/ops/wechat/contacts → {status:200,count:1,hit:{id:2,contact_key:vc-accept-contact,display_name:VC验收客户,wxid:vc_wxid_1,customer_id:null,match_status:unlinked}}。;SHA-256:2957ceab833b5e98f3d8ea8784277d3f0a56028d18ab3e338df833c0e8af5c44(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/ch-wechat-contacts/shot/C1-contacts-core.png) 查看原图
微信联系人同步与情报 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:卡片显示两处真实响应:GET /api/ops/wechat/contacts(无令牌)→ {status:401,body:{success:false,error_code:http_401,message:invalid wechat sync token}};GET /api/ops/wechat/contacts/probe-contact(Bearer)→ {success:false,message:资源不存在:/api/ops/wechat/contacts/probe-contact}(404)。;SHA-256:e1ad8151345ca865917371dd87f0c32f928ba052bca0aa5a7a63212ce484634f(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/ch-wechat-contacts/shot/C2-contacts-boundary.png) 查看原图

运行日志

下载原件:ch-wechat-contacts-web-20260929-191024.log;SHA-256:58e4e08b117d38a5ab0d1ed15d9c71d513201d043f72a5281af5e7e7d63264b4(仓库路径:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/ch-wechat-contacts/log/ch-wechat-contacts-web-20260929-191024.log)

安装包 / 部署产物 SHA-256:cfa52148ab19fd69e6bea715cc2b9ad046f9607dbdee31033cb9d5357d3c7368 · 交付身份 JSON

实现与测试(平台无关)

源码实现

  • FHD/app/application/wechat_ingest_service.py
  • FHD/app/application/wechat_chat_context.py
  • FHD/app/db/models/wechat_sync.py

自动化测试

暂无

CI 门禁:待补本项 CI 证据

CI 工作流定义

暂无

未标注平台的补充资料

下列资料未绑定到具体平台,仅作实现与历史资料参考,不计入任何平台状态,也不构成实机验收。

实机截图

微信联系人同步与情报 已复核截图
记录结论:资料收录(未绑定平台验收);SHA-256:15648480c143359349180ec066fb286b65bafde1eb1266a37ce4c1d2aaa17f6d(原始文件:FHD/docs/evidence/capabilities/ch-wechat-contacts-02-message-db-adapter.png) 查看原图

证据原件存放于私有对象存储,页面通过短时效签名地址读取原图与原始录像; 「核验哈希」会对照本页登记的 SHA-256 与存储对象元数据。对象存储不可用时自动改用站内副本, 也可下载原件后用 sha256sum 自行核对。