Länderspezifische Compliance-Anforderungen

Messaging- und Voice-Regeln werden Land für Land festgelegt. Bevor Sie in einen neuen Markt senden, müssen Sie vier Dinge wissen: welche Sender-Typen das jeweilige Land akzeptiert (einen Long Code? eine alphanumerische Sender-ID? einen Short Code?), ob eine Registrierung erforderlich ist, welche Dokumente Sie einreichen müssen und welche Inhalte eingeschränkt sind. Ein Fehler hier ist der häufigste Grund dafür, dass erste Sendungen in ein neues Land still nicht zugestellt werden. Orbit pflegt eine kuratierte, länderspezifische regulatorische Referenz, sodass Sie diese nicht selbst zusammentragen müssen. Diese Seite erklärt, wie Sie sie lesen.

Diese Referenz dient als Orientierung für Ihre Planung, nicht als Zustellungsgarantie oder Rechtsberatung. Die endgültige Genehmigung einer Sender-ID oder Registrierung wird von der Regulierungsbehörde oder dem Netzbetreiber des jeweiligen Landes erteilt, nicht von Orbit. Die Abdeckung wird pro Mandant aktiviert — dass ein Land hier aufgeführt ist, bedeutet nicht, dass es für Ihr Konto aktiviert ist.

Länderregeln nachschlagen

GET /compliance/country-rules ist die schreibgeschützte regulatorische Referenz hinter Orbits Sendezeit-Gates. Jeder authentifizierte Benutzer kann sie aufrufen. Filtern Sie nach channel (Standard: sms) und optional nach region:

curl "https://api.orbit.devotel.io/api/v1/compliance/country-rules?channel=sms&region=EU" \
  -H "Authorization: Bearer $ORBIT_API_KEY"

Jede Zeile beschreibt ein Land × Kanal:

{
  "data": {
    "rows": [
      {
        "country_code": "FR",
        "channel": "sms",
        "country_name": "France",
        "calling_code": "33",
        "region": "EU",
        "sender_types": ["alphanumeric", "long_code"],
        "registration": "recommended",
        "sender_rules": "Alphanumeric sender IDs are dynamic; no pre-registration required but recommended for consistency.",
        "content_restrictions": "Marketing SMS requires prior opt-in (GDPR). No sends 20:00–08:00 or Sundays/holidays.",
        "stop_requirement": "STOP keyword mandatory in French (STOP au 36111).",
        "two_way": true,
        "dlr_support": "full",
        "default_tps": "10",
        "notes": ""
      }
    ],
    "channel": "sms",
    "last_synced_at": "2026-06-20T00:00:00.000Z",
    "total": 1
  },
  "meta": { "request_id": "…", "timestamp": "2026-06-20T12:00:00.000Z" }
}

Der channel-Filter akzeptiert sms, whatsapp, rcs, voice, email und viber. Dasselbe Land hat separate Zeilen pro Kanal, weil unterschiedliche Kanäle unterschiedlichen Regulierungsbehörden unterliegen — beispielsweise regeln Metas WABA-Regeln WhatsApp in Brasilien, während Anatels Regeln SMS regeln.

Jedes Feld lesen

Feld	Was es Ihnen sagt
`sender_types`	Welche Absenderidentitäten das Land akzeptiert — siehe die Tabelle unten.
`registration`	`none`, `recommended` oder `required` — ob Sie eine Sender-ID vor dem Senden registrieren müssen.
`sender_rules`	Hinweise in Klartext, wie sich Sender-IDs in diesem Land verhalten (dynamisch vs. vorregistriert, Nummernformat usw.).
`content_restrictions`	Kategorie- und Einwilligungsbeschränkungen — z. B. „Marketing erfordert Opt-in”, Verbote für Werbeinhalte. Siehe Eingeschränkte & verbotene Branchen.
`stop_requirement`	Ob ein Abmelde-Schlüsselwort vorgeschrieben ist und in welcher Sprache.
`two_way`	Ob eingehende Antworten unterstützt werden.
`dlr_support`	Genauigkeit der Zustellbestätigungen: `full`, `partial`, `submitted_only` oder `none`.
`default_tps`	Die standardmäßige Durchsatzobergrenze (Nachrichten pro Sekunde).

