Welcome to the
BSG Developer Docs.
Whether you're looking to use our REST APIs, receive
notifications with webhooks, or build an app for the
Intercom Messenger, you've come to the right place.
View a status
Retrieves the information of an existing message. This message can be a sent or a received message. You only need to supply the unique message id that was returned upon creation or receiving.
PARAMETERS
An unique random ID which is created on the BSG platform and is returned upon creation of the object.
A client reference
ATTRIBUTES
An unique random ID which is created on the BSG platform and is returned upon creation of the object.
The telephone number.
A client reference.
The date and time of the creation of the message
The scheduled date and time of the message.
The date and time of the creation of the message.
The date and time of the last status of the message. Possible values: scheduled, sent, delivered, read, expired, undeliverable, rejected, unknown.
REQUEST MESSAGE STATUS BY ID
DEFINITION
GET https://app.bsg.hk/rest/viber/{id}
EXAMPLE RESPONSE
{ “error”:0,
“errorDescription”:”No errors”,
“id”:”380972920000″,
“msisdn”:”380972920000″,
“reference”:”ext_id_19″,
“time_in”:”2017-01-17 09:20:02″,
“time_sent”:”2017-01-17 09:20:02″,
“time_dr”:”2017-01-17 09:20:02″,
“status”:”read”,
“price”:0.23,
“currency”:”EUR”
}
REQUEST MESSAGE STATUS BY REFERENCE
DEFINITION
GET https://app.bsg.hk/rest/viber/{reference}
EXAMPLE RESPONSE
{ “error”:0,
“errorDescription”:”No errors”,
“id”:”380972920000″,
“msisdn”:”380972920000″,
“reference”:”ext_id_19″,
“time_in”:”2017-01-17 09:20:02″,
“time_sent”:”2017-01-17 09:20:02″,
“time_dr”:”2017-01-17 09:20:02″,
“status”:”read”,
“price”:0.23,
“currency”:”EUR”
}
IN ERROR CASE
{ “error”: 40,
“errorDescription”:”Message not found”
}