SMS-Opt-out- & Opt-in-Regeln

Die Seite Opt-out & opt-in rules verwaltet die eingehenden SMS-Keywords, die einen Kontakt abmelden (Opt-out) oder wieder anmelden (Opt-in), sowie den Auto-Reply-Text, den jedes Keyword sendet. Öffnen Sie sie aus dem SMS-Workspace über Messages → SMS → Toolbar: Opt-out Rules oder direkt unter /messages/sms/opt-out-rules.

Englisches Original: SMS-Opt-out- & Opt-in-Regeln.

Wer die Seite öffnen kann

Die Seite ist auf die Rollen owner, admin und developer beschränkt. Billing-, viewer- und supervisor-Rollen erhalten stattdessen einen “you don’t have access”-Screen statt des Editors. Ist der Keyword-Editor bei einem Teammitglied ausgegraut, prüfen Sie dessen Rolle in den Organisationseinstellungen.

Was jede Regel konfiguriert

Jede Regel ist ein Keyword plus der Auto-Reply, die es sendet, in einer von zwei Gruppen:

Opt-out-Keywords — melden den Kontakt ab (STOP, CANCEL und so weiter).
Opt-in-Keywords — melden den Kontakt wieder an (START, YES und so weiter).

Für jedes Keyword setzen Sie:

Feld	Zweck
Keyword	Das exakte eingehende Wort, das die Regel auslöst. Keywords werden in Großbuchstaben gespeichert; ein eingehender Treffer auf das Wort dreht die Einwilligung des Kontakts in Richtung der Gruppe der Regel.
Auto-Reply-Text	Die Nachricht, die der Kontakt zurück erhält (zum Beispiel bei STOP: “You have been unsubscribed. Reply START to re-subscribe.”). Leer lassen, um die Einwilligung still zu ändern.

Bearbeitungen sind lokal, bis Sie Save Rules klicken. Das Löschen einer Zeile verlangt zuerst eine Bestätigung, und das Verlassen der Seite mit ungesicherten Bearbeitungen öffnet eine Verwerfen-Aufforderung — ein Reload oder ein geschlossener Tab nutzt stattdessen die browser-eigene “leave site?”-Abfrage.

Sprachlabels sind informativ

Ein Keyword, das als lokalisierter Opt-out-Begriff erkannt wird (STOP, ALTO, STOPPER, SCHLUSS, PARAR, DUR und ähnliche), zeigt seine Sprache und die Märkte, in denen es verbreitet ist — als Hinweis, nicht als Filter. Eine Regel für ALTO verhält sich exakt wie eine Regel für STOP und gilt für jede reply-fähige Nummer.

Eine eigene Route, kein Overlay

Dieser Editor lebte früher in der SMS-Nachrichtenliste — erst über der Nachrichtenverlaufstabelle gestapelt, dann als Slide-over-Panel, das aus der Toolbar der Liste umgeschaltet wurde. Beide Formen montierten Compliance-Verwaltung innerhalb der Message-Operations-Ansicht, was den Workspace schwer lesbar machte. Der Editor ist jetzt eine eigene Route, erreicht über echte Navigation aus der SMS-Toolbar — die Nachrichtenliste bettet ihn überhaupt nicht mehr ein. Wenn Sie in eigenen Integrationen eine ähnliche Layout-Änderung planen, behalten Sie dieselbe Trennung: Message Operations auf der einen Route, Compliance-Konfiguration auf der anderen.

Wo die Regeln gelten

Ein Banner oben auf der Seite nennt den Geltungsbereich explizit:

Account-weit. Die Regeln gelten für eingehende Replies auf jeder reply-fähigen Nummer (ein Long Code oder Short Code, der eingehende SMS akzeptiert) in Ihrem Account. Sie sind nicht an einen Messaging Service gebunden, Sie müssen also keinen anhängen, damit sie laufen.
Je Messaging Service. Jeder Service führt seine eigene Opt-out-Suppression-Liste, verwaltet am Service — siehe Custom Opt-Out Keyword Lists.
Je Nummer. Ein Keyword-Reply wird nur auf einer reply-fähigen Nummer erkannt. Eine alphanumerische Sender-ID kann keine Replies empfangen, daher löst die Keyword-Behandlung für diese Sender nie aus. Die Seite zeigt, welche Ihrer Nummern qualifiziert sind, und warnt, wenn keine es ist.

