Skip to main content

Send Gates

Ueber Einwilligung und Unterdrueckung hinaus laufen mehrere regulatorische Pruefungen zum Sendezeitpunkt. Orbit fasst sie als Send Gates zusammen: Jedes einzelne Gate kann eine Nachricht oder einen Anruf vor der Auslieferung halten oder verwerfen. Diese Seite behandelt die Gates, die Sie direkt konfigurieren oder abfragen. Alle folgenden Endpunkte sind unter https://api.orbit.devotel.io/api/v1/compliance verwurzelt.
DNC und RND pruefen gegen nationale Register — die FTC-Bundes- und Bundesstaats-Do-Not-Call-Register sowie den TCR Universal Opt-Out fuer DNC und die FCC Reassigned Numbers Database fuer RND. Es handelt sich nicht um Feeds, die Sie anschliessen oder pro Mandant integrieren: Sobald ein Register-Snapshot vorhanden ist, pflegt die Plattform ihn zentral, statt aus Ihrer eigenen Integration zu lesen. Die Pruefung ist jedoch standardmaessig deaktiviert — jedes Gate meldet federal_feeds_synced / feed_synced als false, bis tatsaechlich ein Snapshot dafuer synchronisiert wurde, und bleibt hinter einem organisationsweiten Opt-in-Schalter. Solange nicht beides zutrifft, liefern diese Endpunkte eine Deaktiviert-Antwort, und eine Nummer, die nur in einem Bundesregister steht, wird als frei zurueckgemeldet (siehe jeweils unten fuer das genaue Verhalten jedes Gates). Diese Seite ist keine Rechtsberatung — klaeren Sie Ihre TCPA-/FCC-Pflichten mit rechtlichem Beistand.

BAA — das HIPAA-Sende-Gate

Wenn Ihre Organisation den HIPAA-Modus aktiviert (Sie verarbeiten PHI), wird jede ausgehende Sendung — Einzelnachrichten und Kampagnenversand gleichermassen — blockiert, bis ein unterzeichnetes, laufendes Business Associate Agreement (BAA) hinterlegt ist. Die Unterzeichnung des BAA ist der erste Schritt der HIPAA-Sequenz; das Send Gate ist die nicht umgehbare Durchsetzungsinstanz. Ein blockierter Versand liefert 422 HIPAA_BAA_REQUIRED mit einem reason von pending, expired oder not_signed, und die docs_url im Fehlerpayload verweist auf den BAA-Unterzeichnungsablauf. Ein 500 HIPAA_BAA_GATE_DB_FAIL bedeutet, dass das Gate den BAA-Status nicht verifizieren konnte — es schlaegt geschlossen fehl (Sendungen bleiben blockiert), statt eine unpruefbare PHI-Uebertragung zu riskieren. Versuchen Sie es in Kuerze erneut; bei anhaltenden Problemen kontaktieren Sie den Support.
Das Gate prueft auch den Audit-Trail: Wenn die BAA-Statusabfrage nicht validiert werden kann, wird die Sendung blockiert und der Fehler im PHI-Audit protokolliert, statt still durchgelassen zu werden.
Ein unterzeichnetes BAA hat eine Laufzeit von einem Jahr; der Ablauf wird zum Sendezeitpunkt aus dem Unterzeichnungszeitstempel neu abgeleitet, sodass ein abgelaufenes BAA erneut blockiert, selbst wenn der taegliche Ablaufpruefungs-Cron noch nicht gelaufen ist. Wenn Ihre Organisation den HIPAA-Modus nicht bestaetigt, ist dieses Gate wirkungslos — es inspiziert ausschliesslich Organisationen, die PHI im Geltungsbereich deklariert haben. Die vollstaendige Sequenz finden Sie unter HIPAA-Onboarding: vom BAA bis zur Audit-Bereitschaft.

Ruhezeiten

