私信与群聊

为用户提供私聊、群聊及消息实时收发；红包、转账等增值能力依赖支付模块。

WebSocket 连不上（一直连接中、/ws 403、仅 H5 失败）请阅 WebSocket 连接排查（含 CORS 须写 https:// Origin、Nginx Upgrade、CDN 等）。

用户之间的私聊、群聊与实时消息；红包、转账等增值能力依赖支付。与「官方机器人」「通知与推送」「机器人推送」是不同通道——本文只讲用户互聊与后台监管。

用户体系 → 群聊私信私信与群聊

• 站点 Redis 与 WebSocket 服务正常
• 即时通讯相关模块已在「我的模块」中开通
• 红包/转账需支付配置完成（见支付与提现）

建议顺序

1. 1
   确认区域开关区域管理 → 区域列表 → 编辑区域，开启私信/群聊
2. 2
   客户端互测两测试账号互发私聊、建群发消息
3. 3
   后台监管用户体系 → 群聊私信，按会话查违规内容

与官方机器人 / 通知 / 机器人推送的区别

用户说「收不到消息」要先分清：是私聊发不出、通知中心没有、还是外部机器人没收到事件。

群聊私信（本文）用户 ↔ 用户：私聊、群聊、红包/转账；后台在「群聊私信」监管会话

官方机器人用户 ↔ 平台助手：站内私信会话，可 AI 回复；菜单「用户体系 → 官方机器人」

通知与推送业务事件 → 用户通知中心 / 微信模板 / Push；菜单「通知控制台」

机器人推送（对外事件流）业务事件 → 你的服务器脚本/Webhook；不是发给用户的聊天

会话监管（后台操作）

1. 1
   打开列表用户体系 → 群聊私信，按用户 UID、时间筛选
2. 2
   进入会话点击会话查看消息记录，排查违规、诈骗、引流
3. 3
   联动处理必要时在用户管理禁言/拉黑，或在平台举报处理

区域级开关

区域管理 → 区域列表 → 编辑区域私信/群聊开关：关闭后本区域用户无法使用普通私信与群聊

与官方机器人区域私信关闭时，用户仍可与已启用的官方机器人私聊（见 bot-notify）

红包与转账

• 客户端是否展示红包/转账：由「我的模块」授权控制
• 开通后仍须系统配置 → 微信支付/支付宝已配置
• 资金变动在财务管理 → 余额流水、资金交易核对

WebSocket 与「发不出消息」

若用户普遍「消息发不出、一直连接中」，请运维检查反向代理 Upgrade 头、CORS 白名单是否包含 HTTPS Origin；详见运维文档 WebSocket 连接排查。

• 系统监控 → 系统状态：查看 Redis、WebSocket 是否在线
• 票据 200 但 GET /ws 403：多为 config.yaml 的 cors.allowed_origins 只有 http:// 未写 https://
• 连接地址为 GET /ws?ticket=...（非 /api/message/ws）
• 仅 H5 失败、小程序正常：多为 Nginx 未配置 proxy_set_header Upgrade

验证是否生效

• 目标区域私信/群聊开关已开启
• 两测试账号互发私聊，双方实时收到
• 创建群聊并拉入成员，群消息同步正常
• （可选）小额聊天转账或群红包，余额流水与资金交易有记录

常见问题

全员无法收发私聊Redis/WebSocket 是否在线；Nginx Upgrade 头；CORS 是否含 https Origin（见 /ops/websocket）；是否全站区域私信被关。

仅某区域不可用区域列表私信开关；用户是否被禁言/拉黑。

红包/转账按钮不存在我的模块是否含能力；支付是否已配置。

和官方机器人有什么区别私聊是用户互聊；官方机器人是平台在消息 Tab 里的助手账号，配置在用户体系 → 官方机器人。

用户说没收到订单通知那是通知与推送或官方机器人，不是群聊私信；见 notification / bot-notify。

相关文档

官方机器人WebSocket 连接排查支付与提现通知与推送机器人推送（对外事件流）