Short Message Service:Send messages in batches

Use the batch sending feature to send an SMS to a recipient group in a single operation.

Batch sending lets you send the same text message to multiple recipients without making individual API calls per recipient. Create a recipient group, select an approved SMS template and signature, and submit a single send request.

With batch sending, you can:

• Send one text message to an entire recipient group in a single request

• Combine any approved SMS template with any approved SMS signature

• Track delivery status per recipient through delivery receipts

• Schedule and manage batch operations from the SMS console

Prerequisites

Before you begin, ensure that you have:

• An approved SMS signature. The signature appears at the beginning of every outbound message and identifies the sender.

• An approved SMS template. The template defines the message body and any variable placeholders.

Create a recipient group

1. Log in to the SMS console.

2. In the left navigation pane, click Batch Sending > Recipient Groups.

3. Click Create Recipient Group.

4. Enter a group name and, optionally, a description.

5. Click OK.

6. In the group list, click Add Recipients next to the new group.

7. Enter or import the phone numbers to include. Paste numbers directly or upload a CSV file with one number per line. Each number must be in E.164 format (for example, +8613800138000 for a Chinese mainland number).

8. Click Save.

The group appears in the recipient group list with the total number of recipients displayed.

Send messages in batches

1. In the left navigation pane, click Batch Sending > Send Messages.

2. From the SMS Signature drop-down list, select the signature to prepend to the message.

3. From the SMS Template drop-down list, select the template that defines the message content.

4. If the selected template contains variable placeholders, click Configure Variables and enter the variable values. To personalize messages per recipient, upload a CSV file with one column per variable.

5. From the Recipient Group drop-down list, select the group you created.

6. Under Send Time, choose one of the following:

   • Send Now: Submits the batch immediately.

   • Scheduled: Sets a future date and time for delivery.

7. Click Send.

8. In the confirmation dialog, review the recipient count and estimated message volume, then click Confirm.

A batch task is created and appears in the Task List. Delivery begins within a few minutes for immediate sends.

Track delivery status

After submitting a batch, monitor the results in the Task List:

1. In the left navigation pane, click Batch Sending > Task List.

2. Locate the batch task by name or submission time.

3. Click Details to view the per-recipient delivery status.

The task detail page shows each recipient's delivery receipt status:

If a message fails, check the failure reason before retrying. Common causes include an invalid phone number format, the recipient being on the opt-out list, or carrier-side rejection.

What's next

• View SMS delivery reports: Review aggregated delivery statistics by template, time range, or region.

• Manage recipient groups: Add, remove, or update recipients in an existing group.

• Query delivery receipts via API: Retrieve per-message delivery status programmatically using the QuerySendDetails API.