Sender-ID-Registrierung

Eine alphanumerische Sender-ID ist ein kurzer Markenname (z. B. MyBrand), der bei einer SMS anstelle einer Telefonnummer als Absender erscheint. Viele Länder verlangen, dass Sie eine Sender-ID bei der lokalen Regulierungsbehörde oder den Netzbetreibern registrieren, bevor damit versendeter Verkehr zugestellt wird — manche blockieren unregistrierte alphanumerische Absender ganz. Mit Orbit können Sie Ihre Sender-ID-Registrierungen pro Land hinterlegen, die zugehörigen KYC-Dokumente anhängen und den Genehmigungsstatus jedes Landes verfolgen. Sendezeit-Gates stellen anschließend sicher, dass Verkehr nur dort zugestellt wird, wo eine Sender-ID genehmigt ist. Alle nachfolgenden Endpunkte liegen unter https://api.orbit.devotel.io/api/v1/compliance.

Die Registrierung einer Sender-ID in Orbit startet unseren Compliance-Workflow; die endgültige Genehmigung erteilen die Regulierungsbehörde/der Netzbetreiber im jeweiligen Land, nicht sofort die Plattform. Planen Sie Vorlaufzeit ein — einige Märkte benötigen Tage bis Wochen.

Formatregeln für Sender-IDs

Regel	Wert
Länge	3–11 Zeichen
Zulässige Zeichen	Buchstaben, Ziffern, Leerzeichen, Bindestrich (`-`), Unterstrich (`_`)

Die Obergrenze von 11 Zeichen ist die GSM-7-Bit-Grenze; Regulierungsbehörden wie ANATEL (Brasilien), OFCOM (UK), AGCOM (Italien) und BTRC (Bangladesch) lehnen Sender-IDs mit weniger als 3 Zeichen ab.

Sender-ID registrieren oder aktualisieren

POST /compliance/sender-id-registrations (Admin/Inhaber) reicht eine Sender-ID für ein oder mehrere Länder ein. Jeder Ländereintrag referenziert bereits hochgeladene Compliance-Dokumente über deren doc_…-IDs — Dateien werden hier nicht hochgeladen.

curl -X POST https://api.orbit.devotel.io/api/v1/compliance/sender-id-registrations \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_id": "MyBrand",
    "countries": [
      {
        "country": "BR",
        "document_refs": ["doc_abc123def456"],
        "notes": "Retail brand, transactional + OTP use case"
      }
    ]
  }'

Feld	Typ	Hinweise
`sender_id`	string	3–11 Zeichen, siehe Formatregeln oben.
`countries`	array	1–20 Einträge.
`countries[].country`	string	ISO-3166-1 alpha-2 (Großbuchstaben).
`countries[].document_refs`	string[]	1–20 IDs der Form `doc_…` für zuvor hochgeladene KYC-Dokumente.
`countries[].registration_provider_id`	string	Optionale Downstream-/Anbieterreferenz (≤ 200).
`countries[].notes`	string	Optionaler Freitext, z. B. Anwendungsfall (≤ 2000).

Gibt die Registrierungsansicht mit dem status jedes Landes zurück:

{
  "data": {
    "id": "sidreg_xyz",
    "sender_id": "MyBrand",
    "countries": [
      {
        "country": "BR",
        "status": "pending",
        "document_refs": ["doc_abc123def456"],
        "registered_at": null,
        "expires_at": null,
        "registration_provider_id": null,
        "notes": "Retail brand, transactional + OTP use case"
      }
    ]
  },
  "meta": { "request_id": "…", "timestamp": "2026-06-08T12:00:00.000Z" }
}

Die Einreichung ist ein idempotenter Upsert mit dem Schlüssel (organization, sender_id). Eine erneute Einreichung:

fügt neue Länder mit status: pending hinzu;
behält für ein bereits approved Land die Genehmigung bei und aktualisiert dabei dessen Dokumente, Anbieterreferenz und Hinweise;
setzt ein Land, das rejected oder expired war, auf pending zurück, sodass es erneut geprüft wird.

So können Sie einer bestehenden Sender-ID sicher weitere Länder hinzufügen, ohne bereits erteilte Genehmigungen zu verlieren.

Registrierungen auflisten

GET /compliance/sender-id-registrations gibt jede Sender-ID mit ihrem Status pro Land zurück. Für jeden authentifizierten Benutzer verfügbar.

{
  "data": {
    "entries": [
      {
        "id": "sidreg_xyz",
        "sender_id": "MyBrand",
        "countries": [
          {
            "country": "BR",
            "status": "approved",
            "document_refs": ["doc_abc123def456"],
            "registered_at": "2026-06-05T00:00:00.000Z",
            "expires_at": "2027-06-05T00:00:00.000Z"
          }
        ]
      }
    ],
    "total": 1
  },
  "meta": { "request_id": "…", "timestamp": "2026-06-08T12:00:00.000Z" }
}

Statuslebenszyklus

Status	Bedeutung
`pending`	Eingereicht, wartet auf Prüfung/Genehmigung.
`approved`	Freigegeben — Verkehr mit dieser Sender-ID ist für das Land zulässig.
`rejected`	Abgelehnt; Problem beheben und erneut einreichen, um auf `pending` zurückzusetzen.
`expired`	Das Gültigkeitsfenster der Registrierung ist abgelaufen; zur Verlängerung erneut einreichen.

Wenn ein Ländereintrag den Status approved hat, enthält er registered_at und expires_at. Verlängern Sie vor expires_at, um eine Unterbrechung zu vermeiden.

Sendezeit-Gates setzen die Registrierung durch: A2P-SMS in ein Land, das eine registrierte Sender-ID verlangt, wird blockiert, sofern der Ländereintrag nicht approved ist. Registrieren Sie sich und lassen Sie sich genehmigen, bevor Sie Verkehr in einen neuen Markt starten.

Bei Tenants, die vor der Sender-ID-Migration erstellt wurden, gibt der List-Endpunkt eine leere Menge zurück und POST liefert 409 TENANT_NOT_MIGRATED — wenden Sie sich an den Support, um die Funktion zu aktivieren.

Indien ist ein Sonderfall

Indien verwendet diesen allgemeinen Sender-ID-Workflow nicht. Indische SMS-Sender-IDs („Headers”) werden über das DLT/TRAI-System registriert — siehe DLT-India Onboarding.

Getting Started

Channels

Channels (Voice)

AI Agents

Flows

Numbers & Verify

Concepts

Features

Billing

Webhooks

Security & SSO

Compliance

Legal

Changelog

Sender-ID-Registrierung

Sender-ID-Registrierung

Formatregeln für Sender-IDs

Sender-ID registrieren oder aktualisieren

Registrierungen auflisten

Statuslebenszyklus

Indien ist ein Sonderfall

Verwandte Referenzen

​Sender-ID-Registrierung

​Formatregeln für Sender-IDs

​Sender-ID registrieren oder aktualisieren

​Registrierungen auflisten

​Statuslebenszyklus

​Indien ist ein Sonderfall

​Verwandte Referenzen

Sender-ID-Registrierung

Formatregeln für Sender-IDs

Sender-ID registrieren oder aktualisieren

Registrierungen auflisten

Statuslebenszyklus

Indien ist ein Sonderfall

Verwandte Referenzen