Overview

The reach rate and speed of app notification pushes are often compromised to various degrees due to factors such as app processes not in the background, notifications disabled, and excessive vendor channels.
If you have a type of push that requires high reach rate and speed (such as approval notifications and transaction notifications), you can use the supplementary SMS push feature provided by TPNS. This feature sends important information to users through SMS messages when they cannot receive app pushes, maximizing the reach rate and speed of messages.

Use Cases

System message pushes

Sends system-related messages to app users, including common notifications and SMS messages about upgrade/maintenance, service activation, price adjustment, order confirmation, logistics update, message confirmation, and payment.

Promotional messages

Sends messages to registered and potential users, including promotional information about sales campaign, business promotion, new product feature, and member care, to increase app exposure and user engagement.

Directions

Step 1. Bind mobile numbers

Before you use SMS push, you need to bind a mobile number for each user. The TPNS SDK provides an API for binding mobile numbers.

• For the SDK for Android, see here to bind mobile numbers.
• For the SDK for iOS, see here to bind mobile numbers.

Step 2. Authorize access to the SMS platform

You need to save Tencent Cloud's API keys on the TPNS platform first, so that TPNS has the permission to send messages via the SMS platform. The configuration steps are as follows:

1. Log in to the CAM console.
2. On the left sidebar, click Access Key > Manage API Key to go the API key management page.
3. Click Create Key to create a key pair.

   Note：

   A key pair consists of a SecretId and SecretKey. Each user can have up to two key pairs.

4. Go to the TPNS console.
5. On the left sidebar, click Third-Party Service Authorization to go to the third-party service authorization management page.
6. Click Authorize Now.
7. In the pop-up dialog box, enter the SecretId and SecretKey and click Confirm to save.

Step 3. Apply for SMS signatures and body templates

A complete SMS message consists of a signature and body. You can go to the SMS console to create SMS signatures and body templates.

• To send SMS messages to users in Chinese mainland, please apply for a Chinese mainland SMS signature and body template first.
• To send SMS messages to users outside Chinese mainland, please apply for a Global SMS signature and body template first.

Step 4. Start to use supplementary SMS push

Currently, TPNS supports using the supplementary SMS push feature via RESTful API calls only. You need to add the following fields to the message body when calling the push API:

SmsInfo

You can find the SMS signature, SMS template ID, and SMS platform’s appId in the SMS console. For more message parameters, see Push API.

Below is a sample push:

{
    "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
}

After completing the push, you can view the SMS message records on the statistics page in the SMS console.

FAQs

Do I need to pay extra fees for using supplementary SMS push when I have purchased the TPNS service?

Before you can use the supplementary SMS push feature, you need to purchase an SMS package. For more information, see Billing Overview.

Is there a limit on the delivery rate of supplementary SMS push?

The default delivery rate limit is as follows:

• SMS messages with the same content can be sent to a single mobile number only once within 30 seconds.
• A maximum of 10 messages can be sent to a single mobile number on a calender day.
  Organizational users can log in to the SMS console to set or modify the corresponding delivery rate limit policy. For detailed directions, please see Setting Delivery Rate Limit.
  Individual users have no permission to modify the delivery rate limit. To use this feature, change "Individual Identity" to "Organizational Identity". For more information on the rights of organizational users, please see Differences in rights.