Benutzerdefinierte Opt-Out-Keyword-Listen

Jeder Orbit-Mandant erhält die carrier-mandated STOP / HELP / START-Verarbeitung standardmäßig. Eine Opt-Out-Liste geht einen Schritt weiter, wenn Sie unter mehreren Marken oder in mehreren Sprachen versenden: Definieren Sie zusätzliche Keyword-Aliase und benutzerdefinierte Antworttexte und binden Sie diese Liste an den spezifischen Messaging-Dienst, der sie verwenden soll. Ein Messaging-Dienst ohne gebundene Liste verwendet weiterhin die Plattform-Defaults. Die vollständige Endpoint-Liste finden Sie unten; diese Seite behandelt die Konzepte und die Verwendung der Felder.

Englisches Original: Custom Opt-Out Keyword Lists.

Wann eine Liste nötig ist

Verwenden Sie eine benutzerdefinierte Opt-Out-Liste, wenn:

Sie unter mehreren Marken aus einem Orbit-Konto versenden und die STOP-Antwort jeder Marke deren eigener Stimme entsprechen soll („Sie haben Acme Travel-Benachrichtigungen abbestellt.” vs. „Sie haben Acme Pharmacy-Erinnerungen abbestellt.”).
Ihre Zielgruppe in einer Sprache oder einem Dialekt schreibt, dessen Opt-Out-Wort nicht in den Plattform-Defaults abgedeckt ist — lokale Aliasse können hinzugefügt werden, ohne die obligatorischen Keywords zu verlieren.
Sie markenspezifischen HELP-Text möchten („Antworten Sie HELP für Support oder rufen Sie 1-800-… an”) anstelle des generischen Defaults.

Was Sie ändern können und was nicht

Die Keyword-Arrays pro Liste sind nur additiv. Orbits Matcher führt die Keywords Ihrer Liste mit dem carrier-mandated Plattform-Default zusammen — Sie können die Auslöseoberfläche erweitern (z. B. "CANCEL" oder ein lokalhes Wort neben STOP hinzufügen), aber STOP selbst kann nicht entfernt werden. TCPA und CTIA verlangen es, und Orbit setzt das unabhängig von der Mandanten-Konfiguration auf Plattformebene durch.

Liste erstellen

curl -X POST https://api.orbit.devotel.io/api/v1/messaging/opt-out-lists \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Acme Travel — ES",
    "stop_keywords": ["BAJA", "CANCELAR"],
    "help_keywords": ["AYUDA"],
    "stop_response": "Has cancelado las alertas de Acme Travel. Responde AYUDA para soporte.",
    "help_response": "Acme Travel: responde BAJA para cancelar, o llama al 1-800-555-0100.",
    "default_lang": "es",
    "brand": "Acme Travel"
  }'

Feld	Hinweise
`label`	Ihr Name für die Liste, wird im Dashboard angezeigt.
`stop_keywords` / `help_keywords` / `start_keywords`	Jeweils bis zu 32 Einträge, additiv zu den Plattform-Defaults.
`stop_response` / `help_response` / `start_response`	Automatischer Antworttext bei Keyword-Auslösung, bis zu 1.600 Zeichen (ca. 10 SMS-Segmente).
`default_lang`	Einer von `en`, `tr`, `de`, `es`, `fr`, `pt`, `it`, `ar`, `nl`.
`brand`	Freitext-Markenlabel für Ihre eigene Referenz und Berichterstattung.

Unterstützte Sprachcodes

Das Feld default_lang akzeptiert einen ISO-639-1-Code und bestimmt die Sprache des Antworttemplates sowie das Locale, das verwendet wird, wenn die Sprache des eingehenden Kontakts anderweitig unbekannt ist. Die Plattform unterstützt neun:

Code	Sprache
`en`	Englisch
`tr`	Türkisch
`de`	Deutsch
`es`	Spanisch
`fr`	Französisch
`pt`	Portugiesisch
`it`	Italienisch
`ar`	Arabisch
`nl`	Niederländisch

Wenn keine Liste gebunden ist und keine Sprache bekannt ist, wird jedes Sprach-Keyword-Set fallthrough-gematcht — das Überschneiden einer eingehenden Opt-Out-Antwort ist beabsichtigt (schlimmstenfalls wird eine legitime „DUR”-Nachricht als Opt-Out behandelt; das ist regulatorsicher).

Gängige Aliasse (pro Sprache)

Fügen Sie diese zusätzlichen Einträge unter dem stop_keywords- (oder help_keywords- / start_keywords-) Array Ihrer Liste hinzu, wenn Ihre Zielgruppe sie verwendet. Dies sind beispielhafte mandantenseitige Ergänzungen; die oben genannten Plattform-Defaults gelten ohnehin.

