收不到推送，如何排查？
现象：设备收不到离线推送或在线推送。
原因：可能是插件接入异常、推送链路异常，或厂商通道存在特殊限制。
补充说明：离线推送依赖厂商能力，一些简单的字符可能会被厂商过滤而无法透传，建议使用有意义的内容进行推送。各厂商平台的特殊限制（如 OPPO 消息分类、小米或 vivo 上架要求、iOS 证书环境等），请参见对应平台分节。
控制台测试推送成功，但 IM 消息离线收不到，如何处理？
现象：在控制台接入测试时能收到推送，但两个账号互发 IM 消息，接收方 App 在后台或被强制停止后收不到通知。
原因：接入测试成功，不代表 IM 消息满足离线推送的条件。IM 消息的离线推送，还取决于发送端是否传入推送信息、接收方是否完成绑定，以及套餐能力。
处理：按以下顺序逐项确认：
1. 确认当前套餐支持 IM 聊天消息通知能力，请以 计费说明 为准。
2. 确认测试时接收方 App 已置于后台或已杀进程。
3. 确认发送端调用
sendMessage 时传入了有效的 V2TIMOfflinePushInfo（title 和 desc 至少一个不为空，disablePush 为 false）。自定义消息必须设置 desc。4. 确认接收方曾 IM 登录并完成
registerPush，设备 Token 已绑定该 UserID。用户退出 IM 登录后绑定失效，需要重新登录并再次调用 registerPush。5. 在 推送记录 中找到这条推送，用排查工具查看推送全链路状态，再按 收不到在线、离线推送排查流程 处理。
自定义消息为什么收不到离线推送？
现象：发送自定义消息后，对方收不到离线推送。
原因：自定义消息的离线推送和普通消息不同：TIMPush 无法解析自定义消息的内容并确定推送文案，所以默认不推送。
处理：如果您有推送需求，需要在
sendMessage 时设置 offlinePushInfo 的 desc 字段，推送时会默认展示 desc 信息：Android：调用 sendMessage 时设置 V2TIMOfflinePushInfo 的
desc 字段。iOS：调用 sendMessage 时设置 V2TIMOfflinePushInfo 的
desc 字段。推送只能收到几条，之后就收不到了？
现象：测试时只能收到几条推送，之后就收不到了。
原因：通常是消息被厂商默认归类为营销类，受每日下发条数限制。厂商推送均有消息分类机制，不同类型对应不同的推送策略。
补充说明：
每个厂商的消息分类不同，某些需先申请开通，某些厂商申请之后有一定的生效时间。
消息分类字段：通常可在控制台证书页面填写默认值，例如
category。REST API 和客户端接口也提供了对应字段或方法，可覆盖控制台默认值，实现多种消息分类。各厂商官方对未分类消息的限制举例：
小米：未接入消息分类的应用走默认通道，单个应用单个设备单日仅可收到 1 条，详见 小米推送消息限制说明。
华为：未申请自分类权益，或请求中的
category 与权益不一致的消息，会归为资讯营销类，受单个应用每日每设备 2 条或 5 条的限制；服务与通讯类消息不限量，详见 华为推送数量管理细则。另外，向某个设备上的某个应用每天发送的消息不超过 3000 条，超过后会被限流 24 小时，详见 华为推送服务 FAQ。魅族：未接入消息分类的消息默认按公信消息管控；应用不在公信限制的应用类别中时，单个应用每日每设备默认 3 条，私信消息不限量，详见 魅族推送消息限制说明。
海外推送如何配置？
海外离线推送支持的厂商通道：FCM、华为、OPPO 和 APNs。
FCM 通道必备条件：设备可以访问海外网站、设备安装支持 GMS 服务、成功集成 TIMPush。
国内设备大多没有安装 GMS 服务，无法支持 FCM 推送。
控制台提示 RegistrationID 或 UserID 不存在，如何处理？
现象：控制台提示 RegistrationID 或 UserID 不存在，或批量导入用户后无法推送。
原因：推送是设备级能力：只有真机完成 IM 登录并成功注册 TIMPush 后，设备 Token 才会上报并绑定到对应 UserID 或 RegistrationID。通过 REST API 批量导入 IM 用户只会在后台创建用户记录，不会创建设备记录，直接对这类 UserID 推送会提示不存在。
处理：正确的注册链路为：IM
login 成功 → 调用 setRegistrationID（入参为业务要绑定的 IM UserID）→ 调用 registerPush → getRegistrationID 返回非空 → 控制台测试推送。请区分 RegistrationID、厂商 Token 和设备 ID，控制台测试时需选择与 ID 类型匹配的查询方式。
如果已经误用设备 ID 完成注册，需先注销清理旧绑定，再使用正确 UserID 重新注册。
新增厂商证书时提示数量已达上限，如何处理？
现象：新增厂商证书失败，提示证书数量已达上限（如 cert limit exceeded）。
原因：各套餐版本对可添加的厂商证书数量有上限，属于产品能力边界，不是接入配置错误。
补充说明：多 App 场景建议评估拆分 SDKAppID 或调整证书规划。如果只是替换证书，建议在控制台直接编辑更新原证书，不要删除重建。重建后证书 ID 或
businessID 会变化，已发布的旧包需要发版更新配置。角标不显示或不清零，如何处理？
现象：角标不显示、打开 App 后不清零，或不同厂商表现不一致。
原因：数字角标、红点、图片角标各厂商支持情况不同，一般是因为未携带正确角标参数，或厂商系统本身不支持该能力。
处理：先确认目标平台或厂商是否支持对应角标能力，再按平台核对参数：
iOS：推送时需携带 APNs badge 字段；打开 App 后角标清零需要客户端调用系统 API 实现。
Android：不同厂商的角标策略不同（部分厂商跟随通知栏、部分需单独申请权益），以各厂商规则为准。
服务端推送时检查是否携带正确的角标参数（如 BadgeMode、BadgeAddNum）。
厂商系统本身不支持的角标能力属于产品边界，无法通过配置绕过。
不接入 IM 聊天能力，只使用推送服务可以吗？
未使用 IM 用户体系时，推送目标使用设备 RegistrationID，客户端
registerPush 成功后通过 getRegistrationID 获取，服务端或控制台按 RegistrationID 推送。如需按 UserID 推送，必须先完成 IM 登录与注册绑定链路，参见 Chat 与 Push 混用说明。
即时通信 Chat 是否自带离线推送？还需要开通 Push 吗？
需要。IM 聊天消息的离线推送（App 在后台或进程退出后，在系统通知栏提醒）通过推送服务 Push 实现，接入前需要开通 Push 服务、完成厂商配置，并集成 TIMPush。
只在 App 内收发聊天消息、不需要离线通知栏提醒时，可以只使用 IM。
IM 聊天消息通知能力取决于 Push 套餐，请以 计费说明 为准。
即时通信 Chat 和推送服务 Push 的 SDKAppID 和密钥有什么区别？
同时使用 Chat 和 Push 时，两个服务的 SDKAppID 相同，但密钥不同，请勿混用：
Chat 的密钥仅用于 IM 登录，不能作为
registerPush 的 appKey。调用 Push 的
registerPush 时使用 Push 的客户端密钥（Push Key），在腾讯云控制台 > 即时通信 IM > 推送服务 Push > 概览 中获取。推送服务（Push）和自行集成有什么区别？
接入方法 | 集成方式对比 | 功能对比 |
插件快速集成： 不再需要逐个厂商填写配置，控制台下载引入 json 配置文件，即可完成所有手机厂商的推送信息配置。 支持按需集成一个或者多个对应厂商的推送渠道包，更加满足合规要求。 无需自行处理推送注册、Token 上报、前后台状态上报等，接入后插件自动完成相关流程。 不再需要关注和添加打点和上报逻辑，开启功能后插件自行上报和汇总，支持链路排查和指标统计等。 插件封装界面跳转、图标自定义等方法，直接使用即可。 | 普通消息推送。 全员标签推送。 自定义界面跳转。 推送自定义样式。 设备推送状态查询。 全链路排查工具。 推送记录和指标统计分析。 | |
需要自行集成多个厂商推送 SDK，接入成本高。 需要自行构建多端逻辑。 自建通道维护成本高，同时极易引起消息堵塞、延迟高，触达效率低。 消息接收失败、发送失败等各类问题需自行排查并解决。 收集用户隐私数据不当会导致 App 下架，严重影响业务。 | 仅支持普通消息推送。 |
推送总量和 QPS 有限制吗？
需要区分两层限制：腾讯云侧的接口 QPS 限制，与各厂商通道的每日推送额度 / 消息分类限额，二者相互独立。
腾讯云侧 QPS 与套餐能力相关，具体配额以控制台和套餐说明为准。
厂商侧日限额与消息分类相关，参见 消息分类汇总文档；「只能收到几条」类问题参见 推送只能收到几条，之后就收不到了。
触达统计是否有延迟？
Android 的触达统计为厂商返回，因此 Android 的触达时间取决于厂商，不受 IM 控制。
iOS 的触达统计为客户端上报，因此 iOS 的触达上报有延迟，下次客户端登录时才会上报。
如何关闭离线推送消息的接收？
推送插件费用到期会怎样？
上架时如何满足隐私合规要求？
