All Products
Search

This Product

    Short Message Service:Configure delivery receipts

    Document Center

    Short Message Service:Configure delivery receipts

    Last Updated:Jun 02, 2026

    After sending messages through the API, configure a Simple Message Queue (SMQ) queue or HTTP URL to receive delivery receipts and track message delivery status.

    Important

    • Network errors or response timeouts may cause duplicate or missing delivery receipts.

    • The configuration may take up to 3 minutes to take effect.

    • Delivery receipts are not idempotent. Take appropriate measures to ensure the correctness and consistency of your data.

    Delivery receipt endpoints

    Short Message Service provides two modes to receive delivery receipts: Simple Message Queue (formerly MNS) consumption mode and HTTP batch push mode. Choose the mode that best fits your needs.

    • SMQ queue

      Configure an SMQ queue to receive delivery receipts from a specified region. SMQ supports all SMS message types. After you enable SMQ subscription for a message type in the SMS console, a queue is generated automatically. Use SMS SDKs to pull receipts by message type and queue name.

    • HTTP URL

      Set up an HTTP URL to receive delivery receipts or MO messages. SMS pushes receipts to your callback URL via HTTP POST. Configure the callback URL in the SMS console.

    Types of delivery receipts

    Select the delivery receipt types you want to receive.

    Type

    Description

    SMQ queue

    HTTP URL

    MT delivery report (SmsReport)

    An MT delivery report confirms the delivery status of a message sent from carriers to recipients, such as notifications or business messages.

    SMS webhook

    SmsReport

    Configure delivery receipts

    Configure delivery receipt settings in the SMS console:

    1. Log on to the SMS console.

    2. In the left navigation pane, choose System Configurations > General Settings.

    3. Click the API tab.

    4. In the SMS Delivery Report Setting section, configure one or more endpoints for delivery receipts.

      Message queue

      Enable the SMQ queues option.SMQ queue configuration

      HTTP URL

      1. Enable the HTTP URLs option.

      2. Enter an HTTP URL. Example: http://push.example.com/contextpath/receive.do.

      3. Click Save.HTTP URL configuration

    Request parameters of SMQ queues

    Parameter

    Type

    Required

    Example

    Description

    MessageType

    String

    Yes

    SmsReport

    Message type. Set to SmsReport.

    QueueName

    String

    Yes

    Alicom-Queue-*****-SmsReport

    Queue name. To find the queue name, log on to the SMS console, and then choose System Configurations > General Settings > API.