Für das Inbound-Routing von Nicht-Keyword-Replies siehe Inbound SMS routing.

Zusammenführung mit dem Plattform-STOP/START-Satz

Ihre Regeln sind nur additiv obenauf auf den plattformweiten, carrier-vorgeschriebenen Keyword-Satz. Jede STOP-Regel von der Seite zu löschen lässt STOP weiterhin auf der Plattform-Ebene behandelt — TCPA und CTIA schreiben es vor, und Orbit setzt es durch, egal was ein Tenant konfiguriert. Ihre Regeln können die Trigger-Fläche erweitern (ein Alias wie CANCELAR oder ein gebrandeter Opt-in wie REJOIN), aber nie verengen.

Vorbelegte Standards

Beim ersten Öffnen legt die Seite einen mehrsprachigen Standardsatz an — STOP / UNSUBSCRIBE / CANCEL / QUIT / END, spanisch ALTO, französisch STOPPER, deutsch SCHLUSS, portugiesisch PARAR und türkisch DUR / IPTAL / RED, jeweils mit lokalisiertem Auto-Reply, plus Opt-in-Paarungen (START, YES, SUBSCRIBE und lokalisierte SI / OUI / JA / SIM / EVET). Weil die Standards deterministisch sind, erscheint eine vorbelegte ALTO-Zeile in jedem Workspace, bis Sie sie bearbeiten und speichern. Lichten Sie die Zeilen, die Ihre Zielgruppe nicht nutzt, oder fügen Sie regionale Aliasse als neue Regeln hinzu — aber behalten Sie mindestens einen Opt-out-Pfad je Sprache, in der Sie senden. Ein von einem Regulierer auditierter Opt-out-Begriff ist immer nur ein Zusatz zum Plattform-Satz; Ihre vorbelegte Kopie davon zu entfernen bewirkt ebenso nichts.

Anhängen und testen

Die Regeln gelten automatisch für jede reply-fähige Nummer; es gibt nichts anzuhängen. Um zu beweisen, dass eine Regel gefeuert hat:

Senden Sie das Keyword von einem Handy an eine Ihrer reply-fähigen Nummern.
Die Inbox zeigt den eingehenden Turn und die Auto-Reply in derselben Konversation.
Das Kontaktprofil zeigt den umgedrehten Einwilligungs-Zustand, mit dem Keyword in der Consent-Historie erfasst; die Opt-Outs-Ansicht listet den Eintrag.
Das Delivery log verfolgt Ihre Auto-Reply durch queued → sent → delivered.

Bevor Sie sich in einer Kampagne auf ein Keyword verlassen, senden Sie einen echten Inbound und bestätigen, dass die Auto-Reply ankommt und der Einwilligungs-Zustand kippt — dieselbe Test-dann-Sende-Disziplin wie der Test-delivery-Check bei den Sender IDs. Der Editor selbst zeigt immer, ob die Keyword-Behandlung betriebsbereit ist: Das Status-Banner nennt die qualifizierten Nummern oder warnt mit einer direkten Get a number-Aktion, wenn keine qualifiziert.

Round Trip: unterdrücken → Sendungsversuch → wieder einwilligen

Die Keyword-Regeln oben decken die Eingangsseite ab — ein Kontakt textet STOP und die Einwilligung kippt. Sie können denselben Lebenszyklus vollständig über die API steuern: einen Kontakt programmatisch unterdrücken, zusehen, wie das Gate zur Sendezeit eine Nachricht an diesen Kontakt ablehnt, dann den Kontakt wieder einwilligen und erneut senden. Dieser Abschnitt fährt den vollen Round Trip gegen eine Testnummer; die Opt-Outs-API-Referenz deckt Parameter und Rollen-Gates jedes Endpunkts ab.

