Delivery Reports - Kannel WAP and SMS gateway User Manual

Chapter 9. Delivery Reports
This chapter explains how to set up kannel to deliver delivery reports.
Delivery reports are a method to tell your system if the message has arrived on the destination phone.
There are different things which can happen to a message on the way to the phone which are:
Message gets rejected by the SMSC (unknown subscriber, invalid destination number etc).
•
Message gets accepted by the SMSC but the phone rejects the message.
•
Message gets accepted by the SMSC but the phone is off or out of reach. The message gets buffered.
•
Message gets successfully delivered.
•
When you deliver SMS to Kannel you have to indicate what kind of delivery report messages you would
like to receive back from the system. The delivery report types currrently implemented are:
1: delivery success
•
2: delivery failure
•
4: message buffered
•
8: smsc submit
•
16: smsc reject
•
If you want multiple report types, you simply add the values togeter. For example if you want to get
delivery success and/or failure you set the dlrmask value to 1+2. and so on. If you specify dlrmask on the
URL you pass on to kannel you also need to specify dlrurl. dlrurlshould contain the URL to which kannel
should place a HTTP requests once the delivery report is ready to be delivered back to your system.
An example transaction would work as following.
1. you send a message using dlrmaks=7 and dlrurl=www.xyz.com/cgi/dlr.php?type=%d
•
2. Kannel forwards the message to the SMSC and keeps track of the message
•
3. The SMSC can not reach the phone and thus returns a buffered message
•
4. Kannel calls http://www.xyz.com/cgi/dlr.php?type=4 to indicate the message being buffered
•
5. The phone is switched on and the SMS gets delivered from the SMSC. The SMSC reports this to
•
Kannel
4. Kannel calls http://www.xyz.com/cgi/dlr.php?type=2 to indicate the final success
•
Depending on the SMSC type not all type of messages are supported. For example a CIMD SMSC does
not support buffered messages. Also some SMSC drivers have not implemented all DLR types.
92