tencent cloud

文档反馈

即时通信离线推送

最后更新时间:2022-04-21 15:13:32

    简介

    离线消息推送可以帮助您的 App 在用户关闭应用的状态下,也能顺利收到消息推送。
    若您的即时通信(Instant Messaging,IM)应用需要使用离线消息推送,您可开通移动推送 TPNS(Tencent Push Notification Service)服务,开通并授权后即可使用移动推送服务实现IM离线消息下发与统计。

    说明:

    TPNS 为 IM 客户提供免费的基础离线推送服务。如需要 TPNS 的各种数据统计及更多推送类型的支持,请将您的 IM SDK 升级至最新版本(已集成 TPNS SDK )并购买 TPNS 付费服务。

    准备工作

    1. 请准备以下内容:
      说明:

      如您之前在IM设置过厂商信息(如channel_id、点击跳转动作等),则不需要创建新的 TPNS 应用。我们将在2022年4月15日前将 IM 厂商信息迁移至TPNS应用;在此之前,您仍可以使用原有的离线消息推送能力。

    • App 的包名。
    • Android 厂商通道推送平台分配的 AppId、AppKey、AppSecret;iOS 推送证书。
    1. 使用和 IM 服务同一个腾讯云主账号开通 移动推送 TPNS 服务。
      说明:

      TPNS 对 IM 授权应用不收取离线推送费用。

    2. 单击新建产品,创建一个新的移动推送产品。
    3. 在弹出的窗口中,填写产品名称,设置产品分类,选择服务接入点,单击确定
      说明:

      选择服务接入点(数据存储地点)时,可根据您的应用服务区域选择。例如,中国大陆可选广州、上海,海外业务可选中国香港、新加坡。

    确认授权状态

    1. 登录 腾讯移动推送控制台,选择待操作的产品,单击立即配置
    2. 在左侧导航栏中,单击第三方服务授权
    3. 在第三方服务授权管理页面,将 TPNS应用授权切换为云IM应用授权

      如未看到该切换,请检查:
    • 在 IM 服务中是否创建了应用。如果没有创建应用,请前往 IM 控制台 创建 IM 应用。
    • 当前登录的账号是否为子账号,且是否已被主账号授权。建议切换至主账号登录。

    新增授权

    1. 首次进入云IM应用授权页面,会弹出如下信息,单击知道了
    2. 在腾讯云即时通信IM 页面,单击新增授权
    3. 在弹出的窗口中,选择当前账号下的 IM 应用名称,准备工作中创建的 TPNS 产品名称,及 TPNS 应用名称,单击提交

      如应用已被授权,则不可选择,请创建新应用或者先解除授权后重新进行授权。

    查看应用状态

    如应用已被授权给 IM,则可通过如下操作进行查看:

    1. 进入腾讯移动推送控制台 > 产品管理 页面,查看到服务详情变更为仅限IM推送(免费)
    2. 在左侧导航栏中,单击 App推送管理 > 推送计划,查看到推送计划自动创建了一个名为即时通信IM消息的计划。

    应用配置

    如您已在 IM 服务设置过厂商信息,则数据已自动同步无需做应用设置。否则,您需要配置厂商通道(Android)或推送证书(iOS)。

    配置包名

    1. 登录 腾讯移动推送控制台,选择待操作的产品,单击立即配置
    2. 在左侧导航栏中,单击 App推送管理 > 基础配置,输入准备工作中已获取的包名并保存。

    配置 Android 厂商通道

    1. 登录 腾讯移动推送控制台,选择待操作的产品,单击立即配置
    2. 在左侧导航栏中,单击 App推送管理 > 基础配置,进入基础配置页面。
    3. 在厂商通道中,选择厂商通道,单击 ,输入准备工作中已获取的 AppId、AppKey、AppSecret,单击保存

    配置 iOS 推送证书

    1. 登录 腾讯移动推送控制台,选择待操作的产品,单击立即配置
    2. 在左侧导航栏中,单击 App推送管理 > 基础配置,进入基础配置页面。
    3. 在推送证书中,单击上传证书,并根据页面提示上传证书。

      提交证书后,会显示已上传证书。证书的获取可参考 推送证书获取指引

    查看离线消息统计

    完成配置后,您即可通过如下操作,查看对应的离线消息发送记录。

    1. 登录 腾讯移动推送控制台
    2. 在左侧导航栏中,单击 App推送管理 > 推送计划,单击即时通信IM消息的详情即可查看离线消息发送记录。

    其他说明

    • 授权 IM 应用不可以直接删除,需要先在第三方授权解除授权,才能删除该应用。

    • 已授权 IM 的应用服务仅涵盖离线推送功能,如需使用其他推送服务及数据统计等,需要按照指引进行操作:

    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持