# 消息推送使用指南
# 一、使用前须知
App 消息推送是统一管理向 App 用户推送消息的服务,此消息推送功能是基于腾讯云即时通讯IM的移动推送服务实现,开发者需前往腾讯云使用「推送服务」,并创建对应的产品、应用以及完成相关配置后方可使用。为方便开发者更好地理解整体逻辑,需认真阅读本章节的内容:
- 首先,前往腾讯云使用即时通讯 - 推送服务,创建腾讯即时通讯应用以及完成相关配置,以获得对应 APPKEY 和 APPID 等信息
- 然后,在开发者工具中配置启用消息推送功能,并按照开发指南进行使用
- 最后,消息推送服务的相关管理功能也在腾讯云控制台进行操作
# 1、关于合规指南
根据监管部门要求,使用 SDK 时必须在《隐私政策》中告知终端用户 SDK 使用用途,并且在终端用户未同意《隐私政策》前不得初始化任何 SDK。请确保你开发或运营的应用有符合监管要求的《隐私政策》文本。同时请你务必明确告知终端用户您的应用使用了移动推送服务。
# 2、关于问题反馈
# 二、操作指南
# 1、创建应用
- 前往腾讯云推送服务控制台,进入「即时通讯 IM」控制台,如果还没创建应用,需先完成应用创建

- 应用创建后即可在控制台中进行接入推送服务;以及可在在「操作」列查看应用详情和密钥
# 2、接入配置
- 点击「接入配置」,切换至刚创建的应用即可申请免费试用该服务

- 开通「免费试用」后即可进入接入配置页面完成相关配置

# 3、微信开发者工具配置推送服务插件
- 下载版本号 ≥ 1.06.2410152 的 nightly 版开发者工具
- Android 最低版本为 1.4.0,推荐使用最新版本
- iOS 最低版本为 1.3.31,推荐使用最新版本
- 需在开发者工具 project.miniapp.json 中勾选开启腾讯云消息推送功能,并且配置消息推送插件的版本号信息
- 如果是 iOS,则还需要配置 businessID、NSEBundleID、NSEProfilePath、NSEDistributetProfilePath、TIMPushAppGroupId等信息
- Android 与 iOS 在开发者工具的配置使用指南,详情可查看快速接入 腾讯云 IM Push
# 4、厂商通道配置
# 5、消息推送相关的客户端 API
- 支持的客户端 API 列表,详情可查看https://cloud.tencent.com/document/product/269/111826
# 6、更多高级功能
- 自定义铃声:接入指南可查看https://cloud.tencent.com/document/product/269/100646
- 自定义点击跳转:接入指南可查看https://cloud.tencent.com/document/product/269/100648
- 如需了解更多更新的能力支持,可前往腾讯云 IM Push 官方文档查看功能的更新日志
# 7、常见问题
# 7.1 如何触发 iOS 消息通知系统授权弹窗
- 按照文档调用registerPush 即可触发ios 消息通知的系统授权弹窗。但是,必须在 App 用户同意了隐私政策,并且确定为 App 用户开始提供推送服务后,再调用该接口使用推送服务。否则可能因提前获取用户隐私导致上架失败。
# 7.2 如何判断用户是否授权消息通知的权限
- 开发者可以通过getAppAuthorizeSetting接口判断用户已将哪些权限授权给 App,具体可查看 notificationAuthorized、notificationAlertAuthorized、notificationBadgeAuthorized、notificationSoundAuthorized 的返回值。
# 7.3 其他常见问题
- 可查看常见问题