Help Center > > User Guide> Using the Group SMS Assistant

Using the Group SMS Assistant

Updated at: Nov 25, 2019 GMT+08:00


The Group SMS Assistant is used to send SMSs in batches without code development. The Group SMS Assistant cannot be used to send verification code SMSs.

You can use the Group SMS Assistant to create a scheduled task, enabling the system to send SMSs at a scheduled time within one month. The scheduled task can be canceled. However, the Group SMS Assistant does not support sending SMSs periodically.


  • Creating an SMS Application is complete.
  • (Only for Chinese mainland SMS) An SMS signature has been approved and the channel number has been configured for it. (Except for verification code signatures, the Group SMS Assistant cannot be used to send verification code SMSs.)
  • An SMS template has been approved and activated. The template does not contain variables. (Except for verification code templates, the Group SMS Assistant cannot be used to send verification code SMSs.)
  • Applications, signatures, and templates are associated.


  • The Group SMS Assistant cannot be used to send verification code SMSs. The system charges the SMS that has been sent based on the SMS service type. For details, see Billing Mode.
  • For details about the browsers supported by the Message&SMS console, see Which Browsers Are Supported.

Submitting a Send Task

  1. Access the Message&SMS console, and choose Group SMS Assistant > Task Management to open the Task Management page.
  2. Set the parameters.

    For parameter settings on the Group SMS Assistant, you can click What Is the Reason That an SMS Signature and an SMS Template Cannot Be Selected in the Group SMS Assistant?.

    SMS Signature: This parameter must be specified for a Chinese mainland SMS application. Select an SMS signature that is associated with the SMS application.

    SMS Template: Select an SMS template that is associated with the SMS application and does not contain template variables. For Chinese Mainland SMSs, the template must belong to the selected SMS signature or universal signature.

    Import Recipient Number File: Click Download Sample File to download the example file. Add recipient numbers to the file as instructed, and upload the file.

    Schedule SMS Sending: Select Yes if you want to send SMSs at a scheduled time

    Send SMS at: This parameter specifies the date and time when an SMS is sent. Set this parameter only when Schedule SMS Sending is set to Yes. You are advised to send scheduled SMSs between 08:00 and 21:00 every day. Sending messages at other time may incur user complaints.


    To prevent numbers from being displayed abnormally, set the cell to Text, or copy the sample cells, paste and modify them.

    All number must be in the format of +{CC}{NDC}{SN}, for example, +8613112345678.

    • {CC} indicates the country code.
    • {NDC} indicates the area code. If the called number is a mobile number, {NDC} is optional.
    • {SN} indicates the recipient number.

    When a user creates a task, the system processes mobile phone numbers as follows:

    • If the number consists of 11 digits and starts with 1, prefix the number with +86.
    • If the number consists of 13 digits and starts with 86, prefix the number with +.
    • For numbers that consist of neither 11 nor 13 digits and do not start with +, the system considers them invalid, deletes them from the number list, and records the quantity of such numbers.
    • Deduplicate numbers from the remaining numbers and record the quantity of duplicate numbers.

  3. Click Create Task.
    • If a message "Submission request failed. The recipient number file includes invalid phone numbers." is displayed, check the recipient number file, enter valid numbers, and upload it again.
    • If a message "X phone number(s) imported. Redundant and invalid numbers have been deleted. You will not be charged for the Y message(s) deleted." is displayed, check the recipient number file for whether invalid numbers exist, create a task again for modified numbers.

    After the task is submitted, you can view the task status and operation details on the View Tasks page. The sending result is displayed in about 3 minutes. To view the real-time result, refresh the page.

Viewing Task Details

  1. Log in to the Message&SMS console, and choose Group SMS Assistant > Task Management. On the displayed page, click View Tasks.
  2. View the task status. You can filter tasks by Task Name or Status. Click View Details to check the task details.

    Click Cancel Task to cancel a scheduled task to be executed. Cancel a scheduled task at least 5 minutes before the scheduled SMS sending time. The task cannot be canceled if it is about to be executed within 5 minutes. If a scheduled task is not executed within 24 hours, it is automatically canceled.

    Click Delete Task to remove a canceled task from the system.

  3. View information about sending SMSs, such as number quantity, receipt time, SMS ID, and sending result.
    • A long SMS will be segmented to multiple records with the same SMS ID. For details about how an SMS is segmented, see SMS Sending Rules.
    • Click Download Failed Number File to obtain a file containing all numbers to which SMSs fail to be sent.
    • If Send Result is Unknown, the SMS gateway does not send a sending status report. Wait for a period of time and check the sending status again.

Did you find this page helpful?

Submit successfully!

Thank you for your feedback. Your feedback helps make our documentation better.

Failed to submit the feedback. Please try again later.

Which of the following issues have you encountered?

Please complete at least one feedback item.

Content most length 200 character

Content is empty.

OK Cancel