If you are using the API / Gateway to send bulk SMS you can collect your= delivery reports from the server, which is a good way of removing bad numb= ers from your data.
It is important to understand the difference between getting a =E2=80=9C= failure=E2=80=9D (or success) message at the API/Gateway and a delivery rep= ort.
The HTTP GET response from the gateway only confirms that the number and= message appear to be in the correct format this does not mean that the num= ber exists.
Delivery reports confirm to you what has actually happened to the messag= e, the following outcomes are possible:
=E2=80=9CDELIVERED=E2=80=9D,=E2=80=9DREJECTED=E2=80=9D,=E2=80=9DFAILED=E2=80=9D,"NO=
T-UK",=E2=80=9DPENDING=E2=80=9D and no
| Parameter | Meaning |
|---|---|
| Delivered | The message has been delivered to the handset .<= /td> |
| Rejected | Rejected by the relevant operator and did not= attempt to deliver it |
| Failed | The number isn't in use, but may have been an= d might be again in the future. |
| Not-uk | Trying to send a non UK number when your acco= unt isn't internationally enabled. |
| Pending | Waiting for the report from the networks. Can= take up to 3 days |
See our RESTful= services which offer a comprehensive and simplified method to collect = your delivery reports. We recommend that you use this approach.
We can push the delivery reports via a GET request to a url of your choi= ce. Log into Message Box and navigate to =E2=80=9CAccount Settings = =3D> API Config" tab and see the Report url field.
| Parameter | Data Type | Detail |
|---|---|---|
| id | INT | The message id that relates to the id from th= e send, you must use this id to match the original send not the msisdn <= /td> |
| delivered_date | TIMESTAMP(INT) | Date of delivery +- 2 mins |
| processed_date | TIMESTAMP(INT) | Ignore, internal test date |
| status | STRING | The delivery status as above |
| msisdn | INT | Mobile number of the handset |
This view shows volume grouped by the custom parameter and the month whi= ch you included with in your API send (via rest or simple API). Click Analy= tics from the main menu.