Sender-Typen

Wert	Bedeutung
`alphanumeric`	Eine markenbezogene Text-Sender-ID (z. B. `MyBrand`).
`numeric`	Ein numerischer Absender, der kein路由barer Long Code ist.
`long_code`	Eine standardmäßige lokale/mobile lange Nummer.
`short_code`	Ein dedizierter 4–6-stelliger Short Code.
`ten_dlc`	Ein US-amerikanischer 10-stelliger Long Code, registriert über 10DLC.
`waba`	Ein WhatsApp-Business-Account-Absender.
`rcs_agent`	Ein verifizierter RCS-Business-Messaging-Agent.
`from_address`	Eine E-Mail-`from`-Adresse (E-Mail-Kanal).

Die `registration`-Stufen

Das registration-Feld ist der wichtigste Einzelwert, den Sie vor dem Start lesen sollten. Es steuert Orbits Sendezeit-Gate:

none — frei senden

Es ist keine Sender-ID-Registrierung erforderlich. Sie können mit dem Senden beginnen, sobald der Kanal und das Land für Ihr Konto aktiviert sind.

recommended — jetzt senden, für Zuverlässigkeit registrieren

Das Senden ist ohne Registrierung erlaubt, unregistrierter Verkehr wird jedoch häufiger gefiltert oder umbeschriftet. Registrieren Sie die Sender-ID, um die Zustellung stabil zu halten.

required — vor dem Senden registrieren

Verkehr wird blockiert, bis Sie eine genehmigte Sender-ID-Registrierung für das Land haben. A2P-SMS in ein required-Land ohne genehmigten Eintrag wird vom Sendezeit-Gate zurückgehalten. Registrieren Sie sich und lassen Sie sich vor dem Start genehmigen — siehe Sender-ID-Registrierung.

Dokumente, die jedes Land erwartet

Wo ein Land eine Registrierung verlangt (oder empfiehlt), reichen Sie unterstützende Dokumente einmal ein und verweisen dann über ihre doc_…-IDs darauf, wenn Sie eine Sender-ID registrieren. Der genaue Umfang variiert je nach Markt, aber die meisten Regulierungsbehörden verlangen eine Kombination aus:

Nachweis der Unternehmensregistrierung — Gründungsurkunde, Gewerbeanmeldung oder gleichwertiges.
Eine Anwendungsfall-Beschreibung — was Sie senden (transaktional, OTP, Marketing) und an wen.
Markeninhaberschaft / Berechtigung — Nachweis, dass Sie zur Verwendung der Sender-ID / des Markennamens berechtigt sind, den Sie registrieren.
Lokale Steuer- oder Regulierungs-ID — für Märkte, die die Registrierung an einen nationalen Identifikator binden.

Lesen Sie die sender_rules und content_restrictions des Ziellandes in der Country-Rules-Antwort für die Einzelheiten und fügen Sie dann die passenden Dokumente bei, wenn Sie die Registrierung einreichen. Einige Märkte betreiben ein eigenes, dediziertes Registrierungsverfahren anstelle des generischen Sender-ID-Ablaufs:

Indien — Sender-IDs („Headers”), Inhaltsvorlagen und Einwilligungsvorlagen werden über das TRAI-DLT-Portal registriert. Siehe DLT-India-Onboarding.
Vereinigte Staaten — A2P-SMS-Absender registrieren Brand und Kampagne über 10DLC. Siehe den 10DLC-Registrierungsleitfaden.

Eine Start-Checkliste für ein neues Land

Regeln nachschlagen

Rufen Sie GET /compliance/country-rules?channel=<channel> für das Ziel auf und lesen Sie sender_types, registration und content_restrictions.

Einen akzeptierten Sender-Typ wählen

