​

Opt-out & Unterdrückungslisten

​

Wie Unterdrückung entsteht

• Ein Kontakt antwortet mit einem STOP-Keyword auf SMS/WhatsApp.
• Ein Kontakt meldet sich über das Preference Center ab.
• Sie erfassen ein Opt-out über die Consent API (opt_in: false).
• Sie importieren eine Liste per Massenimport (diese Seite).

• CSV-Massenimport leitet den Geltungsbereich aus dem Adresstyp jeder Zeile ab: Telefon- und WhatsApp-Adressen erhalten standardmäßig den Geltungsbereich all — ein STOP-Signal auf einer Telefonnummer unterdrückt jeden auf dieser Nummer erreichbaren Kanal — während E-Mail-Adressen auf email beschränkt werden. Eine channel-Spalte überschreibt dies pro Zeile (siehe CSV-Massenimport).
• Die Consent API und das Preference Center unterdrücken stets den Geltungsbereich all, unabhängig davon, ob die erfasste Kennung eine Telefonnummer oder eine E-Mail-Adresse ist. Ein Opt-out über einen dieser Einstiegspunkte entfernt den Kontakt aus jedem Kanal.

​

CSV-Massenimport

curl -X POST https://api.orbit.devotel.io/api/v1/compliance/suppression-list/import \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -F "file=@suppressions.csv" \
  -F "default_country=US" \
  -F "default_reason=migrated_from_legacy_platform" \
  -F "dry_run=false"

​

Formularfelder

​

CSV-Format

phone,email,reason
+14155550101,,replied STOP
,jordan@example.com,unsubscribed via email
+442071838750,sam@example.co.uk,complaint

​

Ergebnisse pro Zeile

{
  "data": {
    "run_id": "supimp_4d…",
    "total_rows": 1000,
    "accepted": 950,
    "duplicates": 30,
    "intra_file_duplicates": 15,
    "invalid": 5,
    "errors": [
      { "status": "invalid", "reason": "invalid_phone", "raw_line": 42 }
    ],
    "by_channel": { "all": 800, "email": 150 },
    "file_sha256": "9b2e…"
  },
  "meta": { "request_id": "…", "timestamp": "2026-06-08T12:00:00.000Z" }
}

​

Validierungsgründe

​

Grenzen

​

Wenn ein Import fehlschlägt

​

Import aus dem Dashboard

1. CSV-Datei wählen — wählen Sie eine .csv unter 25 MB. Nutzen Sie Download sample CSV im Dialog für eine vorformatierte Startdatei.
2. Defaults setzen (optional) — ein Default country (ISO alpha-2) zur Normalisierung nationaler Formate und ein Freitext-Reason, der auf jede akzeptierte Zeile gestempelt wird.
3. Vorschau — führt den Import als serverseitigen Dry-Run aus: Nichts wird geschrieben, und der Dialog zeigt die Aufschlüsselung akzeptiert / bereits gelistet / Wiederholungen-in-der-Datei / ungültig, bevor Sie committen.
4. Import bestätigen — führt den committenden Schreibzugriff aus. Waren Zeilen ungültig, laden Sie skipped.csv herunter, um sie zu korrigieren und erneut zu importieren.

​

Die Unterdrückungsliste exportieren

curl "https://api.orbit.devotel.io/api/v1/compliance/suppression-list/export?format=csv&status=active" \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -o suppression-list.csv

​

Verifizieren, dass eine Unterdrückung gewirkt hat

1. Eine Testnachricht an die unterdrückte Adresse senden. Ein direkter API-Versand an einen unterdrückten Empfänger schlägt synchron mit HTTP 422 und dem Fehlercode RECIPIENT_OPTED_OUT fehl. Im Sandbox-Modus wird kein Carrier berührt und kein Guthaben abgebucht; jeder Empfänger, der auf 8 endet, löst außerdem in die simulierte blocked-Zustellquittung auf — die carrierseitige Sicht derselben Einzäunung.
   curl -X POST https://api.orbit.devotel.io/api/v1/messages/sms \
     -H "X-API-Key: $ORBIT_SANDBOX_KEY" \
     -H "Content-Type: application/json" \
     -d '{"to": "+14155550101", "from": "+15005550101", "body": "gate check"}'
   
   {
     "error": {
       "code": "RECIPIENT_OPTED_OUT",
       "message": "Recipient has opted out of this channel"
     }
   }
   
   Ein Kampagnenversand an dieselbe Adresse verhält sich bewusst anders: Der Empfänger wird still übersprungen (status: "skipped", reason: "opted_out"), damit der Batch weiterläuft — prüfen Sie den Empfängerbericht der Kampagne, statt einen Fehler zu erwarten.
2. Bestätigen, dass der Eintrag auf dem Register steht. Exportieren Sie mit der Abfrage oben (status=active ist der Standard) und prüfen Sie, dass die Adresse mit dem erwarteten channel-Geltungsbereich erscheint. Der Export ist die Wahrheitsquelle, die jedes Send-Gate liest — ist die Zeile dort active, steht die Einzäunung.

​

Eine Unterdrückung entfernen (Re-Opt-in)

​

Weiterführende Referenzen

• Consent Management — Einwilligung je Kanal erfassen und abfragen.
• Send Gates — Ruhezeiten, DNC, RND, RMD, Notfall-Stopp und das Preference-Center.
• DSAR — wie delete- / opt_out-Anfragen zur Unterdrückung gelangen.
• API Reference → Opt-outs — Endpunktschemata für Opt-out und Unterdrückung.