Status Codes
Reference for all delivery status and error codes returned by TeamMessage. These codes appear in delivery reports and the SMS log.
SMS-Statuscodes
Der Statuscode zeigt den Zustellstatus einer SMS an:
| Code | Status | Beschreibung |
|---|---|---|
-1 |
Zugestellt | SMS erfolgreich gesendet |
0 |
Zugestellt | SMS erfolgreich an Empfänger zugestellt |
1 |
Zwischengespeichert | SMS im System des Netzbetreibers (SMSC) zwischengespeichert |
2 |
Fehlgeschlagen | SMS-Zustellung fehlgeschlagen |
3 |
Angenommen | SMS an Netzbetreiber übergeben, warte auf Zustellbericht |
1001 |
Zwischengespeichert | SMS im SMSC zwischengespeichert |
1002 |
Fehlgeschlagen | SMS konnte noch nicht zugestellt werden |
1003 |
Fehlgeschlagen | SMS konnte über mehrere Tage nicht zugestellt werden |
Häufige Reason-Codes
Reason-Codes liefern zusätzliche Details zu Fehlern. Hier sind die häufigsten:
Ungültige Nummer
| Code | Grund |
|---|---|
-13 |
Ungültiges Mobilnummer-Format |
-12 |
Nummer aus nicht unterstütztem Netz |
-2 |
Ungültige Mobilnummer |
0 |
Unbekannter Teilnehmer (Nummer nicht gefunden) |
101 |
Unbekannte Teilnehmernummer (MSISDN) |
206 |
Ungültige Zieladresse – vom Netzbetreiber abgelehnt |
Teilnehmer nicht erreichbar
| Code | Grund |
|---|---|
107 |
Telefon ausgeschaltet oder außerhalb der Netzabdeckung |
160 |
Teilnehmer temporär nicht erreichbar (Roaming) |
162 |
Gerät antwortet nicht |
512 |
Nachricht abgelaufen – nicht innerhalb der Gültigkeitsdauer zugestellt |
Zustellung blockiert
| Code | Grund |
|---|---|
103 |
Anrufsperre – Zustellung vom Netzbetreiber blockiert |
104 |
Operation vom Netzbetreiber gesperrt |
517 |
SMS wegen nicht autorisiertem Inhalt blockiert |
518 |
Ziel für dieses Konto nicht erlaubt |
623 |
Ziel auf Blacklist |
Technische Fehler
| Code | Grund |
|---|---|
1-8 |
Dienst vorübergehend nicht verfügbar |
10 |
Netzwerk-Zeitüberschreitung |
50 |
Zustellung fehlgeschlagen – Gerät nicht erreichbar |
105, 109, 113 |
Überlastung im Service-Center |
118 |
Systemfehler im Zielnetzwerk |
Kontoprobleme
| Code | Grund |
|---|---|
622 |
Guthaben nicht ausreichend (Prepaid) |
1628 |
Ungültiges Konto |
1662 |
Drosselungsfehler – Rate-Limit überschritten |
Sprachanruf-Status (SIP)
Für SMS-to-Voice (Text-to-Speech-Anrufe) werden diese SIP-Response-Codes verwendet:
| Code | Status | Beschreibung |
|---|---|---|
200 |
OK | Anruf angenommen, Nachricht erfolgreich zugestellt |
404 |
Nicht gefunden | Nummer unbekannt |
408 |
Zeitüberschreitung | Keine Antwort – Zeitüberschreitung |
480 |
Nicht erreichbar | Vorübergehend nicht verfügbar |
486 |
Besetzt | Leitung besetzt |
487 |
Beendet | Anruf beendet |
488 |
Nicht akzeptabel | Codec-Problem |
604 |
Existiert nicht | Nummer existiert nicht |
Hinweis
Sprachanrufe werden automatisch wiederholt, wenn nicht angenommen. Das Statusfeld zeigt die Anzahl der Versuche.
Statusgruppen
Im SMS-Protokoll werden Zustellstatus in drei Kategorien gruppiert:
| Gruppe | Farbe | Bedeutung |
|---|---|---|
| Erfolg | ● | Nachricht an Empfänger zugestellt |
| Ausstehend | ● | Warte auf Zustellbestätigung vom Netzbetreiber |
| Fehlgeschlagen | ● | Zustellung fehlgeschlagen – prüfen Sie den Reason-Code für Details |
API-Antwortcodes
Die Legacy-HTTP-API gibt diese Antwortcodes zurück:
| Code | Bedeutung |
|---|---|
+1 |
Erfolg – SMS zur Zustellung angenommen |
-1 |
Ungültige Team-ID |
-2 |
Ungültiger Teamname |
-3 |
Ungültige Absender-E-Mail |
-4 |
Nachricht zu kurz |
-5 |
Keine Nachricht angegeben |
-10 |
Konto nicht gefunden |
-11 |
SMS-Versand gesperrt |
-12 |
IP-Adresse nicht in Whitelist |
See Legacy HTTP für die vollständige API-Dokumentation.
Fehlerbehebung nach Code
Häufige Probleme und ihre Lösungen:
Code 0 / 101: Unbekannter Teilnehmer
- Überprüfen Sie, ob die Telefonnummer korrekt ist
- Die Nummer wurde möglicherweise abgeschaltet
- Versuchen Sie es mit dem internationalen Format (+49...)
Code 107: Telefon aus oder kein Empfang
- Das Telefon des Empfängers ist ausgeschaltet
- Nachricht wird zugestellt, wenn das Telefon wieder online ist (innerhalb der Gültigkeitsdauer)
Code 512: Nachricht abgelaufen
- Die Gültigkeitsdauer der Nachricht ist vor der Zustellung abgelaufen
- Standard-Gültigkeitsdauer ist 48 Stunden
- Das Telefon des Empfängers war zu lange ausgeschaltet
Code 622: Guthaben nicht ausreichend
- Laden Sie Ihr SMS-Guthaben auf
- Prüfen Sie Ihr Guthaben im Portal
Für weitere Hilfe siehe Fehlerbehebung.