Fehlerbehebung
Lösungen für häufige Probleme beim Senden und Empfangen von Nachrichten. Finden Sie Ihr Problem unten und befolgen Sie die Schritte zur Lösung.
SMS nicht zugestellt
Nachricht zeigt Status 'Fehlgeschlagen'
Prüfen Sie den Reason-Code in Ihrem SMS-Log für Details. Häufige Ursachen:
- Code 0 / 101 (Unbekannter Teilnehmer): Die Telefonnummer existiert nicht oder wurde abgeschaltet. Überprüfen Sie, ob die Nummer korrekt und aktiv ist.
- Code 107 (Telefon aus): Das Telefon des Empfängers ist ausgeschaltet oder außerhalb der Reichweite. Die Nachricht wird zugestellt, wenn es wieder eingeschaltet wird (innerhalb 48 Stunden).
- Code 512 (Nachricht abgelaufen): Das Telefon des Empfängers war mehr als 48 Stunden nicht erreichbar. Versuchen Sie es erneut.
- Code 622 (Guthaben nicht ausreichend): Ihr SMS-Guthaben ist aufgebraucht. Laden Sie Ihr Konto im Portal auf.
Siehe Statuscodes für eine vollständige Referenz.
Nachricht zeigt lange 'Ausstehend' an
Warte auf Zustellbestätigung vom Netzbetreiber
- Das Telefon des Empfängers ist ausgeschaltet
- Das Netzwerk des Netzbetreibers überlastet ist
- Der Empfänger in einem Gebiet mit eingeschränkter Konnektivität roamt
Nachrichten werden normalerweise innerhalb weniger Stunden zugestellt. Wenn nach 24 Stunden noch ausstehend, wird die Zustellung wahrscheinlich mit Code 512 (abgelaufen) fehlschlagen.
Nachricht gesendet aber Empfänger hat sie nicht erhalten
Wenn Ihr Log 'Zugestellt' zeigt, aber der Empfänger behauptet, sie nicht erhalten zu haben:
- Überprüfen Sie, ob Sie an die richtige Telefonnummer gesendet haben
- Bitten Sie den Empfänger, seinen Spam-/Blockiert-Ordner zu prüfen
- Manche Telefone haben aggressive Spam-Filter – bitten Sie darum, die Absenderkennung zu den Kontakten hinzuzufügen
- Prüfen Sie, ob der Mobilfunkanbieter des Empfängers bestimmte Nachrichtentypen blockiertPrüfen Sie, ob der Netzbetreiber des Empfängers bestimmte Nachrichtentypen blockiertPrüfen Sie, ob der Netzbetreiber des Empfängers bestimmte Nachrichtentypen blockiertPrüfen Sie, ob der Netzbetreiber des Empfängers bestimmte Nachrichtentypen blockiert
E-Mail zu SMS funktioniert nicht
E-Mail gesendet aber keine SMS zugestellt
Prüfen Sie diese häufigen Probleme:
- Falsche E-Mail-Adresse: Setzen Sie die Kontakt-E-Mail auf Ihre TeamMessage-Adresse (z.B. meinteam-alerts@tmsg.de)
- Absender nicht autorisiert: Wenn Ihre Teamliste autorisierte Absender konfiguriert hat, muss Ihre E-Mail-Adresse auf der Liste stehen. Prüfen Sie Ihre Teamlisten-Einstellungen.
- Keyword fehlt oder ist falsch: Wenn Ihre Teamliste ein Keyword erfordert, fügen Sie es am Anfang der Betreffzeile genau wie konfiguriert ein.
- E-Mail vom Spam-Filter blockiert: TeamMessage hat einen Spam-Schutz. Stellen Sie sicher, dass Ihre E-Mail von einem seriösen Server mit korrekten SPF/DKIM-Einträgen stammt.
Nur ein Teil der Nachricht wurde zugestellt
E-Mail zu SMS extrahiert den Text aus Ihrer E-Mail. Einige Formatierungen können entfernt werden:
- HTML-Formatierung wird entfernt, nur Klartext wird verwendet
- Signaturen und Haftungsausschlüsse werden typischerweise entfernt
- Sehr lange Nachrichten werden gekürzt (SMS hat Zeichenbegrenzungen)
Tipp
Für beste Ergebnisse senden Sie Klartext-E-Mails und halten Sie Nachrichten kurz. Wichtige Informationen an den Anfang setzen.
Anhänge nicht zugestellt
SMS kann keine Anhänge übertragen. Nur der Textinhalt Ihrer E-Mail wird in SMS konvertiert. Für Dokumente:
- Nutzen Sie E-Mail zu Fax, wenn der Empfänger ein Faxgerät hatVerwenden Sie stattdessen E-Mail zu Fax, wenn der Empfänger ein Faxgerät hatVerwenden Sie stattdessen E-Mail zu Fax, wenn der Empfänger ein Faxgerät hatVerwenden Sie stattdessen E-Mail zu Fax, wenn der Empfänger ein Faxgerät hat
- Fügen Sie einen Link zum Dokument in Ihre Nachricht ein
API-Integrationsprobleme
Hinweis
The REST API (/api/v1/sms/) returns specific error codes (-1, -2, -5, -6). The legacy API (sendtmsg.php) returns -10 for all validation errors for backwards compatibility.
Error -1: team_id missing or invalid (REST API)
The team_id parameter is required and must be your numeric customer number.
- Verify you're using your 6-digit customer number
- The team_id must be numeric, not alphanumeric
- Example: team_id=100042
Error -2: teamlist_email missing or invalid (REST API)
The teamlist_email parameter is required and must be a valid team list address.
- Check the exact email address of your team list (e.g., myteam@tmsg.de)
- The address must match the one configured in your account
Error -5: message missing or too long (REST API)
The message parameter is required and has length limits.
- Message cannot be empty
- Maximum length is 1600 characters (10 SMS segments)
- Make sure special characters are properly URL-encoded
Error -6: to_mobile missing or invalid (REST API)
The to_mobile parameter is required when sending to specific recipients.
- Phone numbers must have 7-20 digits
- Use international format: +4917012345678 or 004917012345678
- Multiple numbers can be separated by commas
Fehler -10: Konto nicht gefunden
The team list was not found or authentication failed.
Hinweis
The legacy API (sendtmsg.php) returns -10 for all validation errors for backwards compatibility. For specific error codes, use the REST API (/api/v1/sms/).
- The combination of team_id and teamlist_email must be valid
- If your list requires a keyword, verify the ky parameter is correct
- Ensure URL access is enabled for the team list
Beispiel
curl "https://www.teammessage.de/mbr/sendtmsg.php?tm=100042&tn=myteam@tmsg.de&ky=secret&msg=Test"
Fehler -11: SMS-Versand gesperrt
Dieser Fehler tritt auf, wenn:
- Ihr Konto wurde gesperrt (kontaktieren Sie den Support)
- Die Teamliste ist deaktiviert
Prüfen Sie Ihre Teamlisteneinstellungen und stellen Sie sicher, dass sie aktiv ist.Prüfen Sie Ihre Teamlisten-Einstellungen und stellen Sie sicher, dass sie aktiv ist.Prüfen Sie Ihre Teamlisten-Einstellungen und stellen Sie sicher, dass sie aktiv ist.Prüfen Sie Ihre Teamlisten-Einstellungen und stellen Sie sicher, dass sie aktiv ist.
Fehler -12: IP nicht in Whitelist
Ihre Teamliste hat eine IP-Whitelist konfiguriert, aber Ihre Anfrage kam von einer nicht gelisteten IP-Adresse.
Lösungen:
- Fügen Sie Ihre IP-Adresse zur Whitelist in den Teamlisteneinstellungen hinzuFügen Sie Ihre IP-Adresse zur Whitelist in den Teamlisten-Einstellungen hinzuFügen Sie Ihre IP-Adresse zur Whitelist in den Teamlisten-Einstellungen hinzuFügen Sie Ihre IP-Adresse zur Whitelist in den Teamlisten-Einstellungen hinzuAus Sicherheitsgründen können Sie den API-Zugriff auf bestimmte IP-Adressen beschränken. Konfigurieren Sie die Whitelist in Ihren Teamlisten-Einstellungen.
- Bei Cloud-Diensten fügen Sie die IP-Bereiche des Dienstes hinzuBei Nutzung eines Cloud-Dienstes fügen Sie die IP-Bereiche des Dienstes hinzuBei Nutzung eines Cloud-Dienstes fügen Sie die IP-Bereiche des Dienstes hinzuBei Nutzung eines Cloud-Dienstes fügen Sie die IP-Bereiche des Dienstes hinzu
- Entfernen Sie die Whitelist vollständig, wenn nicht benötigt
- Use API token authentication to bypass IP whitelist
Hinweis
The whitelist supports single IPs, CIDR notation (e.g., 192.168.1.0/24), and subnet masks. IPv6 addresses are supported.
Error -13: Rate limit exceeded
You've sent too many requests in a short time.
- Wait a moment before sending more requests
- Limit: 60 requests per minute per IP address
- If you need higher limits, contact support
API meldet Erfolg aber keine SMS gesendet
Wenn Sie +1 erhalten aber keine Nachricht ankommt:
- Prüfen Sie, ob test=1 in Ihrer Anfrage enthalten ist (Testmodus sendet nicht)Prüfen Sie, ob Sie test=1 in Ihrer Anfrage enthalten haben (Testmodus sendet nicht)Prüfen Sie, ob Sie test=1 in Ihrer Anfrage enthalten haben (Testmodus sendet nicht)Prüfen Sie, ob Sie test=1 in Ihrer Anfrage enthalten haben (Testmodus sendet nicht)
- Überprüfen Sie, ob die Empfänger-Telefonnummer gültig ist
- Prüfen Sie Ihr SMS-Log im Portal für den Zustellstatus
- Stellen Sie sicher, dass Sie ausreichend SMS-Guthaben haben
Probleme mit Sprachanrufen
Anruf nicht erhalten
Wenn Sie SMS-to-Voice verwenden aber Anrufe nicht durchkommen:
- Überprüfen Sie, ob die Teamliste für Voice-Zustellung konfiguriert ist (Gateway-Einstellung)Überprüfen Sie, ob die Teamliste für Sprachzustellung konfiguriert ist (Gateway-Einstellung)Überprüfen Sie, ob die Teamliste für Sprachzustellung konfiguriert ist (Gateway-Einstellung)Überprüfen Sie, ob die Teamliste für Sprachzustellung konfiguriert ist (Gateway-Einstellung)Erstellen Sie eine separate Teamliste, die für Sprachzustellung konfiguriert ist
- Stellen Sie sicher, dass die Telefonnummer korrekt und im internationalen Format ist (+49...)
- Schauen Sie auf den Statuscode im Log (siehe SIP-Codes in der Statuscodes-Referenz)
Anruf erhalten aber kein Audio
Die Text-zu-Sprache-Konvertierung kann Probleme haben mit:
- Sehr kurzen Nachrichten (Mindestlänge erforderlich)
- Sonderzeichen oder Formatierungen
- Nicht-deutscher/nicht-englischer Text (TTS ist für diese Sprachen optimiert)Nicht-deutschem/nicht-englischem Text (TTS ist für diese Sprachen optimiert)Nicht-deutschem/nicht-englischem Text (TTS ist für diese Sprachen optimiert)Nicht-deutschem/nicht-englischem Text (TTS ist für diese Sprachen optimiert)
Anruf wiederholt sich ständig
Sprachanrufe werden automatisch wiederholt, wenn nicht angenommen. Das Statusfeld zeigt die Anzahl der Versuche.
Konto und Abrechnung
Kann keine SMS senden – kein Guthaben
Ihr Prepaid-Guthaben ist möglicherweise aufgebraucht. Prüfen Sie Ihren Kontostand im Portal und laden Sie bei Bedarf auf.
- PAUSCHAL (Flatrate): Prüfen Sie, ob Sie Ihr monatliches Kontingentüberschritten habenPAUSCHAL (Flatrate): Prüfen Sie, ob Sie Ihr monatlichesKontingent überschritten haben
- EASY (Prepaid): Kaufen Sie zusätzliches Guthaben
- PROFI (Postpaid): Kontaktieren Sie den Support, wenn der Versand blockiertistPROFI (Postpaid): Kontaktieren Sie den Support, wenn der Versandblockiert ist
Mehr SMS berechnet als erwartet
Lange Nachrichten werden in mehrere SMS-Segmente aufgeteilt:
| Kodierung | Zeichen pro SMS | Zeichen pro Segment (mehrteilig) |
|---|---|---|
| GSM 7-bit | 160 | 153 |
| Unicode (UTF-16) | 70 | 67 |
Nachrichten mit Sonderzeichen (Emojis, nicht-lateinische Schriften) verwenden Unicode-Kodierung, was die Zeichengrenze erheblich reduziert.
Telefonnummer-Probleme
Ungültige Telefonnummer-Fehler
Telefonnummern werden automatisch normalisiert. Akzeptierte Formate:
+4917012345678(international mit +)004917012345678(international mit 00)017012345678(deutsches nationales Format)
Ungültige Nummern werden abgelehnt. Prüfen Sie auf:
- Zusätzliche Leerzeichen oder Zeichen
- Falsche Ländervorwahl
- Festnetznummern (einige Funktionen erfordern Mobilnummern)
SMS in bestimmte Länder funktioniert nicht
Einige Ziele können eingeschränkt sein oder eine spezielle Autorisierung erfordern. Kontaktieren Sie den Support, wenn Sie in bestimmte Länder senden müssen.
Brauchen Sie noch Hilfe?
Wenn Sie Ihr Problem mit den obigen Informationen nicht lösen konnten:
- Prüfen Sie das SMS-Protokoll in Ihrem Portal für detaillierte StatusinformationenPrüfen Sie das SMS-Log in Ihrem Portal für detaillierte StatusinformationenPrüfen Sie das SMS-Log in Ihrem Portal für detaillierte StatusinformationenPrüfen Sie das SMS-Log in Ihrem Portal für detaillierte Statusinformationen
- Überprüfen Sie die Status- und Reason-Codes in der Statuscodes Referenz
- Kontaktieren Sie den Support mit Ihrer Team-ID und den betroffenen Nachrichten-IDs