修茈科技 LogoXCAGI企业业务自动化平台
消息、移动与外部渠道 / 微信渠道

微信消息接入

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

本机采集端把微信消息安全接入平台，幂等去重入库，作为客户沟通情报的唯一入口。

返回 消息、移动与外部渠道

功能价值

本机采集端把微信消息安全接入平台，幂等去重入库，作为客户沟通情报的唯一入口。

使用方式

部署采集端后自动同步；消息先归档存证，再按意图过滤进入业务流。

所属模块

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

适用平台

Web · 已验证

已知限制

  • 仅用于企业自身合规留存的会话数据

平台验证状态

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

Web

已验证

验收结果：PASS；通过 4 / 失败 0；产品版本 1.0.0.5；Git SHA 984791d03ac0debbdf867e87635bab6668e94c18；验证时间 2026-09-29。Acceptance JSON SHA-256 a1fad514604ae5813ff15bcfcbb99b45d3d830854868d77dbb67c383579bdac8

实机录像 / 操作流程

媒体内容已复核，记录结论：验收结果：通过；画面内容：本轮真实浏览器会话录像（webm，18.92s，ffmpeg 实测）：管理员登录 → 心跳鉴权 200 → 真实上行入库+读回闭环 → 无令牌 401 → 缺 CSRF 403。；SHA-256：ee546e160b896d8e816f1dcc5736cb56a0dc1370510a07a915c72b8997843cb0（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/ch-wechat-ingest/video/ch-wechat-ingest-web-20260929-191000.webm） 下载原始录像

实机截图

微信消息接入 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：管理端登录页「XCMAX 服务器后台 · 管理员登录」，账号框已填 admin、密码框为掩码。；SHA-256：4787ba44290c6c205f4a73ff77f2f4e727589a04be9181fa5e869741c3de699a（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/ch-wechat-ingest/shot/00-login-form.png） 查看原图
微信消息接入 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：卡片汇总三处真实响应：POST /api/ops/wechat/ingest 空心跳（Authorization: Bearer 令牌）→ {status:200,body:{success:true,contacts_upserted:0,messages_inserted:0,messages_skipped:0,context:{}}}；POST 无令牌 → {success:false,error_code:http_401,message:invalid wechat sync token,path:/api/ops/wechat/ingest}；POST 无 CSRF 头 → {success:false,message:CSRF token missing}。；SHA-256：5dd0f4fc6039a4e7792f7c024067800cba5eff394f046f75b4f56b624235d598（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/ch-wechat-ingest/shot/I1-ingest-auth.png） 查看原图
微信消息接入 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：卡片显示核心闭环通过：POST /api/ops/wechat/ingest（Bearer 令牌，真实联系人+消息）→ {status:200,body:{success:true,contacts_upserted:1,messages_inserted:1,messages_skipped:0}}；GET /api/ops/wechat/contacts → {status:200,hit:true,count:1}；GET /api/ops/wechat/context → {status:200,known:true,message_count:1,recent_messages:[{role:other,content:"VC验收消息：你好，这是真机上行 #9070114",source:api}]}。；SHA-256：92ba8aa9ce2501db8c4dda5db05c64941ab03ec93db266034201f814888db457（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/ch-wechat-ingest/shot/I2-ingest-core.png） 查看原图

运行日志

下载原件：ch-wechat-ingest-web-20260929-191000.log；SHA-256：38226f2483b2f40bd4ca14cf46d66b994b97c946785db98d8e22cf2462481618（仓库路径：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/ch-wechat-ingest/log/ch-wechat-ingest-web-20260929-191000.log）

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

实现与测试（平台无关）

源码实现

  • FHD/app/fastapi_routes/wechat_ingest.py

API 端点

  • POST /api/ops/wechat/ingest

自动化测试

  • FHD/tests/routes/test_wechat_ingest.py

CI 门禁：FHD/.github/workflows/ci-cd.yml

CI 工作流定义

  • FHD/.github/workflows/ci-cd.yml

未标注平台的补充资料

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

实机截图

微信消息接入 已复核截图
记录结论：资料收录（未绑定平台验收）；SHA-256：15648480c143359349180ec066fb286b65bafde1eb1266a37ce4c1d2aaa17f6d（原始文件：FHD/docs/evidence/capabilities/ch-wechat-ingest-01-data-sources.png） 查看原图

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