本文将介绍如何完成华为离线推送服务厂商配置。
前提条件
开始前,请确认您已具备以下条件:
条件 | 说明 |
华为开发者账号 | 用于登录华为开发者联盟和 AppGallery Connect。 |
Android App 包名 | 华为推送服务不要求应用先上架应用市场,应用包名必须与 Android 工程的 applicationId 保持一致。 |
打包证书及 SHA256 指纹 | 需提前准备实际打包签名证书,并获取对应 SHA256 指纹;后续将在华为 AppGallery Connect 中配置。 |
腾讯云账号和即时通信 IM 应用权限 | 用于在腾讯云控制台添加华为厂商证书。 |
后续 Android 工程接入权限 | 用于在 SDK 接入 阶段集成 TIMPush 和华为推送依赖。 |
华为 AppGallery Connect 配置
提示:
注册华为开发者账号
创建应用
1. 在 华为管理中心 的应用服务中,单击 AppGallery Connect,进入应用管理中心。

2. 单击我的项目,添加一个新的项目。

3. 在项目设置栏单击推送服务 > 立即开通。

4. 单击项目设置 > API 管理,开启推送服务的权限。

添加应用
单击项目设置 > 常规,添加应用。
注意:
应用包名与 Android 工程的
applicationId 需要保持一致。
获取应用信息
单击项目设置 > 常规,获取应用信息。常规页面包含项目和应用的 Client ID 和 Client Secret,两者对应的参数不一致,请下拉至页面底部,获取应用的 Client ID 和 Client Secret。
警告:

腾讯云控制台配置
添加华为厂商证书
登录腾讯云 即时通信 IM 控制台,在推送服务 Push > 推送设置 > 厂商配置中添加华为厂商证书,并按控制台要求填写厂商参数。Client ID 对应 AppID,Client Secret 对应 AppSecret。"应用内指定界面"请使用控制台默认配置。
厂商推送平台 | 腾讯云即时通信 IM 控制台 |
![]() | ![]() |
配置回执和点击统计
如需统计消息触达或点击数据,请配置回执,回调地址填写:
https://api.im.qcloud.com/v3/offline_push_report/huawei。
注意:
华为推送证书 ID <= 11344 时,使用华为推送 v2 版本接口,不支持触达和点击回执,请重新生成更新证书 ID 。
消息分类限制对推送效果的影响
华为会将通知消息分为服务与通讯类和资讯营销类。消息分类会影响单设备每日接收数量、夜间展示和推送策略,IM 聊天消息建议按华为规则申请并使用服务与通讯类能力。具体限制请以华为官方 消息限制说明 和 消息分类说明 为准。
消息类型 | 推送影响 | 适用建议 |
服务与通讯类 | 官方说明中该类消息不设数量限制,适合及时触达。 | 适用于聊天、交易、订单、账号变更等用户需要及时知道的消息。 |
资讯营销类 | 按应用类型设每日推送上限;0:00 - 6:00 期间可能被缓存,待管控解除后再尝试下发。 | 适用于活动、资讯、推广等非即时消息。 |
警告:
如果消息分类与实际内容不符,可能导致消息被厂商降级、限频或影响通道权限。营销、广告类消息不建议配置为服务与通讯类。
配置消息分类时,可在华为侧申请自分类权益。完成华为平台和腾讯云控制台配置后,后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置华为
Category。具体的 SDK API 使用方式请参见 Android SDK 接入文档中的 配置消息分类(可选)。配置完成检查
完成本篇配置后,请按顺序检查:
检查项 | 预期结果 |
包名一致性 | 华为应用包名与 Android 工程 applicationId 完全一致。 |
SHA256 指纹 | 华为平台已添加与实际打包证书一致的 SHA256 证书指纹。 |
推送服务状态 | 华为推送服务已开通,推送服务 API 权限已开启。 |
应用参数 | 已记录目标 Android 应用的 Client ID 和 Client Secret。 |
腾讯云厂商证书 | 已在腾讯云控制台添加华为证书,并按映射填写 AppID 和 AppSecret。 |
回执和点击统计 | 如需统计,已按消息触达统计配置完成回执相关配置。 |
消息分类配置 | 如需 IM 消息及时触达,已申请并配置服务与通讯类消息分类,并在 API 或腾讯云控制台默认 Category 中完成配置。 |