Suppression und Einwilligung sind Tenant-eigene Kontrollen — Ihr Account entscheidet, was als Opt-out zählt, beschränkt auf Ihre eigenen Datensätze. Die einzige Ausnahme auf Plattform-Ebene ist die carrier-vorgeschriebene STOP/START-Keyword-Behandlung, die oben beschrieben ist und die keine Tenant-Einstellung entfernen kann.

1. Den Kontakt unterdrücken

Legen Sie eine Opt-out-Zeile für Telefonnummer und Kanal an. Das Feld contact ist eine E.164-Telefonnummer (oder eine E-Mail); die Plattform löst sie zu einer bestehenden Kontaktzeile auf oder erzeugt eine Stub-Zeile, die auf Ihren Tenant beschränkt ist.

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/contacts/optouts" \
  -H "X-API-Key: dv_test_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contact": "+14155552671",
    "channel": "sms",
    "reason": "Customer reply STOP"
  }'

Der Aufruf ist idempotent — ein erstmaliges Unterdrücken liefert 201 Created, und dasselbe Opt-out erneut anzuwenden liefert 200 OK mit already_opted_out: true. 201 Created (oder 200 OK beim erneuten Anwenden)

{
  "data": {
    "id": "con_abc",
    "phone": "+14155552671",
    "channel_preferences": {
      "sms": { "opted_out": true }
    },
    "already_opted_out": false,
    "updated_at": "2026-09-12T12:00:00Z"
  },
  "meta": { "request_id": "req_abc123" }
}

Node (über die generische request()-Notluke des SDKs):

import { Orbit } from "@devotel-orbit/node";

const orbit = new Orbit({ apiKey: process.env.ORBIT_API_KEY! });

const { data } = await orbit.request<unknown>("POST", "/contacts/optouts", {
  body: {
    contact: "+14155552671",
    channel: "sms",
    reason: "Customer reply STOP",
  },
});

Python:

from orbit_sdk import OrbitClient

client = OrbitClient.from_env()  # reads ORBIT_API_KEY

res = client.request(
    "POST",
    "/contacts/optouts",
    json={
        "contact": "+14155552671",
        "channel": "sms",
        "reason": "Customer reply STOP",
    },
)

2. Eine Sendung versuchen — das Gate lehnt ab

Senden Sie nun eine SMS an die unterdrückte Nummer. Das Compliance-Gate im Sendepfad prüft die Opt-out-Flagge des Kanals, bevor die Nachricht gequeued wird, also startet der Request nie nachgelagert:

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/messages/sms" \
  -H "X-API-Key: dv_test_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "body": "Hello from the suppression round trip"
  }'

422 Unprocessable Entity

{
  "error": {
    "code": "RECIPIENT_OPTED_OUT",
    "message": "Recipient has opted out of this channel",
    "status": 422,
    "details": { "to": "+14155552671", "channel": "sms" }
  },
  "meta": {
    "request_id": "req_def456",
    "docs_url": "https://docs.orbit.devotel.io/errors/RECIPIENT_OPTED_OUT"
  }
}

Branchen Sie in Ihrem Sender-Code auf error.code === "RECIPIENT_OPTED_OUT" und behandeln Sie ihn als autoritativ — ein Retry bei gesetzter Flagge liefert dieselbe 422. Loggen Sie meta.request_id bei jeder Ablehnung; darüber korreliert der Support eine Ablehnung mit dem serverseitigen Trace. Eine von einer abgelehnten Sendung verbrauchte Quote wird automatisch zurückerstattet, und Kampagnensendungen überspringen den unterdrückten Empfänger statt abzulehnen (der Batch hält die übrigen Empfänger in Bewegung), während der Skip dennoch auf der Nachrichtenzeile erfasst wird — siehe die Message Status Lifecycle-Referenz.

3. Die Unterdrückung entfernen und erneut senden

