1012 Finder 私信新消息

notify_type: 1012

分类：Finder 私信

触发场景：收到 Finder 私信。

1012 的消息主体位于 data.message。用户名属于 Finder 私信体系，消息方向以 is_sender 为准。普通好友/群消息使用 1010/1011，字段结构请分别处理。

data 外层字段

字段	类型	说明
`msg_session_id`	string	私信会话 ID。
`seq`	string	私信会话消息序号。
`is_sender`	boolean	是否由当前账号发送。
`item_type`	integer	消息来源类型，通常为 `1`；客户一般无需处理。
`sub_type`	integer	私信扩展类型，暂无公开枚举。
`sync_key_type`	integer	来源标识，由服务自动处理。
`ext_info`	string	扩展数据的 Base64 值，暂无公开结构。
`message`	object	消息主体，字段见下表。

data.message 字段

字段	类型	说明
`from_username`	string	Finder 私信发送方用户名。
`to_username`	string	Finder 私信接收方用户名。
`create_time`	integer	消息创建时间，Unix 秒级时间戳。
`desc`	string	服务端推送摘要。
`msg_id`	string	64 位服务端消息 ID。
`legacy_msg_id`	integer	旧式 32 位消息 ID。
`msg_seq`	integer	消息序列号。
`msg_type`	integer	消息类型，例如 `1` 文本、`3` 图片、`34` 语音。
`status`	integer	消息状态。
`img_status`	integer	图片或媒体状态。
`img_buf`	string	媒体/缩略图缓冲区的 Base64 值。
`source`	string	消息来源扩展信息。
`content`	string	文本、XML 或业务消息内容。

JSON 示例

{
  "guid": "client-guid",
  "notify_type": 1012,
  "data": {
    "msg_session_id": "session_xxxxx@findermsg",
    "seq": "18",
    "is_sender": false,
    "item_type": 1,
    "sub_type": 0,
    "sync_key_type": 9,
    "ext_info": "",
    "message": {
      "from_username": "finder_sender@findermsgstranger",
      "to_username": "finder_receiver@finder",
      "create_time": 1785413990,
      "desc": "你好",
      "msg_id": "7350012345678901234",
      "legacy_msg_id": 0,
      "msg_seq": 0,
      "msg_type": 1,
      "status": 0,
      "img_status": 0,
      "img_buf": "",
      "source": "",
      "content": "你好"
    }
  }
}

建议处理

使用 msg_session_id 作为私信会话标识，使用 message.msg_id 做消息去重。

使用 message.msg_type 选择文本、图片、语音等业务解析器；未知类型保留原始字段。

不要把 message.from_username 当作普通微信 wxid，也不要按 @chatroom 拆分内容。

二进制字段先 Base64 解码，再按对应媒体或业务格式处理。

开启私信自动接收的步骤见 Finder 私信同步。

data 外层字段#

data.message 字段#

JSON 示例#

建议处理#

data 外层字段

data.message 字段

JSON 示例

建议处理