Notification HTTP : get SMS Answers

Home » DOCOON APIs » Private: Webhooks » Notification HTTP : get SMS Answers

We can configure your account to receive answer from the sms you sent. (Contact your sales account manager for more information). After sending a SMS to a recipient, the recipient can answer in the next 72 Hours. We then forward you the message. You can get the notification as an email, or find the file in the receptions folders, or get a HTTP POST notification from our service.

Here we will describe the HTTP POST notification service:



Information: To configure this option in your account, you need to provide an URL where we can send the POST, and the format you selected.
The web page should return a HTTP/200 in the 300ms following the notification. If the HTTP/200 is not returned, we will retry the sending every 30 sec until we get an answer.

The push notification can be sent in several format :Basic HTTP POST page configurations:

. JSON (“application/json”), (date are formated as “/Date(XXXXXXXX)/” or XXXXXXXX is the « Epoch » format (number of milliseconds from 1970/01/01).)

. XML (“application/xml”), (date are formated « Epoch »)

. format TEXT (“text/plain”)

. Form (“application/x-www-form-urlencoded”)

 

Data we send: 

Parameters List
Tid String Id of the Job (1XXXXXX)
Message String Message received
From String Your account inbound reference ID
To String

Phone number of the sender (with country code value)

Example : 080 -1234 – 1980 => 818012341980

CustomerNumber int Customer Number associated to the sending services.
EventDateTime See above Reception date
EventType int Type of notification 8: Inbound SMS
JobNumber int Id of the job (that was returned when doing the sending)
JobType String JobType used for the sending
JobItem int Position of the item in your list

Samples:

{"TID":"My tracking ID",
"From":"INBOUNDSMS_200XX",
"To":"81809862XXXX",
"Message":"My Message",
"CustomerNumber":200XX,
"EventDateTime":"\/Date(1491284336708+0900)\/",
"EventType":8,
"JobItem":1,
"JobNumber":1676781,
"JobType":"SMS"}

Case of a dedicated Number:

If you have a dedicated Number, you can receive SMS that are sent 72 hours after your sending, or directly without sending. However we do not link the message to a sending Job, the values of “JobNumber”, “JobItem”, “JobType” and “TID” will be 0 for the 2 first and an empty string for the 2 others.

Example of Empty values :
{"CustomerNumber":200xx,
"EventDateTime":"\/Date(1492739263085+0900)\/",
"EventType":8,
"JobItem":0,
"JobNumber":0,
"JobType":"",
"TID":"",
"From":"000XXXXX",
"Message":"MyMessage",
"To":"81809862XXXX"}