管理消息

消息列表默认展示最近 30 天内创建的 极简推送模板推送 消息相关信息,支持查询最近 30 天的极简推送、模板推送以及批量推送类型的历史消息。您可通过消息列表,定位目标消息,查看其推送详情。

查看消息列表

登录 mPaaS 控制台,选择 App,通过以下步骤,查看消息列表:

  1. 在左侧导航栏中,选择 消息推送,进入 消息推送 页面。
  2. 在右侧页面上,点击 消息列表 标签,进入 消息列表 标签页。

    消息列表

消息默认按创建时间倒序排列,列表中展示的信息包括:

  • 业务方消息 ID:用户自定义或系统自动生成。
  • 推送维度:展示消息的推送维度。
    用户维度:基于用户维度。

    设备维度_Android:基于设备维度,且推送平台为 Android。

    设备维度_iOS:基于设备维度,且推送平台为 iOS。

  • 推送目标 ID:具体的用户 ID 或设备 ID。
  • 推送标题:消息的标题。
  • 消息创建时间:消息创建成功的时间,精确到秒。

查看推送详情

在列表中点击目标消息的 展开 按钮(展开按钮 ),可查看相应消息的推送详情。

包括:

  • 消息 ID:由用户自定义或系统自动生成,为 MPS 对消息的唯一标识,用于唯一标识一条消息。
  • 消息推送状态:显示消息的推送状态。各消息推送状态码及其含义详见 消息推送状态码
  • 消息过期时间:指消息的过期时间,由系统根据消息的创建时间和消息有效期自动计算得到。在消息未推送成功之前(推送状态为 DeviceNotOnlineOrNoResponse/NoBindInfo),目标设备建连或用户发起绑定请求时,MPS 将下发消息。一旦消息过期后,MPS 将不再下发消息。
  • 消息变更时间:消息推送状态变更的时间,精确到秒。

搜索消息

消息列表支持根据 设备标识/用户标识业务方消息 ID 搜索消息,操作方法如下:

  1. 消息列表 页面右上方的搜索框中,输入完整的设备标识/用户标识和业务方消息 ID。
  2. 点击 搜索 按钮(search ),或按回车键,列表中将只显示相应推送目标 ID和业务方消息 ID 的消息。

    说明
    • 仅支持查询最近 30 天内创建的 极简推送模板推送批量推送 类型的消息。
    • 列表中默认不展示批量推送类型的消息,您可通过搜索操作查看。
    • 列表中不展示群发推送类型的消息,且您无法通过搜索操作查看。

消息推送状态码

下面分别对公共的以及各推送通道对应的消息推送状态码进行说明。

公共消息推送状态码

状态码 描述 解释
-1 WaitingForVerify 等待校验。
0 DeviceNotOnlineOrNoResponse 等待设备上线(推送目标设备与移动推送网关长连接断开)或等待发送确认。
1 NoBindInfo 无绑定关系。基于用户标识维度推送消息时,确认推送目标(userId)已绑定设备标识。
2 Acked 使用自建通道推送消息时,表示消息已成功推送至客户端;使用厂商通道推送消息时,表示已成功调用厂商推送网关。
99999999 NONE 未知状态

苹果推送

状态码 描述 解释
2001 PayloadEmpty 消息体为空
2002 PayloadTooLarge 消息体太大
2003 BadTopic 证书的 bundleid 错误
2004 TopicDisallowed 证书的 bundleid 非法
2005 BadMessageId messageId 错误
2006 BadExpirationDate 非法的有效期时间
2007 BadPriority 非法的权重
2008 MissingDeviceToken 缺少设备 token
2009 BadDeviceToken 设备 token 无效、格式错误或不存在。当基于用户维度推送消息,且出现本状态时,您需要检查在绑定时所使用的设备 token 是否正确。建议在绑定完成后,在消息推送控制台上创建极简推送类型的消息进行测试。
在开发环境(控制台配置为开发环境证书)下,需要使用个人开发证书打包 App 进行测试。否则会出现 BadDeviceToken。
2010 DeviceTokenNotForTopic 设备 token 和证书不匹配。
2011 Unregistered token 失效
2013 BadCertificateEnvironment 非法的证书环境
2014 BadCertificate 非法的证书
2023 MissingTopic 未指定 Topic
2024 ConnClosed APNS 连接断开。出现该状态的原因如下:
  • 在控制台上配置的苹果推送证书环境与推送的设备 token 不匹配。
  • 在 App 安装包中打包的证书和在控制台上配置的证书不匹配。
  • 工程中的 BundleId 和 在控制台上配置的 BundleId 不一致。
