# SMS-Absenderkennungen Ein Absender ist der Wert in `from`, den Empfänger bei Ihrer SMS sehen. Ihr Workspace enthält einen Absender pro Identität, über die er senden kann. Jedes Zielland legt fest, welche Absendertypen es akzeptiert und welche Registrierungen vorab erforderlich sind. Einen Absender zu besitzen und über ihn senden zu dürfen, sind zwei getrennte Schritte. Dieser Leitfaden behandelt beide. Auf der Seite [**Senders**](https://bird.com/dashboard/w/sms/senders) wird jeder Absender mit seinem Status und der Anzahl der aktiven, ausstehenden oder zu bearbeitenden Ziele aufgeführt. Den Sendeaufruf und die Validierung des Werts `from` beschreibt [SMS senden](/docs/guides/sms/sending-sms#sender). ## Absendertypen Der `sender_type` eines Absenders bezeichnet die Art seiner Identität. Davon hängen die Anforderungen der einzelnen Länder ab: - **Alphanumerische Absenderkennung**: eine kurze Markenkennung wie `BIRD` mit 3 bis 11 ASCII-Buchstaben, Ziffern, Leerzeichen, Bindestrichen, Unterstrichen oder Punkten und mindestens einem Buchstaben. Leerzeichen, Bindestriche, Unterstriche und Punkte dürfen nicht am Anfang oder Ende stehen. Empfänger sehen Ihren Namen anstelle einer Nummer und können darauf nicht antworten. Viele Länder verlangen vor dem Versand eine Registrierung. Einige Länder, darunter die USA, akzeptieren diesen Typ überhaupt nicht. Diese Kennung beanspruchen Sie selbst. - **Lange Rufnummer**: eine gewöhnliche Nummer in Ihrem Besitz, über die Sie senden und empfangen können. Für Anwendungsnachrichten an Personen benötigt eine lange US-Rufnummer eine registrierte Marke und Kampagne. Siehe [10DLC-Registrierung](/docs/guides/sms/10dlc). - **Gebührenfreie Nummer**: eine Nummer, bei der die angerufene Partei die Kosten trägt und die in Nordamerika auch für Nachrichten genutzt werden kann. Bevor Sie dort über eine solche Nummer senden, müssen Sie die Verifizierung gebührenfreier Nummern abschließen. - **Kurzwahlnummer**: eine kurze nationale Nummer für ein genehmigtes Nachrichtenprogramm. Länge und Durchsatz richten sich nach dem Markt und dem Programm des Netzbetreibers. Bird weist Kurzwahlnummern zu, statt sie zu verkaufen. Dieser Typ ist daher nicht im Self-Service erhältlich. Ein Absender gibt außerdem `source_kind` an. Dieses Feld bezeichnet seine Grundlage: `alpha` für eine beanspruchte Absenderkennung, `number` für eine dedizierte Nummer in Ihrem Besitz und `shared_number` für eine von Bird verwaltete Nummer, über die Ihr Workspace sendet. Das Dashboard verwendet dafür die Bezeichnungen **Alphanumeric**, **Dedicated number** und **Shared number**. [Nummerntypen](/docs/guides/numbers/number-types) erläutert die Auswahl des eigentlichen Nummerntyps. [Eine Nummer kaufen und freigeben](/docs/guides/numbers/buying-numbers) beschreibt die Zuweisung. Welche Typen ein Land akzeptiert und ob es sie prüft, ändert sich mit den Regeln der Netzbetreiber und Regulierungsbehörden. [SMS-Zielländer](/products/sms/destinations) veröffentlicht den aktuellen Stand je Land. Prüfen Sie ihn dort, statt von den Regeln eines Nachbarlands auszugehen. ## Eine alphanumerische Absenderkennung beanspruchen Das Beanspruchen einer Absenderkennung ist kostenlos und wird sofort wirksam. Öffnen Sie auf der Seite [**Senders**](https://bird.com/dashboard/w/sms/senders) die Aktion **Add sender**, wählen Sie **Add sender ID** und geben Sie die Kennung ein. Über die API: ```cli bird sms senders create --type alpha --sender BIRD ``` Die Antwort enthält die `id` des neuen Senders mit dem Präfix `snd_`, und jede weitere Operation in diesem Leitfaden verwendet diese ID. Ein erfolgreich beanspruchter Sender kann dort senden, wo keine Registrierung erforderlich oder sie optional ist, sobald diese Zielländer aktiviert sind. Eine erforderliche Registrierung muss zuerst genehmigt werden. Hier können zwei Ablehnungen auftreten. `412` bedeutet, dass Ihre Organisation die für diese Operation erforderliche Identitätsprüfung noch nicht abgeschlossen hat. Schließen Sie sie im [**Identity Center**](https://bird.com/dashboard/w/trust) ab und versuchen Sie es erneut. `409` bedeutet, dass die Absenderkennung bereits beansprucht ist. Dieser Aufruf erstellt ausschließlich den Typ `alpha`. Eine dedizierte Nummer wird bei ihrer Zuweisung aus dem Bestand zum Absender: Mit dem Kauf der Nummer erhalten Sie auch ihren Absender. Kurzwahlnummern und gemeinsam genutzte Nummern werden einem Workspace von Bird zugewiesen und nicht gekauft. ## Die Anforderungen eines Landes prüfen Eine Abfrage zeigt, welche Anforderungen die einzelnen Länder an einen Absender stellen. Sie liefert eine eigenständig vollständige Zeile pro Land, das der Absender erreichen kann: ```cli bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL ``` Lassen Sie `--country-code` weg, um die für den Absender relevanten Länder zu erhalten. Ein leeres gefiltertes Ergebnis bedeutet, dass der Absender keine Route in dieses Land hat. Lesen Sie sechs Felder einer Zeile, bevor Sie senden: - **`registration_mode`** ist `none`, `optional` oder `required`. `none` erfordert keine Länderregistrierung. In Kombination mit einer `overwritten`-Absenderkennung ist eine Registrierung nicht verfügbar. Ältere explizite Registrierungen können weiterhin für `none`-Richtlinien mit `unknown`- oder `preserved`-Verhalten erfasst werden, blockieren den Versand aber nie. `optional` erlaubt dem Sender, während der Registrierung weiter zu senden. `required` blockiert den Versand bis zur Genehmigung. - **`program`** identifiziert den Registrierungsablauf, wenn das Land einen benennt, z. B. `alpha` oder `numeric`. Es kann `null` sein, wenn kein benanntes Programm zutrifft. - **`sender_id_behavior`** ist `unknown`, `preserved` oder `overwritten`. Es ist unabhängig von `registration_mode`: Eine erforderliche Registrierung kann die Absenderkennung auch nach der Genehmigung überschrieben lassen. Optionale Registrierung meldet `overwritten` vor der Genehmigung und `preserved` nach der Genehmigung für die genehmigten Nachrichtenkategorien. - **`status`** gibt an, wo der Sender beim Registrierungsprogramm des Landes steht. Im `required`-Modus wartet der Versand auf `approved`. Im `optional`-Modus verfolgt der Status die Registrierungsarbeit, blockiert den Versand aber nicht. [Registrierungsstatus](#registrierungsstatus) listet jeden Wert auf. - **`destination_enabled`** gibt an, ob Ihr Workspace dieses Land aktiviert hat. Das ist eine Workspace-Einstellung und hat nichts mit dem Sender zu tun. Sie wird zuerst geprüft, sodass eine vollständig genehmigte Registrierung trotzdem Nachrichten ablehnt, solange das Zielland deaktiviert ist. Aktivieren Sie Länder unter [**Destinations**](https://bird.com/dashboard/w/sms/destinations); [Senden von SMS](/docs/guides/sms/sending-sms#before-you-send-enable-the-destination-country) beschreibt die Zulassungsliste. - **`next`** listet in Reihenfolge auf, was das Land voranbringt. Eine leere Liste bedeutet, dass nichts aussteht. Jeder Eintrag benennt eine Aktion und erklärt, warum sie sich lohnt, sodass ein Land unter Carrier-Prüfung die zu lesende Ressource benennt, anstatt ein Ergebnis zu wiederholen, das dieser Ressource gehört. Die Zeilen enthalten außerdem `timeline_min_days` und `timeline_max_days`: die übliche minimale und maximale Genehmigungsdauer des Landes in Arbeitstagen. Veröffentlicht das Land keine Schätzung, steht dort `null`. Bei einer abgelehnten Registrierung nennt `rejection_reason` den Grund. Dieselben Informationen erscheinen auf der Detailseite des Absenders im Dashboard als Tabelle **Destinations** mit den Spalten **Status**, **Country** und **Category**. Ein Land, das Sie weder aktiviert noch registriert haben, erscheint nicht in dieser Tabelle, da dort nichts aussteht. ## Einen Absender für ein Land registrieren Die Registrierung gilt jeweils für ein Land. Der Aufruf nimmt den Absender und das Land gemeinsam entgegen: ```cli bird sms senders registrations create snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL bird sms senders registrations create snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL --category marketing ``` `--category` beschränkt die Registrierung auf eine der Kategorien `transactional`, `marketing`, `authentication` oder `service`. Lassen Sie den Parameter weg, um sämtliche Kategorien zu registrieren. Das Dashboard führt denselben Aufruf über **Register** in der Länderzeile des Absenders aus. Der weitere Ablauf hängt vom Land ab. Wenn das Land Registrierungen prüft, wird der Datensatz mit `pending` zurückgegeben und noch nichts berechnet. Ohne Prüfung wird er mit diesem Aufruf genehmigt. Die Registrierung einer Nummer ist kostenlos. Bei einer kostenpflichtigen alphanumerischen Absenderkennung fallen eine Einrichtungsgebühr und eine monatlich wiederkehrende Gebühr an. Beide werden bei Genehmigung der Registrierung berechnet. Eine prüfpflichtige Registrierung wird daher zunächst ohne Berechnung angelegt. Weder dieser Aufruf noch die Anforderungsabfrage nennt einen Preis. Klären Sie die Kosten mit der für das Konto zuständigen Person, bevor Sie die Registrierung vornehmen. Wenn ein Programm Ihre Angaben in einem Formular erfasst, bleibt die Registrierung bei `pending`, bis Sie es ausgefüllt haben. Die Länderzeile des Absenders bietet dann **Complete** an. Damit öffnen Sie die Fragen des Programms zu Ihrem Unternehmen und Ihren Nachrichten. Vier mögliche Ablehnungen: | Antwort | Bedeutung | | :------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `402` | Das Guthaben reichte nicht aus, als die Abrechnung lief. Laden Sie es auf und versuchen Sie es erneut. | | `409` | Für dieses Land existiert bereits eine Registrierung in einem anderen Zustand als abgelehnt oder gesperrt, einschließlich einer noch `pending` Prüfung befindlichen. Der Status allein entscheidet nicht, ob der Sender senden kann: Prüfen Sie `registration_mode`, `destination_enabled` und ob die Registrierung die Nachrichtenkategorie abdeckt. | | `412` | Ihre Organisation hat eine nicht erfüllte Identitätsverifizierungsanforderung. Schließen Sie diese im [**Identity Center**](https://bird.com/dashboard/w/trust) ab und versuchen Sie es erneut. | | `422` | Der Sender wird von einem Programm mit eigenem Ablauf abgedeckt, z. B. US 10DLC, gebührenfreie Verifizierung oder ein Short Code. Siehe [Programme mit eigenem Ablauf](#programme-mit-eigenem-ablauf). | Rufen Sie dieselbe Operation erneut auf, um eine abgelehnte Registrierung erneut einzureichen oder eine gesperrte Registrierung zu reaktivieren. Dafür gibt es keine gesonderte Operation. ## Registrierungsstatus Eine Länderregistrierung durchläuft die folgenden Status. Das Dashboard zeigt sie jeweils als Bezeichnung in Satzschreibweise in der Absenderzeile an: | Status | Bedeutung und nächster Schritt | | :---------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `registration_required` | `registration_mode` des Landes ist `required` und es wurde keine Registrierung gestartet. Registrieren Sie den Sender für das Land. | | `pending` | Die Registrierungsarbeit hat begonnen. Wenn das Programm ein Formular verlangt, schließen Sie es über **Complete** in der Zeile des Landes ab. | | `under_review` | Die eingereichten Informationen werden geprüft oder müssen geändert werden. `program_ref` in der Zeile verweist auf die eigene Ressource des Programms – der einzige Ort, an dem eine laufende Prüfung von einer auf Sie wartenden unterscheidbar ist. | | `bird_approved` | Die Prüfung durch Bird wurde bestanden, die Carrier-Genehmigung steht aus. Es wird nichts von Ihnen verlangt. | | `carrier_pending` | An den genehmigenden Carrier oder das Register übermittelt. Es wird nichts von Ihnen verlangt. | | `approved` | Registrierung genehmigt. | | `rejected` | Die Registrierung wurde abgelehnt. Lesen Sie `rejection_reason`, korrigieren Sie sie und registrieren Sie sich erneut über **Resubmit**. | | `suspended` | Eine zuvor aktive Registrierung ist gesperrt. Registrieren Sie sich erneut über **Register again**, um sie zu reaktivieren. | | `not_required` | Keine aktive Registrierung blockiert den Versand. Prüfen Sie `registration_mode` und `sender_id_behavior`: `none` erfordert keine Länderregistrierung und macht sie nicht verfügbar, wenn die Absenderkennung überschrieben wird; `optional` bietet Registrierung an, ohne den Versand zu blockieren. | Mit Änderungen an den Registrierungsprogrammen kommen neue Status hinzu. Behandeln Sie einen unbekannten Wert als einen von Ihrem Code noch nicht unterstützten Fall. Lesen Sie `next` in der Zeile, um die nächste Aktion für das Land zu ermitteln. Manche Programme erlauben mit einer Registrierung den Versand in mehrere Länder. Eine einzelne Verifizierung einer gebührenfreien Nummer oder eine Kampagnenregistrierung kann daher mehrere Ziele freischalten. ## Absenderstatus und nächste Aktionen Der eigene `status` eines Absenders beschreibt die ihm zugeordneten Ressourcen. Ob ein bestimmtes Land eine Nachricht akzeptiert, ist eine separate Frage: - **`active`**: Bei den Ressourcen dieses Absenders steht nichts aus. Ein Absender ohne Registrierung in irgendeinem Land zeigt `active` an, selbst wenn jedes erreichbare Land vorab eine Registrierung verlangt. - **`pending_number_ownership`**: Der Nachweis, dass Sie die Nummer dieses Absenders besitzen, liegt noch nicht vollständig vor. Entweder wurde er noch nicht eingereicht oder das Land, das die Nummer vergeben hat, hat ihn noch nicht akzeptiert. Bis zur Klärung wird jeder Versand über diesen Absender abgelehnt. Die [Nummernübersicht](/docs/guides/numbers/overview#the-status-of-an-allocated-number) beschreibt diesen Lebenszyklus. - **`pending_registrations`**: Dem Absender sind Länderregistrierungen zugeordnet, von denen noch keine genehmigt ist. Das kann eine laufende Prüfung oder eine Ablehnung bedeuten. Lesen Sie `next`, um den konkreten Fall zu erkennen. Daneben gruppiert `destinations` die für den Absender eingerichteten Länder danach, wer den nächsten Schritt ausführen muss. Die Liste [**Senders**](https://bird.com/dashboard/w/sms/senders) zeigt diese drei Gruppen als Spalten: - **"Active"**: Länder, an die Sie heute senden können, in Ihren Zieleinstellungen aktiviert und entweder keine erforderliche Registrierung verlangend oder mit einer genehmigten Registrierung. Eine optionale Registrierung kann weiterhin ausstehen, während der Versand mit überschriebener Absenderkennung verfügbar bleibt. - **"Pending"**: Länder, deren Registrierung läuft und auf Bird oder einen Netzbetreiber wartet. Sie müssen nichts unternehmen. Nach der Genehmigung wechseln sie zu **"Active"**. - **"Needs attention"**: Länder mit einer von Ihnen angelegten Registrierung, die nicht einsatzbereit ist und Ihre Mitwirkung erfordert. Die Registrierung wurde abgelehnt oder zurückgezogen, oder sie ist genehmigt, während das Ziel deaktiviert ist. Diese drei Gruppen umfassen ausschließlich Länder, für die Sie eine Registrierung besitzen. Ein Land, das Sie registrieren könnten, aber noch nicht registriert haben, erscheint in keiner Gruppe. Unter [Anforderungen eines Landes](#die-anforderungen-eines-landes-prüfen) finden Sie sämtliche erreichbaren Länder und ihre jeweiligen Anforderungen. Eine Absenderabfrage, die nächste Aktionen berechnet, gibt diese in `next` zurück. Dasselbe Feld wird in den Anforderungszeilen verwendet. Ein Absender kennt nur seinen eigenen Zustand. Bei länderspezifischen Aufgaben verweist er deshalb auf die Anforderungsabfrage, ohne ein Zielland für Sie auszuwählen. ## Programme mit eigenem Ablauf Das `program` eines Landes bezeichnet sein Registrierungsprogramm für einen Absendertyp. Zwei Programme verwenden den Registrierungsaufruf aus diesem Leitfaden, drei haben einen eigenen Ablauf: | Programm | Gilt für | Ablauf | | :---------------- | :----------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- | | `alpha` | eine alphanumerische Absenderkennung | [Einen Absender für ein Land registrieren](#einen-absender-für-ein-land-registrieren) und das vom Land verlangte Formular ausfüllen | | `numeric` | eine lange Rufnummer | [Einen Absender für ein Land registrieren](#einen-absender-für-ein-land-registrieren) und das vom Land verlangte Formular ausfüllen | | `10dlc` | eine lange US-Rufnummer | Eine Marke und eine Kampagne registrieren, anschließend die Nummer verknüpfen: [10DLC-Registrierung](/docs/guides/sms/10dlc) | | `tfn` | eine gebührenfreie US-Nummer | Verifizierung gebührenfreier Nummern auf der Seite [**Toll-free verifications**](https://bird.com/dashboard/w/sms/tfn-verifications) | | `ctia_short_code` | eine US-Kurzwahlnummer | Bird verwaltet den Antrag. Sie müssen nichts unternehmen. | Der Registrierungsaufruf gibt für Absender in den Programmen `10dlc`, `tfn` oder `ctia_short_code` den Status `422` zurück. Nutzen Sie den Ablauf des jeweiligen Programms. Die Verifizierung einer gebührenfreien Nummer beginnt als Entwurf, den Sie in einer oder mehreren Aktualisierungen ausfüllen und anschließend zur Prüfung beim Netzbetreiber einreichen. Sie durchläuft `draft`, `submitted`, `under_review`, `info_requested`, `approved` und `rejected`. Eine Verifizierung mit `info_requested` lässt sich bearbeiten und erneut einreichen. Eine abgelehnte Verifizierung lässt sich erneut einreichen, solange das Zeitfenster dafür geöffnet ist. Beim Einreichen wird der Antrag dem Netzbetreiber zur Prüfung übergeben. Deshalb muss eine Person diesen Schritt autorisieren. Über die CLI und den MCP-Server von Bird können Sie eine Verifizierung entwerfen und korrigieren. Das Einreichen selbst erfolgt im Dashboard. ## Den Versand über einen Absender beenden Die drei Möglichkeiten zum Beenden unterscheiden sich darin, welche Daten erhalten bleiben. Sie finden alle drei als Dashboard-Aktionen auf der Detailseite des Absenders. Bereits berechnete Einrichtungsgebühren werden bei keiner davon erstattet: | Aktion | Wirkung | | :-------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Deregister** für ein Land | Kündigt die wiederkehrende Gebühr und behält die Registrierung bei. Eine erneute Registrierung für dieses Land setzt dieselbe Registrierung ohne erneute Einrichtungsgebühr fort. Bei Registrierungspflicht endet der Versand in dieses Land. Ist die Registrierung optional, geht der Versand weiter, da er nicht von der Registrierung abhing. | | **Remove** für eine Registrierung | Entfernt die Länderregistrierung vollständig, kündigt die wiederkehrende Gebühr und entfernt das Ziel aus der Liste des Absenders. Eine erneute Registrierung für das Land erstellt einen neuen Datensatz und berechnet die Einrichtungsgebühr erneut. | | Den Absender löschen | Gibt einen alphanumerischen Absender frei. Seine Länderregistrierungen werden entfernt, seine wiederkehrende Gebühr wird gekündigt und er kann nicht mehr verwendet werden. Wenn Sie dieselbe Kennung später erneut beanspruchen, entstehen ein neuer Absender und neue Registrierungen. Die Einrichtungsgebühren fallen erneut an. | Einen Absender auf Grundlage einer Nummer löschen Sie nicht hier. Geben Sie stattdessen die dedizierte Nummer frei. Damit wird auch ihr Absender entfernt. Ein Absender auf einer von Bird verwalteten gemeinsam genutzten Nummer lässt sich nicht entfernen. Eine 10DLC- oder gebührenfreie Registrierung beenden Sie über ihr eigenes Programm: Trennen Sie die Kampagnenverknüpfung oder stornieren Sie die Verifizierung, statt die allgemeine Abmeldeoperation zu verwenden. ## Nächste Schritte Vergleichen Sie [SMS-Nummern und Absenderkennungen](/products/sms/numbers) oder prüfen Sie die [Absenderregistrierung](/products/sms/compliance/sender-id-registration) für Ihre Einführung. | Seite | Inhalt | | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | [SMS senden](/docs/guides/sms/sending-sms) | Der Sendeaufruf, die akzeptierten `from`-Formate und die Freigabeliste für Ziele | | [10DLC-Registrierung](/docs/guides/sms/10dlc) | Das Modell aus Marke, Kampagne und Nummer für A2P-Nachrichten in den USA | | [Nummerntypen](/docs/guides/numbers/number-types) | Die Wahl zwischen Mobilfunk-, Orts-, nationalen, gebührenfreien und Kurzwahlnummern | | [SMS-Zielländer](/products/sms/destinations) | Welche Absendertypen die Länder akzeptieren und welche registriert werden müssen | | [Abmeldungen und Schlüsselwörter](/docs/guides/sms/opt-outs-and-keywords) | Schlüsselwortantworten, die ein Absender beachten muss, und die daraus entstehenden Versandsperren | ## Related resources - [Registering your SMS sender ID](/learn/sms/registering-your-sms-sender-id) (video) - [What is sender ID registration, and why do some countries require it?](/explained/sms/what-is-sender-id-registration) (answer) - [Build your first integration](/learn/paths/integration) (course) [Get an implementation brief](/learn/workspace?topic=sms-senders)