Ruhezeit-Regeln blockieren Nachrichten und Anrufe, die ausserhalb der zulaessigen Ortszeit des Empfaengers eingehen wuerden (z. B. das TCPA-Fenster 8 bis 21 Uhr). Orbit ermittelt die Ortszeit des Empfaengers aus der Region seiner Telefonnummer. GET /quiet-hours/preview sagt Ihnen, ob eine Sendung jetzt zulaessig ist, und wann der naechste zulaessige Zeitpunkt liegt — nutzen Sie ihn, um das Fenster zu umplanen.
Ruhezeit-Gating ist pro Kanal und Organisation opt-in — jeder Kanal wird mit ausgeschaltetem Schalter ausgeliefert, sodass SMS-, WhatsApp- und andere Sendungen eines neuen Mandanten nicht durch Ruhezeiten gehalten werden, bis Sie das Gate fuer diesen Kanal aktivieren. Sie aktivieren ihn pro Kanal in den Ruhezeit-Einstellungen Ihrer Organisation im Orbit-Dashboard; die aufgefuehrten Fenster gelten dann automatisch. Nach der Aktivierung gelten die Fenster 08:00–21:00 (Empfaenger-Ortszeit) fuer SMS/Voice und 09:00–21:00 fuer WhatsApp-/Meta-Kanaele, sofern Sie keine eigenen start_hour/end_hour-Werte setzen. E-Mail, Fax und Push sind nicht ruhezeit-gated.
US-Voice-TCPA-Fenster: Hinweis fuer ad-hoc-Anrufe, harte Blockierung fuer Kampagnen. Fuer ausgehende Voice-Anrufe an US-Empfaenger (+1) wertet Orbit bei jedem Anruf das bundesweite TCPA-Diallfenster von 8 bis 21 Uhr Empfaenger-Ortszeit aus — wie das Ergebnis durchgesetzt wird, haengt jedoch vom Anrufpfad ab:
  • Ad-hoc-1:1-Waehlvorgang aus dem Dashboard ist standardmaessig ein Hinweis. Ein Anruf ausserhalb des Fensters erzeugt einen strukturierten Hinweis-Log, wird aber trotzdem ausgefuehrt. Um solche Anrufe stattdessen zu halten, aktivieren Sie den Voice-Ruhezeit-Schalter fuer Ihre Organisation; damit wird das 8–21-Uhr-Fenster als harter Halt angewendet.
  • Kampagnen- und Dialer-Voice-Verkehr wird ausserhalb des Fensters immer hart blockiert, unabhaengig von Ihren Mandanten-Einstellungen. Ein Kampagnen- oder Dialer-Anruf ausserhalb von 8–21 Uhr Empfaenger-Ortszeit wird mit 422 TCPA_FEDERAL_DIALING_WINDOW_BLOCKED abgelehnt — es gibt kein organisationsweites Opt-out fuer automatisierten oder Massen-Voice-Verkehr, und der Voice-Ruhezeit-Schalter lockert dies nicht. Kann die Zeitzone des Empfaengers nicht aufgeloest werden, schlaegt der Anruf geschlossen fehl und wird ebenfalls blockiert.
Planen Sie Kampagnen- und Dialer-Anrufe innerhalb des Fensters von 8 bis 21 Uhr Empfaenger-Ortszeit — nutzen Sie GET /quiet-hours/preview, um den naechsten zulaessigen Zeitpunkt zu finden.

DNC — Do Not Call

GET /dnc/check meldet, ob eine Nummer auf einer Do-Not-Call-Liste steht, bevor Sie sie anrufen oder anschreiben. Zum Gesamtbild — Quellen, Datenaktualitaet und den Fail-open-Vorbehalt — siehe DNC-Scrubbing.
Wenn aktiviert, liefert er:
Die source gibt an, welche Ebene die Nummer markiert hat (Ihr Kontakt-DNC- Flag, die DNC-Liste, die Unterdrueckungsliste oder ein Consent-Opt-out).
Das Gate gilt nur, solange kein Do-Not-Call-Feed synchronisiert ist. In diesem Zustand liegt der Endpunkt hinter der Organisations-Einstellung dnc_sync_enabled (standardmaessig aus) und liefert 403 DNC_SYNC_NOT_ENABLED, bis Sie zustimmen — und damit anerkennen, dass Orbit noch nicht gegen ein Bundesregister fuer Sie prueft, sodass eine Nummer, die nur in der FTC-Liste steht, als on_dnc: false zurueckgelesen wird.Sobald Orbit einen Bundes-, Bundesstaats- oder TCR-Snapshot synchronisiert hat, wird das dnc_sync_enabled-Gate umgangen: Der Endpunkt antwortet direkt und federal_feeds_synced liefert true. Lesen Sie dieses Feld bei jeder Antwort, um zu pruefen, ob eine Bundespruefung das Ergebnis tatsaechlich unterstuetzt.

Batch-Vorpruefung

POST /dnc/scrub fuehrt dieselbe Kette in einem Aufruf gegen eine ganze Liste aus — bis zu 500 E.164-Nummern pro Anfrage, mit optionalem country-Zustaendigkeitsfilter. Er liefert Einzelurteile pro Nummer plus Zusammenfassungszaehler on_dnc / clear, ist auf 10 Anfragen pro Minute und Organisation begrenzt und liegt hinter dem oben beschriebenen Gate.
Zum Kampagnen-Workflow — Gating, Chunking, Weiterleitung markierter Nummern in die Unterdrueckung und Wiederholungsintervalle — siehe Batch-DNC-Vorpruefung.