关于在控制台上配置 iOS 推送证书、证书环境以及 BundleId 的详细操作,参见 iOS 推送证书配置
2025 ConnUnavailable APNS 连接未完成

更多苹果消息推送状态说明,请参见 APNs 推送状态码说明

华为推送

状态码 描述
100 无效未知参数
101 无效的 API_KEY
102 无效的 SESSION_KEY
106 App 或者 Session 没有调用当前服务的权限
107 client 和 secret 需要重新获取(如算法升级等)
109 nsp_ts 偏差过大
110 接口内部异常
111 服务繁忙
80000003 终端不在线
80000004 应用已卸载
80000005 响应超时
80000006 无路由,终端未连接过 Push
80000007 终端在其他大区,不在中国大陆使用 Push
80000008 路由不正确,可能终端切换 Push 服务器
80100000 参数检查,部分参数错误
80100002 不合法的 token 列表
80100003 不合法的 payload
80100004 不合法的超时时间
80300002 无权限下发消息给参数中的 token 列表
80300007 请求中所有的 token 都是非法 token
81000001 内部错误
80300008 认证类错误(请求消息体过大)

小米推送

状态码 描述
10001 系统错误
10002 服务暂停
10003 远程服务错误
10004 IP 限制不能请求该资源
10005 该资源需要 appkey 拥有授权
10008 参数错误
10009 系统繁忙
10012 非法请求
10013 不合法的用户
10014 应用的接口访问权限受限
10017 参数值非法
10018 请求长度超过限制
10022 IP 请求频次超过上限
10023 用户请求频次超过上限
10024 用户请求特殊接口频次超过上限
10026 应用被加入黑名单,不能调用 API
10027 应用的 API 调用太频繁
10029 不合法的设备
21301 认证失败
22000 非法应用
22001 应用不存在
22002 应用已经撤销
22003 更新应用程序失败
22004 缺少应用程序信息
22005 应用程序名字不合法
22006 应用程序 ID 不合法
22007 应用程序 Key 不合法
22008 应用程序 Secret 不合法
22020 应用程序描述信息不合法
22021 用户没有授权给应用程序
22022 应用程序 package name 不合法
22100 应用通知数据格式不合法
22101 太多应用通知消息
22102 发送应用通知消息失败
22103 应用通知 ID 不合法
20301 目标不合法

OPPO 推送

状态码 描述 解释
-1 Service Currently Unavailable 服务不可用,此时请开发者稍后再试。
-2 Service in Flow Control 服务器流量控制。
11 Invalid Auth Token 不合法的 AuthToken。
13 App Call Limited 应用调用次数超限,包含调用频率超限。
14 Invalid App Key 无效的 AppKey 参数。
15 Missing App Key 缺少 AppKey 参数。
16 Invalid Signature 签名校验不通过,无效签名。
17 Missing Signature 签名校验不通过,缺少签名。
28 App Disabled 应用不可用。
29 Missing Auth Token 缺少 Auth Token 参数。
30 Api Permission Denied 该应用没有 API 推送的权限。
10000 Invalid RegistrationId registration_id 格式不正确。

vivo 推送

状态码 描述
10000 权限认证失败
10040 资源已达上限,稍后重试
10050 alias 和 regId 不能都为空
10055 title 不能为空
10056 title 长度不能超过 40 个字符
10058 content 长度不能超过 100 个字符
10066 自定义 key 和 Value 键值对个数不能超过 10 个
10067 自定义 key 和 value 键值对不合法
10070 发送量总量超出限制
10071 超出发送时间允许范围
10072 推送速度过快,请稍后再试
10101 消息内容审核不通过
10102 vivo 服务器端未知异常
10103 推送内容含敏感信息
10110 请配置商业化消息发送频率
10302 regId 不合法,regId 为无效的 regId,regId 可能已经失效
10303 requestId 已存在
10104 请发送正式信息。请检查 content,不要发送测试内容,正式信息发送的 content 里面不能是纯数字、纯英文、纯符号,符号加数字,不能包含“测试”字样、大括号、中括号

FCM 推送

状态码 描述 解释
90000002 nvalidRegistration 目标非法
90000003 NotRegistered 目标未注册
90000004 InvalidPackageName 包名非法
90000007 MessageTooBig 消息体过大
90000009 InvalidTtl 离线存活日期非法
90000011 InternalServerError FCM 服务异常
90000401 Authentication 权限校验失败