Statuscodes

Referenz für alle Zustell- und Fehlercodes von TeamMessage. Diese Codes erscheinen in Zustellberichten, Webhooks und im SMS-Protokoll.

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

Legacy API (sendtmsg.php)

The legacy HTTP API returns these response codes for backwards compatibility:

Code Bedeutung
+1 Erfolg – SMS zur Zustellung angenommen
-10 Account not found – check tm, tn, ky parameters
-11 SMS-Versand gesperrt oder ungültige Telefonnummer
-12 IP-Adresse nicht in Whitelist
-13 Rate limit exceeded

REST API (/api/v1/sms/)

Version 1.1 (2026-01)

The REST API returns specific error codes for better debugging.

Code Parameter Bedeutung
+1 — Erfolg – SMS zur Zustellung angenommen
-1 team_id Missing or invalid – must be a numeric customer number
-2 teamlist_email Missing or invalid – must be a valid team list address
-5 message Missing or too long (maximum 1600 characters)
-6 to_mobile Missing or invalid – phone number must have 7-20 digits
-10 — Account not found – team list doesn't exist, or keyword is incorrect
-11 — SMS-Versand gesperrt
-12 — IP-Adresse nicht in Whitelist
-13 — Rate limit exceeded

Siehe 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.

Menü