docs: 补充 type=13 新获客线索推送样本与字段说明。
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@ -3,8 +3,8 @@
|
||||
## 1. 文档说明
|
||||
|
||||
- 本文整理后端经极光推送发送到 Android 和 iOS 的通知消息格式。
|
||||
- 当前内容基于 2026-07-22 的 Android、iOS 实际收包日志、两端客户端现有解析逻辑,以及后端开发人员提供的 `PushMsg` 类型定义。
|
||||
- 后端当前定义了 `1`~`12`、`100`、`999` 共 14 个业务消息类型;目前已取得 `type = 1`(付款成功)、`type = 2`(退款成功)和 `type = 6`(扫码成功)的完整收包样本。
|
||||
- 当前内容基于截至 2026-07-23 的 Android、iOS 实际收包日志、两端客户端现有解析逻辑,以及后端开发人员提供的 `PushMsg` 类型定义。
|
||||
- 后端当前定义了 `1`~`13`、`100`、`999` 共 15 个业务消息类型;目前已取得 `type = 1`(付款成功)、`type = 2`(退款成功)、`type = 6`(扫码成功)和 `type = 13`(新获客线索)的收包样本。
|
||||
- 本文描述的是推送协议,不是普通 HTTP 接口响应格式。
|
||||
|
||||
## 2. 统一业务结构
|
||||
@ -211,6 +211,31 @@ iOS 通过 APNs/极光收到 `userInfo` 字典。与 Android 相比:
|
||||
}
|
||||
```
|
||||
|
||||
### 4.4 新获客线索 payload
|
||||
|
||||
```json
|
||||
{
|
||||
"_j_business": 1,
|
||||
"_j_data": "{\"data_msgtype\":1,\"push_type\":8,\"is_vip\":0}",
|
||||
"_j_msgid": 18103323696468714,
|
||||
"_j_uid": 86399144805,
|
||||
"aps": {
|
||||
"alert": {
|
||||
"body": "获客员哦啦啦提交了一条新线索,请及时查看并跟进",
|
||||
"title": "新获客线索通知"
|
||||
},
|
||||
"sound": "default"
|
||||
},
|
||||
"data": {
|
||||
"lead_id": 75,
|
||||
"sale_user_id": 6,
|
||||
"saler_name": "哦啦啦"
|
||||
},
|
||||
"msg_id": 1869,
|
||||
"type": 13
|
||||
}
|
||||
```
|
||||
|
||||
## 5. Android 与 iOS 字段对应关系
|
||||
|
||||
| 语义 | Android | iOS | 是否用于业务 |
|
||||
@ -253,6 +278,7 @@ iOS 通过 APNs/极光收到 `userInfo` 字典。与 Android 相比:
|
||||
| `10` | 修图完成通知 | — | 暂无 |
|
||||
| `11` | 跟拍签到通知 | — | 暂无 |
|
||||
| `12` | 剪辑师新任务通知 | 类型名称映射中漏配 | 暂无 |
|
||||
| `13` | 新获客线索通知 | 获客员提交新线索 | iOS 已取得,Android 暂无 |
|
||||
| `100` | 用户登出通知 | 账号在其他设备登录 | 暂无 |
|
||||
| `999` | 系统消息 | 当前未使用 | 暂无 |
|
||||
|
||||
@ -349,6 +375,38 @@ iOS 通过 APNs/极光收到 `userInfo` 字典。与 Android 相比:
|
||||
}
|
||||
```
|
||||
|
||||
### 6.5 `type = 13`:新获客线索
|
||||
|
||||
| 项目 | 当前值 |
|
||||
| --- | --- |
|
||||
| 标题示例 | `新获客线索通知` |
|
||||
| 正文示例 | `获客员哦啦啦提交了一条新线索,请及时查看并跟进` |
|
||||
| 客户端点击行为 | Android、iOS 均进入消息中心 |
|
||||
|
||||
`data` 字段:
|
||||
|
||||
| 字段 | 类型 | 当前样本 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `lead_id` | int | `75` | 新增获客线索的唯一 ID。 |
|
||||
| `sale_user_id` | int | `6` | 提交线索的获客员 ID。 |
|
||||
| `saler_name` | string | `"哦啦啦"` | 获客员名称,与通知正文中的名称一致。 |
|
||||
|
||||
示例:
|
||||
|
||||
```json
|
||||
{
|
||||
"type": 13,
|
||||
"msg_id": 1869,
|
||||
"data": {
|
||||
"lead_id": 75,
|
||||
"sale_user_id": 6,
|
||||
"saler_name": "哦啦啦"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
> 当前点击路由只根据 `type` 判断,`type = 13` 属于默认分支,因此进入消息中心;`data` 中的线索字段不会改变跳转页面。
|
||||
|
||||
## 7. 客户端解析约定
|
||||
|
||||
1. Android、iOS 的通知点击路由只根据业务字段 `type` 判断,不读取标题、正文、`data`、`route`、`uri`、`action` 或极光内部字段决定页面。
|
||||
@ -414,7 +472,7 @@ iOS 业务字段示例:
|
||||
| 项目 | 当前观察 | 需要确认 |
|
||||
| --- | --- | --- |
|
||||
| `msg_id` | 与极光消息 ID 不同 | 是否对应消息中心记录 ID,以及是否用于已读/送达状态上报 |
|
||||
| `data` | `type = 1`、`2`、`6` 的样本中都存在;`type = 2` 为 `{}` | 所有业务推送是否保证存在;无业务字段时是否统一返回 `{}` |
|
||||
| `data` | `type = 1`、`2`、`6`、`13` 的样本中都存在;`type = 2` 为 `{}` | 所有业务推送是否保证存在;无业务字段时是否统一返回 `{}` |
|
||||
| 退款成功的 `data` | 当前为空对象,订单号和退款金额只在正文中 | 是否补充 `order_number`、`refund_amount`、`refund_time`、`order_type` 等结构化字段 |
|
||||
| 其他类型的 `data` | 后端已定义消息名称,但尚未提供 payload | 分别确认 `type = 3`~`5`、`7`~`12`、`100`、`999` 的字段结构、必填项及点击行为 |
|
||||
| `pay_time` | 当前为秒级时间戳 | 后端是否统一保证使用 Unix 秒,且时区语义固定为 UTC 时间戳 |
|
||||
|
||||
Reference in New Issue
Block a user