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


TEXTPContent of MT message

STATUSNAMEPFinal Status as name
cRefCREFThe 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.

4DELETED
DeletedMessage 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.

12UNROUTDFinalUnroutableMessage not send as for some reason it cannot be routed 
15BLOCKEDFinalBlockedMainly due destination being opted out.
999UNKNOWNFinal

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

  1.  We do not support routing to the country of the recipient
  2. The number prefix does not define a valid country destination
  3. The number prefix does not exist in the destination country
  4. The source address in not valid or allowed