> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Benutzerdefinierte Opt-Out-Keyword-Listen

> Konfigurieren Sie in Orbit markenspezifische STOP-, HELP- und START-Keywords sowie Antworttexte und binden Sie die Opt-Out-Liste an einen Messaging-Dienst.

# 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](/api-reference/messaging-credentials), 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](/guides/opt-out-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

```bash theme={null}
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](/api-reference/messaging-credentials) gebunden ist — die Absender-Identität, über die eine Kampagne oder ein Flow tatsächlich versendet:

```bash theme={null}
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](/compliance/opt-out-suppression)** 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](/api-reference/optouts)** 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](/compliance/opt-out-suppression) — Bulk-Suppression-Listen-Import für Adressen, die nie mehr kontaktiert werden dürfen
* [DNC-Scrub](/compliance/dnc-scrub) — Kontakte vor dem Kampagnen-Versand gegen nationale Do-Not-Call-Register prüfen
* [Opt-Outs API-Referenz](/api-reference/optouts) — pro-Kontakt-Opt-Out-Einträge
* [Messaging-Anmeldedaten & -Dienste](/api-reference/messaging-credentials) — Liste via `opt_out_list_id` binden
* [SMS-Versanddienste](/guides/sms-services) — der Dienst, an den die Liste gebunden ist, end-to-end