Wählen Sie eine Absenderidentität aus den sender_types des Landes — eine alphanumerische Sender-ID, einen Long Code, einen Short Code oder einen kanalnativen Absender (WABA / RCS-Agent).

Falls erforderlich registrieren

Wenn registration required (oder recommended) ist, laden Sie Ihre Dokumente hoch und reichen die Sender-ID zur Genehmigung ein. Planen Sie Vorlaufzeit ein — manche Märkte benötigen Tage bis Wochen.

Inhaltsbeschränkungen prüfen

Vergewissern Sie sich, dass Ihr Anwendungsfall gegen content_restrictions und Eingeschränkte & verbotene Branchen zulässig ist, und fügen Sie das erforderliche Abmelde-Schlüsselwort hinzu, wenn stop_requirement eines verlangt.

Starten

Sobald das Land aktiviert, der Sender-Typ akzeptiert und eine etwaige erforderliche Registrierung genehmigt ist, beginnen Sie mit dem Senden.

Pflege der Regelquelle (Plattformbetreiber)

Dieser Abschnitt richtet sich an Plattformbetreiber und Self-Hosted-Deployments. SaaS-Kunden auf api.orbit.devotel.io können hier aufhören — Devotel hält die Länderregeln für Sie aktuell, und die folgenden Endpunkte sind auf Plattformadministratoren beschränkt.

Die Country-Rules-Referenz wird durch geplante Upstream-Synchronisierungen plus manuelle Operator-Bearbeitungen gespeist. Dieser Abschnitt behandelt, wie Sie sie aktuell halten und wie Sie ein einzelnes Land sicher bearbeiten. Die Endpunkte, die in die Regeltabelle schreiben, sind nur für Plattformadministratoren — Mandanteninhaber und Administratoren erhalten einen 403, weil die Regeltabelle global über alle Mandanten hinweg gilt und keine mandantenspezifischen Daten enthält.

Feed-Quellen

Der sync_source jeder Zeile verzeichnet, welcher Feed sie zuletzt aktualisiert hat. Sechs Anbieter binden an den Sync-Endpunkt an:

Anbieter	Was er liefert	Zugang
`mef`	MEF SenderID Protection Registry — MNO-signierte Sender-ID-Regeln (die maßgeblichste Sender-ID-Quelle)	Kostenpflichtige Aggregator-Tier-Mitgliedschaft; `DEVOTEL_MEF_API_KEY` setzen
`gsma`	GSMA-SMS-Hub-Sender-ID-Schutzregeln	Mitgliederportal; `DEVOTEL_GSMA_API_KEY` setzen
`telnyx`	Länderabdeckung über den Telnyx-Coverage-Feed	Kostenlos mit `DEVOTEL_TELNYX_API_KEY`; greift bei Nichtsetzen auf Telnyx’ öffentliche Abdeckungsliste zurück
`iconectiv`	iconectiv-TCR-Partner-Feed — das kanonische US-10DLC-Regelwerk	`DEVOTEL_TCR_API_KEY` + `DEVOTEL_TCR_PARTNER_ID` setzen; siehe den 10DLC-Leitfaden
`meta`	Meta Business API — länderspezifische WhatsApp-Verfügbarkeit (WABA)	Kostenlos mit einem WABA-Systembenutzer-Token
`itu`	ITU WTID — Referenz-URLs nationaler Regulierungsbehörden	Kostenlos (Namensnennung erforderlich)

Zwei benachbarte Feeds speisen ihre eigenen Tabellen:

Telnyx-Coverage für die Legacy-Sender-ID-Matrix — die Lese-Endpunkte hinter der Sender-ID-Compliance-Matrix beziehen sich aus einer separaten Legacy-Tabelle. Aktualisieren Sie sie mit POST /api/v1/compliance/admin/sync (nur Admin; derselbe wöchentliche Scheduler aktualisiert sie auch automatisch).
Reassigned Numbers Database (RND) — das US-Gate für stillgelegte Rufnummern, dokumentiert unter Deactivation-Scrubbing. Mandanten aktivieren es mandantenspezifisch über PUT /api/v1/compliance/rnd/settings mit { "enabled": true }; der Schalter verweigert das Einschalten, bis ein Operator einen RND-Snapshot in das Deployment geladen hat, sodass Mandanten sich nicht in ein leeres Gate opt-in können.

