Skip to content
ONE LOOP / Documentation / Platform guides

The source documentation is currently available in German. No English translation is implied.

Platform guides

Bei SMS-Zustellfehlern automatisch reagieren

ONE LOOP: Mit dem Auslöser SMS-Zustellfehler baust du einen Sicherheitsweg für Nachrichten auf, die nicht angekommen sind.

Mit dem Auslöser SMS-Zustellfehler baust du einen Sicherheitsweg für Nachrichten auf, die nicht angekommen sind. Sobald die Plattform für eine versendete SMS einen unterstützten Fehlercode zurückmeldet, startet der zugehörige Workflow für den betroffenen Kontakt.

So kannst du verschieden reagieren, ohne Kontakte falsch zu behandeln: Eine ungültige Nummer wird zur Prüfung markiert, eine Abmeldung beendet weitere SMS-Schritte und ein Problem mit der Absendernummer landet bei der zuständigen Person.

Dieser Auslöser prüft keine Telefonnummer im Voraus. Er reagiert erst, nachdem eine SMS nicht zugestellt werden konnte und ein passender Fehlercode vorliegt.

Was du vorher brauchst

  • Einen Standort, in dem SMS versendet werden können.

  • Einen Workflow, der fehlgeschlagene SMS behandeln soll.

  • Eine klare Entscheidung, wer kontaktbezogene Fehler prüft und wer technische Versandprobleme bearbeitet.

  • Bei Nachrichten mit mehreren Medien: eine passende Vorgehensweise für SMS und für Bild- oder Mediennachrichten. Nicht jeder Fehler betrifft beide Formate gleich.

Den Auslöser anlegen

  1. Öffne Automatisierung > Workflows und erstelle einen neuen Workflow oder öffne einen bestehenden Sicherheits-Workflow.

  2. Füge einen Auslöser hinzu und wähle SMS-Zustellfehler.

  3. Gib dem Auslöser einen eindeutigen Namen, zum Beispiel SMS-Fehler – Nummer prüfen. Dieser Name hilft dir später beim Prüfen des Workflow-Verlaufs.

  4. Entscheide, ob der Workflow auf alle unterstützten Fehler oder nur auf bestimmte Fehlercodes reagieren soll.

  5. Speichere den Auslöser.

  6. Ergänze darunter die passende Aktion oder eine Bedingung. Speichere den gesamten Workflow und aktiviere ihn erst nach einem Test.

Fehlercodes direkt filtern

Der Filter ist optional. Ohne Filter startet der Workflow bei jedem unterstützten SMS-Zustellfehler. Das ist sinnvoll, wenn du die genaue Ursache erst im nächsten Schritt über eine Bedingung aufteilen möchtest.

Mit dem Filterfeld Fehlercode kannst du dagegen gezielt auswählen, bei welchen Ursachen der Workflow beginnen soll. Die sichtbare Auswahl unterstützt mehrere Codes gleichzeitig. Wähle dafür beim Vergleich ist einer von und markiere die passenden Codes.

Beispiel: Für die Nummernprüfung kannst du die Codes 30003, 30005, 21211, 21614 und 21635 gemeinsam auswählen. So startet dieser Workflow nur, wenn eine Nummer nicht erreichbar, ungültig oder keine Mobilnummer ist.

Ursachen sauber trennen

Ein Zustellfehler bedeutet nicht automatisch, dass die Kontaktdaten falsch sind. Ordne die Reaktion immer nach der Ursache ein:

Fehlergruppe

Unterstützte Codes

Was die Meldung bedeutet

Sichere erste Reaktion

Nummer nicht erreichbar oder ungültig

30003, 30005, 21211, 21614, 21635

Die Zielnummer ist außer Betrieb, nicht erreichbar, ungültig oder keine Mobilnummer.

Kontakt zur Prüfung markieren; bis zur Klärung keine weitere SMS-Folge einplanen.

Kontakt möchte keine SMS

30004, 21610

