---
title: "SMS-Zustellfehler"
description: "Schlagen Sie SMS-Fehlerursachen und numerische Anbietercodes nach, einschließlich Betrugsschutz-Blockierungen, in Nachrichtendetails, Zustellbestätigungen und Webhooks."
canonical: "https://bird.com/de-de/dokumentation/guides/sms/delivery-errors"
---

# 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](/docs/api/errors). 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](/docs/guides/sms/sms-log) 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}`](/docs/api/reference/get-sms-message). 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](/docs/guides/sms/events#failure-events) und [Nachrichten-Timeline-Events](/docs/api/reference/list-sms-message-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](/docs/api/reference/get-sms-message) 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](#provider-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](/docs/guides/sms/sms-log): eine Nachricht und ihren Zustellverlauf einsehen.
- [SMS-Ereignisse](/docs/guides/sms/events): Zustell- und Fehler-Webhooks konsumieren.
- [SMS-Metriken](/docs/guides/sms/tracking-and-metrics): aggregierte Fehlerergebnisse prüfen.
- [SMS-API-Fehler](/docs/api/errors/E12xxx): Fehler interpretieren, die von einer API-Anfrage zurückgegeben werden.

## Related resources

- [Sending your first SMS](/learn/sms/sending-your-first-sms) (video)
- [What does SMS mean?](/explained/sms/what-does-sms-mean) (answer)
- [SMS](/sms-api) (product)
- [Build your first integration](/learn/paths/integration) (course)

[Get an implementation brief](/learn/workspace?topic=sms)