Fehlerbehebung bei einem geateten Aufruf

Wenn einer der DNC-Endpunkte bei 403 DNC_SYNC_NOT_ENABLED haelt:
  1. Den Gate-Zustand ohne Pruefung bestaetigen — rufen Sie GET /dnc/availability auf. Er meldet das genaue Gate, das beide Endpunkte durchsetzen: available, Ihren org_opt_in und federal_feeds_synced.
  2. Die Organisations-Bestaetigung aktivieren — schalten Sie dnc_sync_enabled in den Compliance-Einstellungen Ihres Dashboards ein. Das Flag gilt pro Organisation und schlaegt geschlossen fehl: Ein nie gesetztes Flag, ein als String oder Zahl statt als boolesches true gespeicherter Wert oder eine fehlschlagende Einstellungsabfrage ergeben alle AUS — eine Organisation, die die Compliance-Einstellungen nie aufgerufen hat, erhaelt immer die 403.
  3. Oder auf den Snapshot warten — sobald die Plattform einen Bundes-, Bundesstaats- oder TCR-Feed synchronisiert, entfaellt das Gate von selbst und federal_feeds_synced wechselt zu true; die Bestaetigung wird nicht mehr abgefragt.
  4. Die Aehnlichkeiten trennen401 ist Authentifizierung, 422 ist eine fehlerhafte Telefonnummer, und 429 bei /dnc/scrub ist dessen 10-Anfragen-pro-Minute-Ratenlimit, nicht das Gate.
Die vollstaendige Anleitung ist Fehlerbehebung: DNC-Vorpruefung 403.

RND — Reassigned Numbers Database

US-Telefonnummern werden an neue Personen neu vergeben. Die Reassigned Numbers Database der FCC erlaubt Ihnen zu pruefen, ob eine Nummer nach dem Datum Ihrer Einwilligung abgemeldet wurde — eine „Safe-Harbor“-Absicherung gegen das Anschreiben oder Anrufen der falschen Person. GET /rnd/check nimmt die phone und das consent_date (YYYY-MM-DD):
Solange feed_synced false ist, ist dies die einzige Antwort des Endpunkts, unabhaengig von phone und consent_date — noch sind keine Abmeldedaten hinterlegt, sodass jedes Urteil auf no_data abgeleitet wird. status ist einer von yes, no oder no_data — das Urteil der FCC-Datenbank fuer das Paar (phone, consent_date): safe_harbor ist nur dann true, wenn status no ist. last_disconnect_date ist das juengste hinterlegte dauerhafte Abmeldedatum (null, wenn keines existiert), und feed_synced ist false, bis die RND-Feed-Einspeisung konfiguriert ist — solange es false ist, lautet jedes Urteil no_data. Geatet hinter rnd_scrub_enabled (standardmaessig aus); liefert 403 RND_SCRUB_NOT_ENABLED, solange deaktiviert.

RND-Scrubbing aktivieren und deaktivieren

Mit PUT /api/v1/compliance/rnd/settings steuern Sie das Flag rnd_scrub_enabled:
Die Aktivierung wird mit HTTP 409 RND_FEED_NOT_CONFIGURED blockiert, bis der FCC-Reassigned-Numbers-Database-Feed (der reassigned.us-Feed von SomosGov) mit Ihrer Bereitstellung verbunden ist. Das Aktivieren des Features vor der Feed-Einspeisung wuerde eine Compliance-Kontrolle ohne tatsaechliche Pruefung auf Neuvergabe erzeugen — Sie wuerden das Flag setzen, doch jeder Blick auf /rnd/check wuerde weiterhin no_data liefern. Die 409-Blockierung verhindert diese falsche Schutzsicherheit. Deaktivieren (enabled: false) ist immer erlaubt, auch wenn noch kein Feed verbunden ist.

RMD — Robocall Mitigation Database

US-Voice-Originatoren muessen eine Robocall Mitigation Database-Registrierung einreichen, die ihren STIR/SHAKEN-Status und ihren Mitigationsplan beschreibt. Orbit speichert und verfolgt Ihre Einreichung.
  • GET /rmd — lesen Sie Ihre Registrierung plus einen recertification-Block mit renewal_deadline und action_required.
  • POST /rmd — Einreichung erstellen oder aktualisieren.
  • POST /rmd/submit → Status submitted.
  • POST /rmd/certify → Status active.
  • POST /rmd/remediation (mit einem reason) → Status remediation_required.
  • POST /rmd/resolve → zurueck zu active.
  • POST /rmd/withdraw → Status withdrawn.
