Afleverrapporten & SMS-statussen
Een afleverrapport — ook delivery report of DLR genoemd — is de terugmelding van het netwerk over wat er met uw bericht gebeurd is. Het belangrijkste onderscheid: Sent betekent dat het bericht is doorgegeven aan de operator, Delivered dat het effectief op het toestel is aangekomen. Alleen dat laatste is een bevestiging.
Hieronder staat elke statuscode die SMSBOX teruggeeft, wat ze betekent en wat u eraan kunt doen.
Alle statuscodes en hun betekenis
| Code | Status | Wat het betekent | Wat u eraan doet |
|---|---|---|---|
10 | Sent | Het bericht is doorgegeven aan het netwerk van de operator. | Afwachten — dit is een tussenstatus, geen bevestiging van aflevering. |
11 | Delivered | Het bericht is aangekomen op het toestel van de ontvanger. | Niets. Dit is de eindstatus die u wilt zien. |
12 | Buffered | Aanvaard maar nog niet afleverbaar — het toestel staat uit of is buiten bereik. | Afwachten. Het netwerk probeert opnieuw zolang de geldigheidsduur loopt. |
13 | Undelivered | Het netwerk heeft het bericht niet kunnen afleveren, bijvoorbeeld omdat het nummer niet meer bestaat. | Controleer het nummer. Komt dit vaak voor, schoon dan uw lijst op met een bulk-HLR. |
14 | Expired | De geldigheidsduur is verstreken zonder dat het toestel bereikbaar werd. | Opnieuw versturen op een ander moment, of het nummer als inactief markeren. |
15 | Rejected | Het netwerk heeft het bericht geweigerd — bijvoorbeeld wegens een niet-toegelaten afzendernaam of als spam beoordeelde inhoud. | Controleer uw afzender en de tekst. Blijf niet herhalen: dat schaadt uw reputatie bij de operator. |
16 | Unknown | Het netwerk geeft geen uitsluitsel. Sommige buitenlandse operatoren leveren simpelweg geen betrouwbare rapportering. | Beschouw dit niet als een fout. Twijfelt u, controleer het nummer dan apart. |
20 | Blacklist | Het nummer staat op een blokkeerlijst en ontvangt geen berichten meer van u — meestal na een afmelding. | Verwijder het nummer uit uw lijst. Blijven versturen kost credits en levert niets op. |
21 | LowBalance | Onvoldoende credits op uw account om het bericht te versturen. | Laad bij, of schakel automatische opwaardering en een saldowaarschuwing in. |
01 | Error | Er ging iets mis bij de verwerking van het bericht. | Raadpleeg de tracelog voor het ruwe verzoek en antwoord, of contacteer support met het bericht-ID. |
eindstatus, geslaagd tussenstatus of onbeslist niet afgeleverd, actie nodig
De weg die uw bericht aflegt
U verstuurt
Via het dashboard, een Excel-import, e-mail of de REST API. Het bericht krijgt een uniek bericht-ID.
Wij geven door
SMSBOX routeert het bericht naar de operator van de ontvanger. Status wordt Sent.
De operator levert af
Staat het toestel uit, dan blijft het bericht in wachtrij staan: Buffered.
Het netwerk meldt terug
De eindstatus komt binnen: Delivered, of een van de foutstatussen hierboven.
Tussen stap 2 en 4 kan tijd zitten. Een bericht dat na enkele seconden nog op Sent staat, is dus niet mislukt — het wacht op de terugmelding van het netwerk.
Statussen in uw eigen systeem
In het dashboard raadpleegt u de status bij elk verzonden bericht. Werkt u via de API, dan hoeft u daar niet naar te blijven pollen: geef bij het versturen een notificatie-URL mee en wij sturen elke statuswijziging via een HTTP POST naar dat adres.
Die POST bevat het bericht-ID en de statuscode uit de tabel hierboven. Zo houdt u uw eigen database actueel en kunt u er meteen op reageren — een klant opbellen bij een Undelivered, of een nummer markeren bij een Blacklist.
Zo houdt u uw aflevergraad hoog
De meeste mislukte berichten zijn te voorkomen. Een lijst die jaren meegaat, bevat onvermijdelijk nummers die niet meer bestaan — en elke verzending daarnaartoe kost credits zonder resultaat.
