tencent cloud

文档反馈

短信补推

最后更新时间:2024-01-16 17:34:39

    功能简介

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

    使用场景

    系统消息推送

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

    推广活动运营消息

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

    使用步骤

    步骤1:绑定手机号码

    在您使用短信推送前,需先为用户绑定手机号码,移动推送 SDK 提供了绑定手机号码接口。
    Android SDK 进行手机号码的绑定,详情请参见 添加手机号码
    iOS SDK 进行手机号码的绑定,详情请参见 添加手机号码

    步骤2:短信平台授权

    您需要先将腾讯云的 API 密钥保存在移动推送平台,推送时移动推送可获取其短信发送鉴权信息,配置步骤如下:
    2. 在左侧导航栏中,单击访问密钥 > API 密钥管理,进入 API 密钥管理页面。
    3. 单击新建密钥,即可创建一对密钥。
    说明:
    一对密钥包括 SecretId 和 SecretKey,每个用户最多可以拥有两对密钥。
    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
    }
    
    推送完成后,可前往 短信控制台 统计分析页面查看短信记录。

    常见问题

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

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

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

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

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

    技术支持

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

    7x24 电话支持