Sprache	In Betracht zu ziehende mandantenseitige Aliasse
Türkisch	`CIKIS` (ASCII-Variante), `IPTAL`, `IPTAL ET`, `DURDUR`
Deutsch	`ABMELDEN`, `STOPP`, `ABBESTELLEN`, `ENDE`
Französisch	`STOP`, `ARRET`, `ARRÊT`, `ANNULER`
Arabisch	`إلغاء`, `أوقف`, `توقف`, oder Englisch `STOP`
Niederländisch	`STOPPEN`, `UITSCHRIJVEN`, `OPZEGGEN`
Spanisch	`BAJA`, `CANCELAR`, `SALIR`
Portugiesisch	`PARAR`, `CANCELAR`, `SAIR`
Italienisch	`FERMA`, `CANCELLA`, `FINE`

Das Matching ist case-insensitiv und toleriert NFC-Normalisierung — Akzente und Diakritika werden zum gleichen Keyword-Ziel zusammengefasst, und interne Leerzeichen werden vor dem Vergleich zusammengelegt.

Liste an einen Messaging-Dienst binden

Eine Liste wird erst wirksam, wenn sie an einen Messaging-Dienst gebunden ist — die Absender-Identität, über die eine Kampagne oder ein Flow tatsächlich versendet:

curl -X PATCH https://api.orbit.devotel.io/api/v1/messaging/services/msvc_abc123 \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "opt_out_list_id": "ool_abc123" }'

Jeder Messaging-Dienst, der dieselben markenspezifischen Keywords und Texte verwenden soll, verweist mit seinem opt_out_list_id auf dieselbe Liste. Durch Setzen von opt_out_list_id auf null wird die Verbindung gelöst, was für diesen Dienst auf die Plattform-Defaults zurückfällt.

Opt-Out-Listen vs. Suppression-Listen vs. Kontakt-Opt-Outs

Dies sind drei verschiedene Ebenen, die leicht verwechselt werden:

Opt-Out-Listen (diese Seite) konfigurieren, wie eine STOP/HELP/START-Antwort erkannt und beantwortet wird — die Keyword-Matching- und Antwort-Ebene.
Opt-Out & Suppression-Listen decken die compliantseitige Bulk-Suppression-Liste ab — das Massen-Importieren von Adressen, die nie mehr kontaktiert werden dürfen, z. B. bei der Migration von einer anderen Plattform.
Opt-Outs API ist der pro-Kontakt, pro-Channel-Eintrag darüber, wer tatsächlich abgemeldet ist — gegen den jeder Versand vor der Zustellung geprüft wird.

Ein breiterer STOP-Keyword-Satz (diese Seite) erhöht, wie viele eingehende Antworten als Opt-Out erkannt werden; die eigentliche Sperrung erfolgt über den Kontakt-Opt-Out-Eintrag, den er schreibt.

Endpoints

Methode	Pfad	Zweck
`GET`	`/api/v1/messaging/opt-out-lists`	Ihre Opt-Out-Listen auflisten
`POST`	`/api/v1/messaging/opt-out-lists`	Liste erstellen
`GET`	`/api/v1/messaging/opt-out-lists/{id}`	Liste abrufen
`PATCH`	`/api/v1/messaging/opt-out-lists/{id}`	Liste aktualisieren
`DELETE`	`/api/v1/messaging/opt-out-lists/{id}`	Liste löschen

Siehe auch

Opt-Out & Suppression-Listen — Bulk-Suppression-Listen-Import für Adressen, die nie mehr kontaktiert werden dürfen
DNC-Scrub — Kontakte vor dem Kampagnen-Versand gegen nationale Do-Not-Call-Register prüfen
Opt-Outs API-Referenz — pro-Kontakt-Opt-Out-Einträge
Messaging-Anmeldedaten & -Dienste — Liste via opt_out_list_id binden
SMS-Versanddienste — der Dienst, an den die Liste gebunden ist, end-to-end

Getting Started

Channels

Channels (Voice)

AI Agents

Flows

Numbers & Verify

Concepts

Features

Billing

Webhooks

Security & SSO

Compliance

Legal

Brand & press

Changelog

Benutzerdefinierte Opt-Out-Keyword-Listen

Benutzerdefinierte Opt-Out-Keyword-Listen

Wann eine Liste nötig ist

Was Sie ändern können und was nicht

Liste erstellen

Unterstützte Sprachcodes

Gängige Aliasse (pro Sprache)

Liste an einen Messaging-Dienst binden

Opt-Out-Listen vs. Suppression-Listen vs. Kontakt-Opt-Outs

Endpoints

Siehe auch

​Benutzerdefinierte Opt-Out-Keyword-Listen

​Wann eine Liste nötig ist

​Was Sie ändern können und was nicht

​Liste erstellen

​Unterstützte Sprachcodes

​Gängige Aliasse (pro Sprache)

​Liste an einen Messaging-Dienst binden

​Opt-Out-Listen vs. Suppression-Listen vs. Kontakt-Opt-Outs

​Endpoints

​Siehe auch

Benutzerdefinierte Opt-Out-Keyword-Listen

Wann eine Liste nötig ist

Was Sie ändern können und was nicht

Liste erstellen

Unterstützte Sprachcodes

Gängige Aliasse (pro Sprache)

Liste an einen Messaging-Dienst binden

Opt-Out-Listen vs. Suppression-Listen vs. Kontakt-Opt-Outs

Endpoints

Siehe auch