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
Die REST-API (/api/v1/sms/) gibt spezifische Fehlercodes zurück (-1, -2, -5, -6). Die Legacy-API (sendtmsg.php) meldet aus Gründen der Abwärtskompatibilität bei allen Validierungsfehlern -10.
Fehler -1: team_id fehlt oder ist ungültig (REST API)
Der Parameter team_id ist erforderlich und muss Ihre numerische Kundennummer sein.
- Prüfen Sie, ob Sie Ihre sechsstellige Kundennummer verwenden
- Die team_id muss numerisch sein, nicht alphanumerisch
- Beispiel: team_id=100042
Fehler -2: teamlist_email fehlt oder ist ungültig (REST API)
Der Parameter teamlist_email ist erforderlich und muss eine gültige Teamlisten-Adresse sein.
- Prüfen Sie die genaue E-Mail-Adresse Ihrer Teamliste (z.B. meinteam@tmsg.de)
- Die Adresse muss mit der in Ihrem Konto hinterlegten übereinstimmen
Fehler -5: message fehlt oder ist zu lang (REST API)
Der Parameter message ist erforderlich und in der Länge begrenzt.
- Die Nachricht darf nicht leer sein
- Die maximale Länge beträgt 1600 Zeichen (10 SMS-Segmente)
- Achten Sie darauf, dass Sonderzeichen korrekt URL-kodiert sind
Fehler -6: to_mobile fehlt oder ist ungültig (REST API)
Der Parameter to_mobile ist erforderlich, wenn an bestimmte Empfänger gesendet wird.
- Rufnummern müssen 7 bis 20 Ziffern haben
- Verwenden Sie das internationale Format: +4917012345678 oder 004917012345678
- Mehrere Rufnummern können durch Komma getrennt werden
Fehler -10: Konto nicht gefunden
Die Teamliste wurde nicht gefunden oder die Authentifizierung ist fehlgeschlagen.
Hinweis
Die Legacy-API (sendtmsg.php) meldet aus Gründen der Abwärtskompatibilität bei allen Validierungsfehlern -10. Spezifische Fehlercodes liefert die REST-API (/api/v1/sms/).
- Die Kombination aus team_id und teamlist_email muss gültig sein
- Wenn Ihre Liste ein Keyword erfordert, prüfen Sie den Parameter ky
- Stellen Sie sicher, dass der URL-Zugriff für die Teamliste freigeschaltet ist
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
- Verwenden Sie einen API-Token zur Authentifizierung, um die IP-Whitelist zu umgehen
Hinweis
Die Whitelist unterstützt einzelne IP-Adressen, CIDR-Notation (z.B. 192.168.1.0/24) und Subnetzmasken. IPv6-Adressen werden unterstützt.
Fehler -13: Rate-Limit überschritten
Sie haben in kurzer Zeit zu viele Anfragen gesendet.
- Warten Sie einen Moment, bevor Sie weitere Anfragen senden
- Grenzwert: 60 Anfragen pro Minute je IP-Adresse
- Wenn Sie höhere Grenzwerte benötigen, wenden Sie sich an den Support
Fehler -14: Geschlossene Gruppe erfordert sender_email
Ihre Teamliste ist als geschlossene Gruppe konfiguriert. Bei geschlossenen Gruppen ist eine Absender-Authentifizierung erforderlich.
- Fügen Sie den Parameter 'sender_email' (oder 'fm' für Legacy-API) mit der E-Mail-Adresse eines registrierten Mitglieds hinzu
- Die E-Mail-Adresse muss einem Teammitglied mit Sendeberechtigung gehören
- Alternativ können Sie die Teamliste auf 'Offene Gruppe' setzen, wenn keine Absenderprüfung benötigt wird
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
Rufnummern müssen im internationalen Format vorliegen. Akzeptierte Formate:
+4917012345678(international mit +, empfohlen)004917012345678(international mit 00)
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