tencent cloud

文档反馈

短信补推

最后更新时间:2021-11-08 17:43:07

    功能简介

    App 通知栏推送的抵达率和抵达速度往往会因「App 进程不在后台」、「通知栏权限关闭」、「厂商通道超量」等因素出现不同程度折损。
    若业务的某一类推送对抵达率和抵达速度要求较高(如:审批通知、动账通知等),可使用移动推送 TPNS(Tencent Push Notification Service) 提供的短信补推功能。使用短信补推,可在用户无法接收 App 推送时,通过短信将重要信息发送给用户,最大程度保障消息的抵达率与抵达速度。

    使用场景

    系统消息推送

    向 App 用户下发系统相关信息,包括:升级或维护、服务开通、价格调整、订单确认、物流动态、消息确认、支付通知等普通通知和短信。

    推广活动运营消息

    向注册用户和潜在客户发送通知信息,包括促销活动通知、业务推广、新产品功能、会员关怀等商品与活动等推广信息。增加 App 曝光率、提高用户活跃度。

    使用步骤

    步骤1:绑定手机号码

    在您使用短信推送前,需先为用户绑定手机号码,TPNS SDK 提供了绑定手机号码接口。

    步骤2:短信平台授权

    您需要先将腾讯云的 API 密钥保存在 TPNS 平台,推送时 TPNS 可获取其短信发送鉴权信息,配置步骤如下:

    1. 登录 访问管理控制台
    2. 在左侧导航栏中,单击访问密钥 > API 密钥管理,进入 API 密钥管理页面。
    3. 单击新建密钥,即可创建一对密钥。
      说明:

      一对密钥包括 SecretId 和 SecretKey,每个用户最多可以拥有两对密钥。

    4. 前往 移动推送 TPNS 控制台
    5. 在左侧导航栏中,单击第三方服务授权,进入第三方服务授权管理页面。
    6. 单击立即授权
    7. 在弹出的窗口中,将 SecretIdSecretKey 配置到文本框中,单击确认保存即可。

    步骤3:申请短信签名模板

    一个完整的短信模板由短信签名短信正文内容组成,您可前往 短信控制台 创建短信签名及正文模板。

    步骤4:开始使用短信补推

    目前仅支持 REST API 使用短信补推功能,您需要在调用推送接口时在消息体中补充以下字段:

    参数名 类型 是否必须 描述
    resend_by_sms bool 是否开启短信补推:true 是,false 否,默认为否
    sms_info Object 当为短信推送是为必须,具体结构体参考如下 SmsInfo

    SmsInfo

    参数名 类型 是否必须 描述
    delay_trigger_time int 延时触发时间:正常推送多久后,如果没有收到触发事件,则进行补推。 单位:s,最小时间为300s
    trigger_condition int 触发短信补推的事件
  • 0: 对通知栏权限关闭的设备进行短信补推
  • 1: delay_trigger_time 时间内没有收到抵达的进行短信补推
  • 2: delay_trigger_time 时间内没有收到点击的进行短信补推
  • sms_sign_name string 短信签名
    sms_template_id string 短信模板 ID
    sms_app_id string 短信平台的 appId
    sms_template_params Array of String 模板中需要携带的参数

    其中,短信签名、短信模板 ID、短信平台的 appId 可前往 短信控制台 获取,完整的消息字段说明可参考 API 消息体说明

    推送示例如下:

    {
        "resend_by_sms": true,
        "sms_info": {
          "delay_trigger_time": 3600,
          "trigger_condition": 1,
          "sms_sign_name": "signe_name",
          "sms_template_id": "123",
          "sms_template_params": [
              "param1",
              "param2"
          ],
          "sms_app_id": "appId"
      },
      "audience_type": "token_list",
      "message": {
          "title": " test loop",
          "content": "test loop"
      },
      "token_list": ["025ae31e59b3**********a5866354b3","06dee08efed***********31ef23bba"],
      "message_type": "notify",
      "multi_pkg": true
    }
    

    推送完成后,可前往 短信控制台 统计分析页面查看短信记录。

    常见问题

    购买了 TPNS 推送服务,使用短信补推需要额外付费吗?

    使用短信补推功能之前,您需要先购买腾讯云短信套餐包,详情可参考 短信购买指南

    短信补推频率次数有没有限制?

    短信默认的频率限制策略为:

    • 同一手机号码且同一内容30秒内最多发送1条。
    • 同一手机号码一个自然日最多发送10条。
      企业认证用户可以登录 短信控制台 设置或修改相应的频率限制策略,具体操作请参见 设置发送频率限制
      个人认证用户不提供修改频率限制的权限。如需使用该功能,请将“个人认证”修改为“企业认证”,更多企业认证用户权益信息请参见 权益区别
    联系我们

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

    技术支持

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

    7x24 电话支持