HTTP(s) – CallbackURL

If you use the CallbackURL option in the HTTP(s) interface, we will let you know, when your message is changing status.

You should install some software on your server, that can handle a "HTTP Get request" from our server. When you send the message, you are telling us, what request we should make, as the message is delivered.

Example - Could be like this:

https://api.suresms.com/Script/SendSMS.aspx?login=+4510203040&password=test&from=Julemanden&to=+4650607080&Text=Hallo World&url=http://www.mydomain.com/response

 

When our server is calling yours with the URL : http://www.mydomain.com/response, we will add the following parameters to the request:

Status See the status code later in this post
StatusUTCDateTime Date and time in UTC yyyy-mm-ddThh:mm:ssZ when this status message was received.
Receiver The number, which the message has been dispatched to.

 

If you want to be able to match our Callback to a specific message from you, you should add some unique information to your CallbackURL. This could be as the following: https://www.mydomain.com/response?messageid=1%26

%26 is URL encodningen for the “&”.

Statusvalue :

1 Delivery successful - handset has received the message

2 Delivery failure - Wrong phonenumber, rejected, creditlimit etc

4 Message enroute - Message has been sent to operator

8 Delivery will never happen - Expired, deleted or SPAM filter.