消息计数、存储与推送策略

融云在「消息类型概述」中为每种消息类型定义了三个默认属性：是否计入会话未读、是否进入客户端本地存储与离线缓存、是否默认触发远程推送。本页给出完整矩阵，并说明本项目服务端的实际策略与差异。

融云默认策略矩阵（28 行）​

补充口径（融云默认值）：聊天室与超级群不支持离线缓存；Web 与小程序不支持客户端消息存储；通知类与状态类默认不推送；通知类若在发送时显式设置推送标题与内容，仍可触发推送。

本项目的计数与存储​

• 未读由服务端在消息落库时对每个接收者 +1；发送者自己的其他端不计未读。@ 消息额外累计 mentionedCount。
• 撤回不新增消息：服务端把原消息内容替换为 recall 占位，因此不会额外 +1 未读。
• 聊天室消息只在在线连接间广播，不落库、不补发；因此聊天室消息离线后不可恢复。
• 系统通知只允许服务端发往系统会话；当前不会触发离线推送 webhook。

本项目的离线与历史​

推送策略与差异​

离线消息 webhook 的触发与载荷​

当消息的接收者没有任何在线 WS 会话时，服务端会异步 POST 到应用配置的 webhook；超时 3 秒、失败只记日志、不阻塞投递、不做重试与签名。

{
  "appkey": "demo",
  "userId": "u2",
  "reason": "offline",
  "message": {
    "messageId": "m_9f2a",
    "conversationType": 1,
    "targetId": "u2",
    "senderId": "u1",
    "seq": 42,
    "timestamp": 1750000000000,
    "direction": 2,
    "content": {
      "type": "text",
      "text": "你好"
    }
  }
}

配置入口是 Admin API POST /api/admin/apps/{appkey}/push（webhookUrl + enabled），不属于 Open API；完整接入步骤见 推送接入。

另外，push.send 可以按 all|tag|package|user|users 发送“不落地通知”，但它同样只是把载荷投递到同一个 webhook，并不是 APNs/FCM 通道。

推送内容与透传规则​

与融云的差异清单​

• 封闭类型 vs objectName：本项目 ContentType 固定 8 值，新增消息类型必须改 IDL 与各端 SDK；融云可通过 objectName + 内容体扩展。
• 无按类型抑制计数：融云通知/状态/信令类有不同计数策略；本项目统一计数（撤回除外）。
• 撤回模型不同：本项目原地替换为 recall，融云生成 RC:RcNtf 通知消息与 RC:RcCmd 命令。
• 无远程推送通道：只有 webhook；没有 token 注册、厂商适配、点击跳转、角标、多语言模板。
• 无客户端消息存储策略差异：各端 SDK 自行决定本地库，服务端不区分类型。
• 超级群：本项目按普通群持久化，没有频道级计数/推送/历史隔离。

相关页面​

• 消息类型总览
• 逐类型参考
• 推送总览
• 推送接入
• 限频、配额与容量限制

融云原文（证据）：/platform-chat-api/message-about/about-message-types