Skip to main content

FAQ｜How to Check SMS API Send Report, Delivery Status, and Failure Reasons

  • Updated

     

    When using the SMS+ API, If you send messages via the SMS+ API, you can view the performance and detailed records of each template through the MAAC backend. This article will explain how to query and understand the sending records.

     

    Frequently Asked Questions: How to Check SMS+ API Sending Records, Delivery Status, and Reasons for Undelivered Messages

    If you send messages via the SMS+ API, you can view the performance and detailed records of each template through the MAAC backend. This article will explain how to query and understand the sending records.

     

    Method 1: Viewing Sending Statistics for Each Template

    Steps:

    1. Log in to MAAC and navigate to the "SMS+" page.

    2. You can view the sending data for each template, including:

      • Number of message triggers

      • Number of messages successfully delivered

      • Number of reads (applicable only to WhatsApp messages)

      Note: You can use the filter in the blue box above to filter by message channel for easier data querying.

    Xnip2025-03-28_20-04-58.png

     

    Time Filter Explanation:

    • Supports filtering by time range, with a maximum query range of "the past 3 months from today."

    • The time filter is based on the "API trigger time," not the actual message delivery time.

    Note: Since the SMS+ API supports automatic fallback to SMS sending, the following situations may occur:

    • The API trigger date does not immediately result in delivery.

    • The actual message delivery date differs from the trigger date.

     

    Method 2: Viewing Detailed Sending Records for Each Message

    If you need to further examine the detailed sending status of each message, please follow these steps:

    1. Select a specific sending time range.

    2. Search for a specific recipient's phone number (use the dropdown menu to select the country code).

    3. Based on the tabs for all and sending statuses (Sending, Sent, Undeliverable, Sending Failed), you can view the phone number, sending scenario, sending status, trigger time, delivery time, and delivery channel.

      • Sending Channels:

        • LINE Push

        • LINE Notification Messages

        • WhatsApp (requires integration with the WhatsApp channel to view)

        • SMS

    4. Click the expand icon to view the details of a single sending record.

    Xnip2025-03-28_20-06-59.png

    Xnip2025-04-11_13-40-55拷貝.png

     

    FAQ

    ▶︎ Explanation of Sending Statuses

    • Preparing: The message is being processed, and the result is not yet available.

    • Delivered: The message has been successfully delivered.

    • Undeliverable: The system determined that there were channel anomalies or information errors, preventing delivery.

    • Failed: The sending failed due to template configuration errors or system anomalies; it is recommended to contact Crescendo Lab to determine the cause.

    What do the statuses in the LINE Push sending records mean?

    • Preparing: MAAC has received the sending request and is beginning to process the message sending.

    • Undeliverable:

      The message could not be sent and will automatically be forwarded as a LINE Notification Message or SMS.

      • Crescendo Lab being unable to match the phone number to a single contact.

      • The contact having blocked the LINE official account.

      • Reaching the LINE message quota limit.

    • Delivered: Successfully sent.

    ▶︎ What do the statuses in the LINE Notification Message sending records mean?

    • Preparing: MAAC has received the sending request and is beginning to process the message sending.

    • Accepted: MAAC is waiting for LINE to respond on whether the contact has received the message, often because the contact has not yet completed the notification message verification. The process is accepted > unverified for N hours (the fallback time set initially) > automatically forwarded as SMS.

    • Undeliverable: LINE currently cannot match the number or has been blocked; it will uniformly wait for N hours (the fallback time set initially) before forwarding.

    • Delivered: Successfully sent.

    ▶︎ What do the statuses in the SMS sending records mean?

    • Preparing: MAAC has received the sending request and is beginning to process the message sending.

    • Accepted: MAAC is waiting for the telecom provider to respond on whether the contact has received the message; if a message fails at this stage, it will automatically retry, with different default retry times depending on the telecom provider.

    • Undeliverable: Due to telecom provider or recipient signal anomalies, incorrect phone number formats, deactivated or invalid numbers, or the presence of "content considered sensitive" in the SMS, the message could not be delivered.

    • Delivered: Successfully sent.

    During the above periods, the telecom providers will continue to retry, but the retry frequency is not specified by the platform. Intermediate results during retries are not provided to Crescendo Lab; only the final result is available.

     

    ▶︎ What do the statuses in the WhatsApp sending records mean?

    • Accepted: MAAC has received the sending request and is beginning to process the message sending.

    • Undeliverable: Due to API call parameters not matching the WhatsApp message template, insufficient WhatsApp message quota, WhatsApp business account permission anomalies, WhatsApp authorization anomalies, etc.

    • Delivered: Successfully sent.

    Related articles