Löschen Sie die Opt-out-Zeile für Kontakt-ID und Kanal — das ist das Re-Opt-in:

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/contacts/optouts/con_abc/sms" \
  -H "X-API-Key: dv_test_sk_YOUR_KEY"

200 OK — liefert die aktualisierte Kontaktzeile zurück und schreibt einen contact.opted_in-Audit-Eintrag mit dem Kanal. POSTen Sie exakt denselben Message-Body wie in Schritt 2 erneut. Das Gate passiert jetzt, und die Sendung wird gequeued: 202 Accepted

{
  "data": {
    "id": "msg_xyz",
    "status": "queued",
    "channel": "sms",
    "to": "+14155552671"
  },
  "meta": { "request_id": "req_ghi789" }
}

Verfolgen Sie die Zeile über ihre id von queued → sent → delivered; die Statusübergänge sind auf der Seite Message Status Lifecycle aufgeführt.

DELETE räumt die Unterdrückung nur innerhalb von Orbit aus — die channel_preferences des Kontakts und Ihre Suppression-Liste. Ein US/CA-Carrier kann unabhängig von Orbits Aufzeichnungen einen eigenen Opt-out-Block halten; ist ein wieder eingewilligter Kontakt per SMS weiterhin nicht erreichbar, lösen Sie jenen Block über Ihren Toll-Free-Verifikations-/Carrier-Support-Kanal, nicht über diese API.

Markenspezifische Opt-outs

Wenn ein Sender gebrandete Keyword-Texte oder eine regionsbeschränkte Suppression-Liste braucht, hängen Sie eine Custom Opt-out-Liste an seinen Messaging Service an, statt die globalen Regeln zu bearbeiten. Für eine gehostete, an Kontakte gerichtete Seite, auf der Empfänger ihre eigenen Abonnements verwalten, nutzen Sie das Preference center. Die pro-Kontakt-Suppression-API, die oben ausgeführt wird, verwaltet den Einwilligungs-Zustand, den jene Listen und Seiten lesen.

WhatsApp

Developer console

Contact center

Guides

Admin

Messaging Controls

Audience & Support Tools

SMS-Opt-out- & Opt-in-Regeln

SMS-Opt-out- & Opt-in-Regeln

Wer die Seite öffnen kann

Was jede Regel konfiguriert

Sprachlabels sind informativ

Eine eigene Route, kein Overlay

Wo die Regeln gelten

Zusammenführung mit dem Plattform-STOP/START-Satz

Vorbelegte Standards

Anhängen und testen

Round Trip: unterdrücken → Sendungsversuch → wieder einwilligen

1. Den Kontakt unterdrücken

2. Eine Sendung versuchen — das Gate lehnt ab

3. Die Unterdrückung entfernen und erneut senden

Markenspezifische Opt-outs

​SMS-Opt-out- & Opt-in-Regeln

​Wer die Seite öffnen kann

​Was jede Regel konfiguriert

​Sprachlabels sind informativ

​Eine eigene Route, kein Overlay

​Wo die Regeln gelten

​Zusammenführung mit dem Plattform-STOP/START-Satz

​Vorbelegte Standards

​Anhängen und testen

​Round Trip: unterdrücken → Sendungsversuch → wieder einwilligen

​1. Den Kontakt unterdrücken

​2. Eine Sendung versuchen — das Gate lehnt ab

​3. Die Unterdrückung entfernen und erneut senden

​Markenspezifische Opt-outs

SMS-Opt-out- & Opt-in-Regeln

Wer die Seite öffnen kann

Was jede Regel konfiguriert

Sprachlabels sind informativ

Eine eigene Route, kein Overlay

Wo die Regeln gelten

Zusammenführung mit dem Plattform-STOP/START-Satz

Vorbelegte Standards

Anhängen und testen

Round Trip: unterdrücken → Sendungsversuch → wieder einwilligen

1. Den Kontakt unterdrücken

2. Eine Sendung versuchen — das Gate lehnt ab

3. Die Unterdrückung entfernen und erneut senden

Markenspezifische Opt-outs