Der Kontakt hat SMS abgelehnt oder mit einem Abmeldewort geantwortet.

Keine neue SMS versenden. Prüfe nur die interne Kennzeichnung und bearbeite den Kontakt nicht entgegen der Abmeldung.

Zielnummer kann dieses Format nicht empfangen

30006, 30011

Die Nummer ist ein Festnetzanschluss oder kann eine Mediennachricht in dieser Region nicht empfangen.

Andere, zulässige Kontaktmöglichkeit prüfen; die Nummer nicht als allgemeingültig fehlerhaft behandeln.

Absender oder Region nicht bereit

21606, 21661, 21408, 30037

Die Absendernummer ist ungültig oder nicht SMS-fähig, der Versand ist für die Region nicht freigegeben oder ausgehender Versand ist deaktiviert.

Interne Benachrichtigung an die zuständige Person senden. Den Kontakt nicht verändern.

Registrierung oder Versandgrenze blockiert

30007, 30023, 30032, 30033, 30034

Eine Versandvorgabe wurde verletzt, eine notwendige Bestätigung steht aus, eine tägliche Grenze ist erreicht oder eine Senderregistrierung ist nicht aktiv.

Interne Prüfung auslösen und erst nach vollständiger Klärung erneut senden.

Technisch nicht eindeutig

30008

Die Ursache wurde nicht genauer zugeordnet.

Fehler mit Code dokumentieren und den Versandweg prüfen.

Standort eingeschränkt

30002

Der Standort ist gesperrt.

Intern eskalieren; dieser Fehler lässt sich nicht am einzelnen Kontakt korrigieren.

Die Codes sind für die technische Zuordnung da. Ein Code ersetzt keine Prüfung des konkreten Kontakts oder der aktuellen Versandeinstellung.

Unterschiedliche Reaktionen in einem Workflow einrichten

Wenn du nicht für jeden Fehler eine eigene Automation bauen möchtest, lasse den Auslöser ohne Codefilter und teile den Ablauf danach auf.

  1. Klicke unter dem Auslöser auf das Pluszeichen und füge die Aktion Bedingung hinzu.

  2. Vergib einen verständlichen Aktionsnamen, zum Beispiel Nummer prüfen oder intern melden.

  3. Lege einen Zweig an.

  4. Wähle im ersten Feld SMS-Fehlercode.

  5. Wähle als Vergleich ist einer von.

  6. Wähle einen oder mehrere Codes für diesen Zweig.

  7. Ergänze im Zweig die dazu passende Aktion.

  8. Lasse den Zweig Keiner bestehen. Er fängt neue oder nicht zugeordnete Fehlercodes auf, damit ein Fehler nicht unbemerkt endet.

Die sichtbare Oberfläche erlaubt weitere Bedingungen, weitere Zweige und zusätzliche Segmente. Für den Einstieg ist es am übersichtlichsten, wenige eindeutige Gruppen anzulegen:

  • Nummer prüfen für nicht erreichbare oder ungültige Zielnummern.

  • Keine weitere SMS für Ablehnung oder Abmeldung.

  • Intern melden für Absender-, Regionen- und Registrierungsprobleme.

  • Unbekannt prüfen im Zweig Keiner.

Konkrete Aktionen pro Zweig

Der Auslöser löst nur aus; er korrigiert weder Nummern noch Versandeinstellungen selbst. Ergänze deshalb pro Zweig eine nachvollziehbare Folgeaktion.

1. Nummer zur Prüfung weitergeben

Für die Codes 30003, 30005, 21211, 21614 und 21635 kannst du:

  1. eine interne Aufgabe erstellen,

  2. den Kontakt mit einer eindeutigen Kennzeichnung wie Telefonnummer prüfen versehen und

  3. weitere SMS-Schritte erst nach der Prüfung fortsetzen.

Prüfe zuerst, ob die Nummer im Kontakt korrekt formatiert und noch aktuell ist. Eine Festnetznummer oder eine Nummer außerhalb des Servicebereichs ist nicht durch einen erneuten Versand lösbar.

