SMS Sending Status Notification

API Description
Feature description
This API is used for Tencent Cloud SMS to notify the business of the message sending status by calling back the service URL after an SMS message is sent to a user.
Sample URL
POST http://example.com/sms/callback
Request Parameters
The following table lists the request parameters.
Parameter
Required
Type
Description
user_receive_time
Yes
string
The time when the user actually receives the message
nationcode
Yes
string
Country/Region code
mobile
Yes
string
Mobile number
report_status
Yes
string
Whether the SMS message is actually received. Valid values: SUCCESS (success), FAIL (failure)
errmsg
Yes
string
Error message of receipt status code. For more information, see Error Codes for SMS Sending and Receipt Status
description
Yes
string
Description of SMS receipt status.
sid
Yes
string
Sending ID (corresponding to the SerialNo returned by the sending API)
Note: 
A callback request may return the results of multiple SMS requests.
Sample request:
[
    {
        "user_receive_time": "2015-10-17 08:03:04",
        "nationcode": "86",
        "mobile": "13xxxxxxxxx",
        "report_status": "SUCCESS",
        "errmsg": "DELIVRD",
        "description": "The SMS message is successfully delivered",
        "sid": "xxxxxxx"
    }
]
Response Parameters
The following table lists the response parameters.
Parameter
Required
Type
Description
result
Yes
number
Error code. 0: success; other values: failure
errmsg
Yes
string
When result is 0, it displays "OK", and when result is not 0, it displays a specific error message.
Sample response:
{
    "result": 0,
    "errmsg": "OK"
}

Was this page helpful?

You can also Contact Sales or Submit a Ticket for help.

Yes

tencent cloud

API Description

Feature description

Sample URL

Request Parameters

Response Parameters

About Tencent Cloud

Help & Support

Resources

User Center

Parameter	Required	Type	Description
user_receive_time	Yes	string	The time when the user actually receives the message
nationcode	Yes	string	Country/Region code
mobile	Yes	string	Mobile number
report_status	Yes	string	Whether the SMS message is actually received. Valid values: SUCCESS (success), FAIL (failure)
errmsg	Yes	string	Error message of receipt status code. For more information, see Error Codes for SMS Sending and Receipt Status
description	Yes	string	Description of SMS receipt status.
sid	Yes	string	Sending ID (corresponding to the `SerialNo` returned by the sending API)

tencent cloud

Sign Up

Log in

Compute

Microservice

Data Migration

Database SaaS Tool

Data Security

Application Security

Big Data

Tencent Big Model

Internet of Things

Stream Services

Cloud Real-time Rendering

Cloud Resource Management

More

Edge Computing

Serverless

Relational Database

Networking

Business Security

Domains & Websites

Face Recognition

AI Platform Service

Middleware

Media On-Demand

Game Services

Management and Audit Tools

Container

Essential Storage Service

Enterprise Distributed DBMS

CDN and Acceleration

Security Services

Enterprise Applications

Voice Technology

Natural Language Processing

Communication

Media Process Services

Education Sevices

Developer Tools

Distributed cloud

Data Process and Analysis

NoSQL Database

Network Security

Cloud Security

Office Collaboration

Image Creation

Optical Character Recognition

Interactive Video Services

Media SDK

Medical Services

Monitor and Operation

API Description

Feature description

Sample URL

Request Parameters

Response Parameters

About Tencent Cloud

Help & Support

Resources

User Center