Notification of MT SMS Delivery Status

Last updated: 2018-08-30 17:59:46

    1 Protocol Descriptions

    Protocol HTTP JSON
    Encoding format UTF8
    URL For example: https://yun.tim.qq.com/sms/smscallback
    API description After an SMS is sent to a user, Tencent Cloud SMS service notifies the business side of the delivery status of the SMS by calling back the service URL.

    2 Request Packet

    The packet is in JSON format with the following parameters:

    [
        {
            "user_receive_time": "2015-10-17 08:03:04", //The time the user actually received the message
            "nationcode": "86", //Country code
            "mobile": "13xxxxxxxxx", //Mobile number
            "report_status": "SUCCESS", //The actual SMS receiving status. SUCCESS: successful, FAIL: failed
            "errmsg": "DELIVRD", //Code that defines the SMS receiving status
            "description": "The SMS message is successfully sent ", //Description of the SMS receiving status
            "sid": "xxxxxxx" //Indicate the ID of this delivery
        }, 
        { }…
    ]

    Notes:

    1. A callback request may have results of multiple SMS requests returned.
    2. For more information on "errmsg", see Error Codes for Status Report.

    3 Response Packet

    When receiving a callback request, the third party needs to give a response to Tencent Cloud SMS service in the following format:

    { 
        "result": 0, //0: Successful. Other values: Failed
        "errmsg": "OK" //The specific error message when the "result" is not 0
    }

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help