2. Abmeldung respektieren

Für 30004 und 21610 sollte der Workflow keine weitere SMS vorbereiten. Nutze den Zweig höchstens für eine interne Information oder zur Prüfung, ob die erwartete Kennzeichnung vorhanden ist.

Wichtig: Eine interne Aufgabe darf nicht dazu führen, dass die Abmeldung ignoriert oder eine neue SMS ausgelöst wird.

3. Versandkonfiguration intern klären

Für 21606, 21661, 21408, 30037, 30007, 30023, 30032, 30033, 30034 und 30002 liegt die Ursache nicht verlässlich beim Kontakt. Erstelle eine interne Benachrichtigung mit:

  • Name und Kontakt-ID des betroffenen Kontakts,

  • Zeitpunkt der fehlgeschlagenen Nachricht,

  • Fehlercode,

  • Name des Workflows oder der Nachricht,

  • klarer Bitte, die Absender-, Regions-, Registrierungs- oder Standortvoraussetzung zu prüfen.

So bleibt nachvollziehbar, warum eine Nachricht nicht angekommen ist, ohne Kontaktdaten voreilig zu ändern.

Praxisbeispiel: Drei sichere Wege

Ein Betrieb versendet nach einer Anfrage eine kurze Bestätigung per SMS. Er richtet einen Workflow mit dem Auslöser SMS-Zustellfehler ohne Filter ein und fügt danach eine Bedingung mit drei Zweigen hinzu:

  1. Nummer nicht nutzbar: Die Codes 30003, 30005, 21211, 21614 und 21635 erzeugen eine Aufgabe Telefonnummer prüfen. Der Kontakt erhält keine weitere SMS, bis die Nummer geprüft wurde.

  2. Abgemeldet: Die Codes 30004 und 21610 enden nach einer internen Prüfung. Es wird keine Ersatz-SMS geplant.

  3. Interne Versandprüfung: Alle übrigen Codes führen zu einer Benachrichtigung an das verantwortliche Team. Der Kontakt bleibt unverändert.

Der Zweig Keiner sendet ebenfalls eine interne Benachrichtigung. Damit werden später neu auftretende oder noch nicht zugeordnete Fehler sichtbar.

Vor der Aktivierung testen

Prüfe jeden Zweig mit einem bereits dokumentierten Zustellfehler aus deinem Standort. Löse keinen künstlichen Versand an unpassende Empfänger aus.

Kontrolliere anschließend:

  1. Ist der Workflow beim erwarteten Fehlercode gestartet?

  2. Ist der Kontakt im richtigen Zweig gelandet?

  3. Wurde die vorgesehene Aufgabe oder interne Benachrichtigung erstellt?

  4. Wurde bei einer Abmeldung keine weitere SMS vorbereitet?

  5. Wurde bei einem Absender- oder Standortproblem der Kontakt unverändert gelassen?

  6. Ist im Workflow-Verlauf der Fehlercode nachvollziehbar?

Grenzen und typische Fehler

  • Der Auslöser verarbeitet nur die unterstützten Fehlercodes in der Tabelle. Er ersetzt keine allgemeine Telefonnummernprüfung.

  • Ein Fehler kann eine einmalige technische Ursache haben. Ändere Kontaktdaten deshalb nur bei klar kontaktbezogenen Ursachen und nach Prüfung.

  • Ein Filter im Auslöser und dieselbe Bedingung im Ablauf können zusammen unnötig komplex werden. Wähle entweder einen eng gefilterten Start oder einen ungefilterten Start mit übersichtlichen Zweigen.

  • Ohne einen Keiner-Zweig können unbekannte Ursachen ohne deine gewünschte Folgeaktion enden.

  • Veröffentliche oder aktiviere den Workflow erst, wenn du die Reaktion für jede Fehlergruppe im Workflow-Verlauf kontrolliert hast.

← Back to articles