华为

最近更新时间:2026-05-29 17:12:01

我的收藏
本文将介绍如何完成华为离线推送服务厂商配置。

前提条件

开始前,请确认您已具备以下条件:
条件
说明
华为开发者账号
用于登录华为开发者联盟和 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。
警告:
必须添加打包的 SHA256 证书指纹,SHA256 证书指纹需与自己的打包证书一致,否则可能导致无法正常接收离线推送消息


腾讯云控制台配置

添加华为厂商证书

登录腾讯云 即时通信 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 中完成配置。
下一步请前往 Android SDK 接入,集成 TIMPush。