stir_shaken_status ist complete, partial oder none. Ein mitigation_plan ist erforderlich, sofern der Status nicht complete ist. Der Lebenszyklus lautet draft → submitted → active → remediation_required → active | withdrawn.

Notfallstopp

Der Notfallstopp ist ein organisationsweiter Notschalter, der sofort saemtlichen ausgehenden SMS-, MMS-, Voice- und Dialer-Verkehr stoppt — nutzen Sie ihn bei einem Vorfall (eine fehlerhaft konfigurierte Kampagne, ein kompromittierter Schluessel, ein Inhaltfehler). Das vollstaendige Betriebshandbuch finden Sie im Notfallstopp-Leitfaden.
GET /emergency-stop liefert das aktuelle active-Flag plus activated_at, activated_by und reason. Aktivierung und Deaktivierung erfordern einen Admin-/Owner-Schluessel.
Solange der Notfallstopp aktiv ist, wird der gesamte ausgehende SMS-, MMS-, Voice- und Dialer-Kampagnenverkehr der Organisation blockiert. Transaktionale Verify/OTP-Sendungen und E-Mail sind vom Notfallstopp nicht betroffen — sie laufen ueber separate Auslieferungspfade, sodass ein Kontakt bei aktivem Schalter weiterhin einen Login-Code erhalten kann. Wenn Sie auch diese unterbrechen muessen, deaktivieren Sie das betreffende Verify-Profil oder den E-Mail-Absender. Deaktivieren Sie den Stopp, sobald der Vorfall behoben ist.

Praeferenzcenter

Das Praeferenzcenter ist eine oeffentliche, token-signierte Seite, auf der ein Kontakt seine Kanal-Opt-ins, die Nachrichtenhaeufigkeit und (falls aktiviert) Datenloeschungsantraege selbst verwaltet — ohne Anmeldung. Aktualisierungen fliessen direkt in Einwilligung, Unterdrueckung und den STOP-Zaun. Konfigurieren Sie es einmal und erzeugen Sie anschliessend einen Link pro Kontakt. Die vollstaendige Anleitung — jedes Konfigurationsfeld, die Linkplatzierung und die Aktualisierungsflaechen — finden Sie im Praeferenzcenter-Leitfaden:
  • POST /preference-center (Admin/Owner) — Branding, die angebotenen channels, Haeufigkeitsoptionen und den DSGVO-Loeschungsschalter setzen.
  • GET /preference-center — die aktuelle Konfiguration lesen.
  • POST /preference-center/link mit { "contactId": "cnt_…" } — einen signierten Link (HMAC-SHA256, 30-Tage-TTL) erstellen und dem Kontakt per E-Mail oder SMS zustellen.
Der Kontakt nutzt dann den oeffentlichen Link (GET/PUT /compliance/preferences/{token}), um seine Praeferenzen zu sehen und zu aktualisieren. Ein Opt-out hier erfasst eine Einwilligungswiderruf, legt einen Unterdrueckungseintrag an und setzt den STOP-Zaun; ein erneutes Opt-in macht das rueckgaengig.
Eine Loeschanfrage aus dem Praeferenzcenter erfasst nur einen Legacy-DSGVO- Loeschantrag — sie markiert den Kontakt zur Loeschung, startet aber nicht die protokollierte DSAR-Pipeline. Sie hat keine SLA-Uhr, keinen exportierten Datenexport und kein Artikel-17-Loeschzertifikat. Um einen Recht-auf-Loeschung-Antrag zu stellen, der SLA-protokolliert ist, die Kontaktdaten exportiert und ein Loeschzertifikat erzeugt, verwenden Sie den DSAR-Endpunkt (POST /compliance/dsar, nur Owner/Admin) — siehe Daten-Selbstauskunftsantraege.

Laenderregelungen

GET /country-rules ist die schreibgeschuetzte regulatorische Referenz hinter diesen Gates — pro Land und Kanal meldet er die zulaessigen Absendertypen, ob eine Sender-ID-Registrierung none / recommended / required ist, STOP-Schluesselwort-Anforderungen, Zweiwege-Unterstuetzung, DLR-Unterstuetzung und den Standard-Durchsatz.
Nutzen Sie ihn, um vor dem Markteintritt zu verstehen, was jedes Ziel verlangt — siehe Compliance-Anforderungen nach Land fuer eine feldweise Anleitung zum Lesen dieser Referenz.

Verwandte Referenzen