Alibaba Cloud Short Message Service (SMS) pushes message delivery reports to a specified message queue. To view the queue name, log on to the SMS console. You can call this operation to pull the message delivery reports from the message queue.
Request parameters
Note Users can specify message service (MNS) queues or HTTP URLs to receive SMS sending
status reports pushed by SMS. The SmsReport is then called to pull the messaging report
from the specified message queue or HTTP server. You must specify the following parameters
when calling this operation:
For more information about how to specify an MNS queue or HTTP URL, see message receiving mode.
If SMS messages are sent from regions outside mainland China to mainland China, specify
the following parameters when you call this operation.
Parameter | Type | Decription | Example |
---|---|---|---|
PhoneNumber | String | The mobile number of the recipient. | 159 consecutive minutes * 5678 |
SendStatus | String | The delivery status of the message. | The sending status of the SMS message:
|
BizId | String | The ID of the delivery receipt. | 1234567 ^ 0 |
ExternalId | String | The ID of the batch. Set this parameter to the value of the outId parameter that is specified when you call an operation to send messages. | 123456 |
SendDate | String | The time when the message was sent. | 2020-05-01 10:00:00 |
ReceiveDate | String | The time when the delivery receipt was received from the carrier. | 2020-05-01 10:00:03 |
ErrorCode | String | Error codes | UNKNOW |
ErrorMessage | String | The error message. | An unknown error has occurred. |
SmsQuantity | String | The number of messages. Each message can be up to 140 bytes in length. If a message is longer than 140 bytes, SMS separates the message into multiple messages. | 1, 2, 3 |
If SMS messages are sent from mainland China to regions outside mainland China, specify
the following parameters when you call this operation.
Parameter | Type | Decription | Example |
---|---|---|---|
To | String | The mobile number of the recipient. | 159 consecutive minutes * 5678 |
Status | String | The delivery status of the message. | The sending status of the SMS message:
|
MessageId | String | The ID of the delivery receipt. | 123456789 |
TaskId | String | The ID of the batch. Set this parameter to the value of the taskId parameter that is specified when you call an operation to send messages. | 123456 |
SendDate | String | The time when the message was sent. | 2020-05-01 10:00:00 |
ReceiveDate | String | The time when the delivery receipt was received from the carrier. | 2020-05-01 10:00:03 |
ErrorCode | String | Error codes | UNKNOW |
ErrorDescription | String | The error message. | An unknown error has occurred. |
Examples
Sample requests
[
{
"PhoneNumber" : "1390****001",
"SendDate" : "2017-01-01 00:00:00",
"ReceiveDate" : "2017-01-01 00:00:00",
"SendStatus" : "1",
"ErrorCode" : "UNKNOW",
"ErrorMessage" : "An unknown error has occurred.",
"SmsQuantity" : "1,2,3",
"BizId" : "1234567^0",
"ExternalId" : "67890"
}
]
Sample success responses
{
"code" : 0,
"msg" : "The message is received."
}