Zustellberichte & SMS-Status
Ein Zustellbericht — auch Delivery Report oder DLR genannt — ist die Rückmeldung des Netzes darüber, was mit Ihrer Nachricht geschehen ist. Der wichtigste Unterschied: Sent bedeutet, dass die Nachricht an den Betreiber übergeben wurde, Delivered, dass sie tatsächlich auf dem Gerät angekommen ist. Nur Letzteres ist eine Bestätigung.
Unten finden Sie jeden Statuscode, den SMSBOX zurückgibt, was er bedeutet und was Sie tun können.
Alle Statuscodes und ihre Bedeutung
| Code | Status | Was es bedeutet | Was Sie tun können |
|---|---|---|---|
10 | Sent | Die Nachricht wurde an das Netz des Betreibers übergeben. | Abwarten — dies ist ein Zwischenstatus, keine Zustellbestätigung. |
11 | Delivered | Die Nachricht ist auf dem Gerät des Empfängers angekommen. | Nichts. Das ist der Endstatus, den Sie sehen möchten. |
12 | Buffered | Angenommen, aber noch nicht zustellbar — das Gerät ist ausgeschaltet oder außer Reichweite. | Abwarten. Das Netz versucht es erneut, solange die Gültigkeitsdauer läuft. |
13 | Undelivered | Das Netz konnte die Nachricht nicht zustellen, zum Beispiel weil die Nummer nicht mehr existiert. | Prüfen Sie die Nummer. Kommt das häufig vor, bereinigen Sie Ihre Liste mit einem Bulk-HLR. |
14 | Expired | Die Gültigkeitsdauer ist abgelaufen, ohne dass das Gerät erreichbar wurde. | Zu einem anderen Zeitpunkt erneut senden oder die Nummer als inaktiv markieren. |
15 | Rejected | Das Netz hat die Nachricht abgelehnt — zum Beispiel wegen eines nicht zugelassenen Absendernamens oder als Spam eingestuften Inhalts. | Prüfen Sie Ihren Absender und den Text. Nicht wiederholt senden: Das schadet Ihrem Ruf beim Betreiber. |
16 | Unknown | Das Netz gibt keine Auskunft. Manche ausländischen Betreiber liefern schlicht keine zuverlässige Rückmeldung. | Betrachten Sie dies nicht als Fehler. Im Zweifel prüfen Sie die Nummer separat. |
20 | Blacklist | Die Nummer steht auf einer Sperrliste und erhält keine Nachrichten mehr von Ihnen — meist nach einer Abmeldung. | Entfernen Sie die Nummer aus Ihrer Liste. Weiter zu senden kostet Credits und bringt nichts. |
21 | LowBalance | Nicht genügend Credits auf Ihrem Konto, um die Nachricht zu senden. | Laden Sie auf oder aktivieren Sie die automatische Aufladung und eine Guthabenwarnung. |
01 | Error | Bei der Verarbeitung der Nachricht ist etwas schiefgelaufen. | Sehen Sie im Tracelog die rohe Anfrage und Antwort ein oder kontaktieren Sie den Support mit der Nachrichten-ID. |
Endstatus, erfolgreich Zwischenstatus oder unentschieden nicht zugestellt, Handlung nötig
Der Weg, den Ihre Nachricht zurücklegt
Sie senden
Über das Dashboard, einen Excel-Import, E-Mail oder die REST-API. Die Nachricht erhält eine eindeutige Nachrichten-ID.
Wir leiten weiter
SMSBOX routet die Nachricht an den Betreiber des Empfängers. Der Status wird Sent.
Der Betreiber stellt zu
Ist das Gerät ausgeschaltet, bleibt die Nachricht in der Warteschlange: Buffered.
Das Netz meldet zurück
Der Endstatus trifft ein: Delivered oder einer der oben genannten Fehlerstatus.
Zwischen Schritt 2 und 4 kann Zeit vergehen. Eine Nachricht, die nach einigen Sekunden noch auf Sent steht, ist also nicht fehlgeschlagen — sie wartet auf die Rückmeldung des Netzes.
Status in Ihrem eigenen System
Im Dashboard sehen Sie den Status jeder gesendeten Nachricht ein. Arbeiten Sie über die API, müssen Sie dort nicht ständig abfragen: Geben Sie beim Senden eine Benachrichtigungs-URL mit und wir senden jede Statusänderung per HTTP POST an diese Adresse.
Dieser POST enthält die Nachrichten-ID und den Statuscode aus der Tabelle oben. So halten Sie Ihre eigene Datenbank aktuell und können sofort reagieren — einen Kunden bei Undelivered anrufen oder eine Nummer bei Blacklist markieren.
So halten Sie Ihre Zustellrate hoch
Die meisten fehlgeschlagenen Nachrichten lassen sich vermeiden. Eine Liste, die seit Jahren besteht, enthält zwangsläufig Nummern, die nicht mehr existieren — und jeder Versand dorthin kostet Credits ohne Ergebnis.