Eine Upstream-Synchronisierung ausführen

POST /api/v1/compliance/country-rules/sync aktualisiert aus einem Anbieter. Wählen Sie den Feed mit ?provider= (Standard: telnyx) und begrenzen Sie optional auf einen ?channel=.

curl -X POST "https://api.orbit.devotel.io/api/v1/compliance/country-rules/sync?provider=mef&channel=sms" \
  -H "Authorization: Bearer $ORBIT_PLATFORM_ADMIN_KEY"

Die Antwort meldet upstreamCount, updated, createdNew und ein errors-Array. Eine Synchronisierung überschreibt niemals von Operatoren kuratierte Prosa — nur strukturelle Felder (Ländername, Vorwahl, Region, Sender-Typen, Registrierungsstufe) werden aktualisiert; die Freitextfelder (sender_rules, content_restrictions, notes) behalten, was ein Operator zuletzt geschrieben hat.

Feed-Takt

Zwei Pfade halten die Tabelle aktuell:

Wöchentlicher Scheduler — der Compliance-Sync-Tick des Webhook-Workers führt die Telnyx-, MEF- und GSMA-Feeds automatisch aus. Er läuft außerdem einmal beim Worker-Start, sodass sich ein frisches Deployment beim ersten Start selbst befüllt.
On-Demand — die Admin-Aktion „Aus Upstream aktualisieren” ruft den obigen Sync-Endpunkt für einen sofortigen Abruf auf (nützlich direkt nach dem Bereitstellen neuer Feed-Zugangsdaten).

Die Veraltung wird anhand von last_synced_at geprüft, das der Lese-Endpunkt neben den Zeilen zurückgibt. Manuelle Bearbeitungen stempeln stattdessen last_reviewed_at, sodass das Dashboard die Herkunft anzeigen kann („Vor 3 Tagen von MEF synchronisiert; gestern von Ops geprüft”) statt eines einzigen mehrdeutigen Zeitstempels.

Fehlerbehandlung

Jeder Konnektor ist optional und fail-open: Wenn seine Credential-Umgebungsvariable nicht gesetzt ist, protokolliert die Synchronisierung eine Skip-Meldung und liefert einen Eintrag in errors, und bestehende Zeilen bleiben an Ort und Stelle. Dasselbe gilt bei einem Upstream-Ausfall — die Antwort trägt den Fehlertext, während zuvor synchronisierte Daten lesbar bleiben. Dies sind schreibgeschützte Metadaten-Feeds auf einem Nachschlagepfad; ausgehendes Messaging läuft weiterhin über Ihren normalen Absender, während ein Feed ausgefallen ist.

Sync-Anbieter berühren nur Abdeckungsmetadaten. Sie sind niemals ein Transportpfad — versuchen Sie nicht, ausgehendes Messaging über einen der hier aufgeführten Coverage-Feeds zu leiten.

Ein einzelnes Land bearbeiten

PUT /api/v1/compliance/country-rules/:channel/:country_code upsertet eine Land-×-Kanal-Zeile. Verwenden Sie ihn, um Details zu liefern, die kein Feed mitbringt — zum Beispiel STOP-Schlüsselwort-Formulierungen oder Durchsatzgrenzen aus Regulierungstexten. Plattform-Admin-Zugangsdaten sind erforderlich; Mandantenadministratoren erhalten einen 403.

curl -X PUT "https://api.orbit.devotel.io/api/v1/compliance/country-rules/sms/FR" \
  -H "Authorization: Bearer $ORBIT_PLATFORM_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "country_name": "France",
    "calling_code": "33",
    "region": "EU",
    "sender_types": ["alphanumeric", "long_code"],
    "registration": "recommended",
    "sender_rules": "Alphanumeric sender IDs are dynamic.",
    "content_restrictions": "Marketing SMS requires prior opt-in.",
    "stop_requirement": "STOP keyword mandatory in French.",
    "two_way": true,
    "dlr_support": "full",
    "default_tps": "10",
    "notes": ""
  }'

