SMS-Zustellfehler
Eine fehlgeschlagene SMS-Nachricht enthält einen Zustellstatus und einen Fehler, der das Ergebnis beschreibt. Verwenden Sie diese Referenz, um die Fehlerursache und den numerischen Anbietercode zu interpretieren, die mit einer Nachricht gemeldet werden.
Anfragefehler wie ein ungültiger Sende-Payload verwenden den API-Fehlerkatalog. Die Codes auf dieser Seite beschreiben Nachrichten, die angenommen und später fehlgeschlagen oder abgelehnt wurden.
Den Fehler lesen
Öffnen Sie eine Nachricht im SMS-Protokoll und wählen Sie Details. Error zeigt die Beschreibung und die normalisierte Fehlerursache. Carrier error code zeigt den numerischen Anbietercode, sofern einer übermittelt wurde.
Über die API lesen Sie GET /v1/sms/messages/{message_id}. Das last_error enthält:
| Feld | Bedeutung |
|---|---|
code | Normalisierte Fehlerursache von Bird, z. B. unreachable oder unknown |
description | Die gemeldete Erklärung in Worten |
carrier_error_code | Der Rohcode des Anbieters, sofern übermittelt |
occurred_at | Wann der Fehler aufgetreten ist |
Fehler-Webhook-Events und Nachrichten-Timeline-Events enthalten dieselben Felder in error.
Der Feldname carrier_error_code umfasst auch Codes, die vom Sendeanbieter von Bird stammen, einschließlich Betrugsschutz-Sperren. Ein fehlender Code bedeutet, dass der Anbieter keinen übermittelt hat oder die Nachricht vor dem Versand abgelehnt wurde.
Normalisierte Fehlerursachen
Dies sind die Fehlerursachen, die im Nachrichten-API definiert sind. Anbieterquittungen können einen spezifischeren numerischen Code enthalten, als die normalisierte Ursache widerspiegelt. Beispielsweise kann eine Nachricht mit code: unknown trotzdem einen bekannten carrier_error_code enthalten.
| Ursache | Bedeutung |
|---|---|
invalid_destination | Die Nummer ist nicht vergeben oder ungültig |
unreachable | Das Gerät ist ausgeschaltet oder außerhalb des Empfangsbereichs |
blocked_by_carrier | Der empfangende Netzbetreiber hat die Nachricht gefiltert |
blocked_by_fraud_protection | Der Bird-Betrugsschutz hat mutmaßliches SMS-Pumping blockiert |
blocked_by_recipient | Das Gerät des Empfängers hat den Absender blockiert |
landline_unreachable | Der Festnetzanschluss empfängt keine SMS |
content_rejected | Der Netzbetreiber hat den Inhalt abgelehnt |
sender_unregistered | Dem Absender fehlt eine erforderliche Registrierung |
recipient_opted_out | Der Empfänger steht auf einer Unterdrückungsliste |
provider_unavailable | Der Anbieter oder das Netz war nicht verfügbar |
insufficient_balance | Das Workspace-Guthaben reichte für den Versand nicht aus |
unknown | Der Fehler konnte nicht klassifiziert werden |
Dies ist eine offene Menge: Akzeptieren Sie unbekannte Werte und bewahren Sie die Beschreibung und den Rohcode für die Untersuchung auf. Eine vorübergehende Ursache beendet trotzdem diesen Zustellversuch; sie garantiert keine automatische erneute Übermittlung.
Provider-Fehlercodes
Schlagen Sie die numerische Zeichenkette nach, die in carrier_error_code zurückgegeben wird. Diese Codes gehören zum SMS-Versandprovider von Bird; ein anderer Provider kann denselben Nummern andere Bedeutungen zuweisen.
| Code | Bedeutung |
|---|---|
0 | Kein Fehler |
1 | Unbekannter Teilnehmer |
2 | Unbekannte Basisstation |
3 | Unbekannte Vermittlungsstelle |
5 | Nicht identifizierter Teilnehmer |
7 | Endgerät kann keine Verbindung herstellen |
8 | Roaming nicht erlaubt |
9 | Teilnehmerauthentifizierung fehlgeschlagen |
10 | SMS-Bearer nicht bereitgestellt |
11 | SMS-Dienst nicht bereitgestellt |
12 | Endgerät auf Sperrliste |
13 | SMS-Dienst gesperrt |
21 | SMS nicht unterstützt |
26 | Netzwerk-Handover fehlgeschlagen |
27 | Teilnehmer nicht erreichbar |
28 | Außerhalb des Empfangsbereichs |
29 | Endgerät ausgeschaltet |
30 | Vermittlungsstellenfehler |
31 | Teilnehmer besetzt |
32 | SMS-Zustellungsfehler |
33 | Speicher für ausstehende Nachrichten voll |
34 | Netzwerksystemfehler |
35 | Erforderliche Daten fehlen |
36 | Unerwarteter Wert im Nachrichtenfeld |
39 | Roaming-Routing-Nummer nicht verfügbar |
40 | Netzwerkspeicher erschöpft |
71 | Nicht unterstütztes Alphabet |
72 | USSD belegt |
100 | Sendeguthaben unzureichend |
101 | Teilnehmerguthaben unzureichend |
103 | Teilnehmer hat sich abgemeldet |
104 | Absender nicht registriert |
105 | Inhalt nicht registriert |
106 | Kampagnenvolumen überschritten |
107 | Kampagnendurchsatz überschritten |
110 | Nachricht vom Betreiber gefiltert |
130 | SurgeGuard hat Traffic Pumping erkannt |
131 | SurgeGuard hat verdächtiges Pumping-Ziel blockiert |
Code 0 wird bei Bird-Nachrichten- und Ereignisabfragen aus carrier_error_code ausgelassen. Ein unbekannter Code sollte in Ihren Aufzeichnungen verfügbar bleiben, wenn Sie den Support kontaktieren.
Betrugsschutz-Blockierungen
SurgeGuard ist der SMS-Betrugsschutz von Bird.
Von der Betrugserkennung blockierte Nachrichten haben den Fehlergrund blocked_by_fraud_protection und die Beschreibung "Blocked by fraud protection: suspected SMS pumping." Der Zustellstatus bleibt failed, rejected oder expired, entsprechend dem Bericht des Anbieters. Derselbe Grund und dieselbe Beschreibung erscheinen in den Nachrichtendetails, Timeline-Ereignissen und Fehler-Webhooks. Der rohe Anbietercode bleibt in carrier_error_code verfügbar, sofern er übermittelt wurde.
Filtern Sie im SMS-Log den Failure reason nach Blocked by fraud protection, um diese Nachrichten zu finden.
Ältere Einträge zeigen möglicherweise noch unknown und generic_delivery_failure. Diese Bezeichnungen allein identifizieren keinen Betrugsschutzblock. Schlagen Sie den zugehörigen carrier_error_code unter Anbieter-Fehlercodes nach, um die Ursache zu ermitteln. Falls der Code fehlt oder unbekannt ist, wenden Sie sich mit Workspace-ID, Nachrichten-ID, Zeitstempel und Anbietercode (sofern vorhanden) an den Support.
Wenn Sie eine blockierte OTP-Nachricht untersuchen, ordnen Sie den SMS dem Konto oder der Verifizierungsanfrage zu, die ihn ausgelöst hat. Vermeiden Sie automatisches erneutes Senden oder Routenwechsel, um die Blockierung zu umgehen. Falls Sie vermuten, dass eine legitime Anfrage blockiert wurde, wenden Sie sich mit Workspace-ID, Nachrichten-ID, Zeitstempel und Anbietercode an den Support.
Nächste Schritte
- SMS-Log: eine Nachricht und ihren Zustellverlauf einsehen.
- SMS-Ereignisse: Zustell- und Fehler-Webhooks konsumieren.
- SMS-Metriken: aggregierte Fehlerergebnisse prüfen.
- SMS-API-Fehler: Fehler interpretieren, die von einer API-Anfrage zurückgegeben werden.
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.