Push Final Status to Client Server
Customer must create a Get or Post service to receive the push notification from us.
if you URL string supplied to us contains a ? or the letters GET in the URL string we will send the message to you via http GET method, otherwise we will send it to you via http POST method.
If you are using GET you must supply the full Get string needed to call the service that includes the parameter names and our Replace TAG names below
This push URL must then be configured by Intelli Messaging against your user Sender record.
Table "Possible Returned Parameters" for each method
Possible parameters we can send you with when we call your service are in the table below
The Name column is our Value replacement tags.
You may name you service parameters as you wish, except you can NOT use the replacement tag names in the table below as your parameter names.
Post Parameter Name | Replacement TAG Name | Meaning |
status | STATUSP | Final Status of the MT message as a Status Code |
messageId | MESSAGEIDP | Message DocumentId of the MT message that the status is for |
finalStatusSet | RECEIVEDP | Time the Final status was received by the MC5 message server |
recipient | FROMP | From (source) address of the MT message, international format without the + sign |
sender | RECIPIENTP | To (recipient) address of the MT message, international format without the + sign |
TEXTP | Content of MT message | |
STATUSNAMEP | Final Status as name | |
cRef | CREF | The customer MessageId for the MT message. For this work the customer must provide a Id for there message when sent to us and the appSender must have flag set SupplyOwnMessageRef |
sent | Date time message was sent to you | |
documentId | if multiple message send method was used to send the message this id is the returned documentId from that sending process |
Send use you full http Get string - example below
https://mydomain.com/ReceiveDLR?status=STATUSP&messageId=MESSAGEIDP&from=FROMP&to=RECIPIENTP
we will configure this value against your account.
Message Status Codes
Final Status Codes
Status code | StatusName | Final or Interim | Meaning | When? |
0 | DELIVRD | Final | Unknown | Message with the given id not found. It is possible that the message was submitted, but not yet processed by a worker. Or that such a message doesn't exist. |
1 | DELPUSH | Interim | PushMg Deliver | Push message is delivered |
2 | DELIVRD | Final | Delivered | SMS Message was sent and Delivery Receipt was received |
3 | EXPIRED | Final | Expired | Message delivery failed and message expired (SMSC will no longer try to deliver it). Normally set by SMSC after 48 hours of attempting to send a message to a recipient. |
4 | DELETED | Deleted | Message is deleted. | |
5 | UNDELIV | Final | Undeliverable | Last event is "not routable". There's no bind (even among inactive ones) that can accept the message. |
7 | Final | Invalid | Last event is "validation failed" (wrong text, recipient, etc.) | |
8 | REJECTD | Final | Rejected | Message rejected by SMSC |
10 | Interim | Submitted | Last event is "request received". Interim status meaning we have not yet routed the message. May be temporarily not routable. | |
11 | ACCEPTD | Interim | Sent | Last event is "sent" - interim status meaning that we are waiting final delivery status from the SMSC. |
12 | UNROUTD | Final | Unroutable | Message not send as for some reason it cannot be routed |
15 | BLOCKED | Final | Blocked | Mainly due destination being opted out. |
999 | UNKNOWN | Final |
Main Reasons for “Rejected” Message Status
1. Invalid Source Address
2. Invalid Destination Address
3. Content not allowable
4. Spam – same message sent many times to the one destination address in a short period of time.
Main Reasons for “Undeliverable” Status
This means that the message did not meet our routing criteria and means one of the following
- We do not support routing to the country of the recipient
- The number prefix does not define a valid country destination
- The number prefix does not exist in the destination country
- The source address in not valid or allowed