Bearbeitbare Felder: sender_types, registration (none / recommended / required), sender_rules, content_restrictions, stop_requirement, two_way, dlr_support, default_tps, notes und sources (eine [{ label, url }]-Liste von Quellenangaben-Links). Das Upsert stempelt last_reviewed_at und markiert die Zeile als sync_source: manual, sodass eine spätere automatische Synchronisierung nur die strukturellen Felder aktualisiert und Ihre Prosa unberührt lässt.

Validierungs-Checkliste, bevor Sie ein Land live schalten

Bevor Sie ein Land für den Versand aktivieren, bestätigen Sie:

Frischer Sync-Stempel

last_synced_at (oder, für die Legacy-Matrix, last_verified_at) ist aktuell — andernfalls führen Sie vor der Aktivierung die On-Demand-Sync für den relevanten Anbieter aus.

Korrekte Registrierungsstufe

registration ist gesetzt (none / recommended / required). Ein required-Land blockiert unregistrierten Verkehr zur Sendezeit, sodass eine verpasste Registrierungsprüfung fehlgeschlagene Sendungen bedeutet, nicht verzögerte.

Prosa-Felder geprüft

stop_requirement und content_restrictions sagen, was sie sagen sollen — Feeds aktualisieren nur Struktur, Prosa muss von einem Operator gesetzt werden.

Sender-Typ akzeptiert

Mindestens einer der sender_types des Landes passt zu dem, von dem Sie senden möchten.

Zugehörige Gates geladen

Wenn das Ziel ein RND- oder DLT-Gate hat (US-RND, Indien-DLT), vergewissern Sie sich, dass dieser Feed ebenfalls geladen ist — siehe Deactivation-Scrubbing und DLT-India-Onboarding.

Getting Started

Channels

Channels (Voice)

AI Agents

Flows

Numbers & Verify

Concepts

Features

Billing

Webhooks

Security & SSO

Compliance

Legal

Changelog

Länderspezifische Compliance-Anforderungen

Länderspezifische Compliance-Anforderungen

Länderregeln nachschlagen

Jedes Feld lesen

Sender-Typen

Die `registration`-Stufen

Dokumente, die jedes Land erwartet

Eine Start-Checkliste für ein neues Land

Pflege der Regelquelle (Plattformbetreiber)

Feed-Quellen

Eine Upstream-Synchronisierung ausführen

Feed-Takt

Fehlerbehandlung

Ein einzelnes Land bearbeiten

Validierungs-Checkliste, bevor Sie ein Land live schalten

Verwandte Referenzen

​Länderspezifische Compliance-Anforderungen

​Länderregeln nachschlagen

​Jedes Feld lesen

​Sender-Typen

​Die registration-Stufen

​Dokumente, die jedes Land erwartet

​Eine Start-Checkliste für ein neues Land

​Pflege der Regelquelle (Plattformbetreiber)

​Feed-Quellen

​Eine Upstream-Synchronisierung ausführen

​Feed-Takt

​Fehlerbehandlung

​Ein einzelnes Land bearbeiten

​Validierungs-Checkliste, bevor Sie ein Land live schalten

​Verwandte Referenzen

Länderspezifische Compliance-Anforderungen

Länderregeln nachschlagen

Jedes Feld lesen

Sender-Typen

Die `registration`-Stufen

Dokumente, die jedes Land erwartet

Eine Start-Checkliste für ein neues Land

Pflege der Regelquelle (Plattformbetreiber)

Feed-Quellen

Eine Upstream-Synchronisierung ausführen

Feed-Takt

Fehlerbehandlung

Ein einzelnes Land bearbeiten

Validierungs-Checkliste, bevor Sie ein Land live schalten

Verwandte Referenzen