U-Push上线了提效新工具「消息查询」功能啦！最全最直观展示消息发送链路每一个阶段，帮助开发者们精准排查推送失败的原因，快速定位问题所在并有效解决。

开发者们在做消息推送时，难免会遇到推送失败的情况，例如：

• 所用的device_token和appkey对应关系有误
• device_token和alias没有正确绑定、及时更新，导致无法下发
• 厂商token异常，需要开发者确认divide_token是否与厂商token绑定，确认设备是在线还是离线
• 消息发送量超过厂商限额

面对很多不同类型的问题，都需要开发者们进行排查，才能知道具体是什么原因导致的消息推送失败。U-Push上线的提效新工具「消息查询」功能就可以帮助开发者们精准定位问题从而解决问题。

功能介绍

进入U-Push后台，点击「推送」-「排查工具」-「消息查询」页面，输入Device Token：+ Msgid 点击「查询」，页面会显示消息生命链路、消息信息和设备信息、别名信息，可以直观的查看消息的当前状态。

查询未成功情况说明

输入Device Token：+ Msgid 点击「查询」后，未成功会展示查询失败原因：

1.Device Token与当前appkey不一致

输入的 Device Token对应的appkey是xxxx，而当前应用的appkey是xxxx，请重新输入

2.当前仅支持查询7日内的消息

此消息发送时间是2023-12-13 23:12:19,已超出允许查询的最长时间

3.未查询到消息结果 

没有调用信息

查询成功情况说明

消息信息包括：消息状态、创建时间、发送时间、过期时间、消息类别、消息体、发送方式、消息设备状态、厂商Msgid等信息。

设备信息包括：设备品牌/型号、操作系统、厂商版本、厂商Token、通知栏权限、App版本、U-Push SDK版本和Common版本等信息。

别名信息：当前设备绑定的别名信息。

消息体详情 ：消息的具体内容和样式等相关信息。

注意事项：

1.此功能只支持Android端；
2.未送达的补偿功能暂未上线，后续会针对未下发的厂商通道的消息通过友盟离线通道进行补偿下发，从而提升消息送达率；
3.免费版支持50次/天。

查询情况例举：

1. 在线消息送达

2. 厂商消息送达并点击

新增：

• 厂商通道的具体名称（华为、OPPO、vivo、荣耀、小米）
• 消息发送时厂商的token（可能与当前最新的厂商token不一致）
• 厂商Msgid

用户可以根据以上新增的内容去厂商后台进行相应查询。

3. 厂商无法送达的情况，转为离线发送并点击

透出消息未通过厂商发送消息的具体原因，可以根据提示进行正确的配置

4.厂商发送失败，转为离线发送

透出厂商消息送出失败的具体原因

5.厂商回执失败

透出厂商送出成功但消息未送达的情况，会展示厂商回执的具体失败原因，例如：超量、Token失效

以上就是关于U-Push提效新工具——「消息查询」功能的全部信息啦，快打开U-Push体验吧！