Sends text messages in batches to the regions outside Mainland China. Bulk send does not support sending China and the United States. The limit is 1QPS. You can enter up to 250 numbers at a time. If you need to send a large number of SMS messages, you can contact customer service to upgrade the number. You can enter up to 1,000 numbers at a time.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String No BatchSendMessageToGlobe

The operation that you want to perform. Valid values: BatchSendMessageToGlobe cluster.

Message String Yes Hello

The content of the text message.

Note The message field must be a jsonArrayString.
To String Yes ["123","456","789"]

The mobile phone numbers to receive the text messages. You must add the country code to the beginning of each mobile phone number. You must use an array to specify the mobile phone numbers, for example, ["123","456","789"].

Type String Yes OTP

The type of the text message. Valid values:

OTP: verification code

NOTIFY: notification text messages

MKT: promotional text messages

GENERAL: general-purpose text messages

From String No Alicloud

The ID of the sender. You can specify the sender ID when you call the API operation. The sender ID can contain digits and letters. If the sender ID contains only letters, the sender ID can be a maximum of 11 characters in length. If the sender ID contains only digits, the sender ID can be a maximum of 15 characters in length.

TaskId String No 123xxx789

The ID of the export task that you want to delete.

Response parameters

Parameter Type Example Description
FailedList String ["123","456"]

The list of the mobile phone numbers that failed to receive the text messages.

From String Alicloud

The ID of the sender that was returned. The API operation returns the sender ID that you have specified in the request parameters.

MessageIdList String ["1008030xxx3003","1008030xxx3004"]

The list of Message IDs. When batch sending SMS messages, correspond to each successful number

RequestId String F655A8D5-B967-440B-8683-DAD6FF8DE990

The ID of the request.

ResponseCode String OK

The HTTP status code. If OK is returned, the request is successful. For more information about the other error codes, see Error codes cluster.

ResponseDescription String The SMS Send Request was accepted

The description of the status code.

SuccessCount String 1

The number of the text messages that were sent.

Examples

Sample requests


http(s)://dysmsapi.ap-southeast-1.aliyuncs.com/?Action=BatchSendMessageToGlobe
&Message=Hello
&To=["123","456","789"]
&<common request parameters> 
   

Sample success responses

XML format


     <ResponseCode>OK</ResponseCode> <RequestId>F655A8D5-B967-440B-8683-DAD6FF8DE990</RequestId> <FailedList>["123","456"]</FailedList> <ResponseDescription>The SMS Send Request was accepted</ResponseDescription> <From>Alicloud</From> <SuccessCount>1</SuccessCount> <MessageIdList>["1008030xxx3003","1008030xxx3004"]</MessageIdList> 
   

JSON Format


     { "ResponseCode": "OK", "RequestId": "F655A8D5-B967-440B-8683-DAD6FF8DE990", "FailedList": "[\"123\",\"456\"]", "ResponseDescription": "The SMS Send Request was accepted", "From": "Alicloud", "SuccessCount": 1, "MessageIdList": "[\"1008030xxx3003\",\"1008030xxx3004\"]" } 
   

Error codes

Go to the Error CenterFor more information, see error codes.