Skip to main content

Incoming Status

This API is used by Sprint to send Incoming Status to the client.

Requirement

After sending a message, you will receive a delivery status containing the following parameters. Before that, the client must create an endpoint that can be accessed by Sprint to send a delivery status

This section explains the request parameters and provides example JSON requests for message delivery status updates.
Description Parameter Request
FIELDTYPE ALLOWEDDESCRIPTION
statusJSON ObjectDetails information from statuses
message_idStringID generated from the message sending API
provider_message_idStringUnique message ID provided by the provider.
recipient_idStringUnique identifier of the message recipient.
statusIntegerMessage status:
-3 Failed,
-2 Undelivered,
-1 Unsent,
0 Pending,
1 Sent,
2 Delivered,
3 Read
tidStringTransaction ID generated during the sending process.
timesIntegerFormat = Unix Timestamp from user's access period
timestampTimestampFormat = Date Time indicates the user's access period.
Sample JSON Request
{
"status": {
"message_id": "317077fd-xxxx-xxxx-xxxx-xxxxxxxx",
"provider_message_id": "",
"recipient_id": "628xxxxxxxx",
"status": 2,
"tid": "8498d7e4-xxxx-xxxx-xxxx-xxxxxxxx",
"times": 0,
"timestamp": "2023-11-10T12:38:08.168309367+07:00"
}
}