HTTP Client for Push Notification of Message Status
- Peter Humphries (Deactivated)
To use the Push status feature you will have to host a application web page that our client can call using http get. The following information explains how the system works and how configure push message status within out system.
Note that to understand if the message has been accepted by the gateway is recommend that you do one document status query. It is recommended that is done not sooner that 1 sec after the send process. If done earlier you may get a -230 error saying the document Id does not exist. If you do get this error you can repeat the request until a non error response is returned. (assuming you are quering the correct documentId under the correct username and pw)
Coniguring a User for Push Status
1. Push method will be invoked if the check flag in the MCUser record is checked and the address is filled with an http.
2. The URL address may contains the following parameter:
- DocumentId = DocumentId of the MT message that the status applies to.
- Status = Status message status.
- TimeStamp = time of receiving message status update from the telecommunications provider.
- SourceAddress = MSISD of the number that message was sent to. Will always be in long internation format eg if you submitted the message as a local number.
A percentage (%) should be added as prefix and postfix to define these parameters into the URL address.
Example URL for all parameters
3. The URL address will be executed if SMS final status is received (SMS state equals to DELIVERED, SENT, EXPIRED, DELETED, UNKNOWN, INVALID, REJECTED, UNDELIVERABLE)
note that these names are returned and not the status codes.
Labels parameters
4. The execution process will be handled in queue, if it fails then the process will be re-executed/resent every 5 minutes for 30 minutes then every 1 hour for 6 hours.
Not to be given to the customer
Those interval and range are the default values which set by system, however they can be configured through JMX.
First configuration: message will be resend every 5 minutes for 30 minutes
- Interval1 = 300000 = 5 minutes
- Range1 = 1800000 = 30 minutes
Second configuration: will be resend every 1 hour for 6 hours
- Interval2 = 3600000 = 1 hour
- Range2 = 21600000 = 6 hours
Total Range = Range1 + Range2 = 23400000 = 6 hours and 30 minutes
.: Currently only two intervals (two configurations) which can be applied, if only 1 interval needed, then set the Range2 = 0 or Interval1 = Interval2