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 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.

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.
• Long Code: eine gewöhnliche Nummer, die Sie besitzen. Ein US-Long-Code benötigt eine registrierte Marke und Kampagne, bevor er Application-to-Person-Traffic übertragen darf; siehe 10DLC-Registrierung.
• 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.

Prüfen Sie die capabilities der jeweiligen Nummer, bevor Sie sich auf SMS oder Sprachübertragung verlassen. Der Absendertyp und die ausgehende Registrierung belegen nicht, dass die Nummer Antworten empfangen kann. Nummerntypen erklärt, wie sich die Fähigkeiten je nach Land und Netzbetreiber unterscheiden.

Ein Absender meldet auch source_kind, das angibt, was dahintersteht: alpha für einen von Ihnen beanspruchten Absenderstring, number für eine dedizierte Nummer, die Sie besitzen, und shared_number für eine von Bird verwaltete Nummer, über die Ihr Workspace sendet. Das Dashboard beschriftet diese mit Alphanumeric, Dedicated number und Shared number. Nummer kaufen und freigeben behandelt 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 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 die Aktion Add sender, wählen Sie Add sender ID und geben Sie die Kennung ein. Über die API:

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ätsverifizierung noch nicht abgeschlossen hat. Schließen Sie sie im Identity Center 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:

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 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; Senden von SMS 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:

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. Prüft das Land nichts, wird die Registrierung mit diesem Aufruf genehmigt. Für einen kostenpflichtigen Absender, ob alphanumerisch oder eine Nummer, fallen eine Einrichtungsgebühr und eine monatlich wiederkehrende Gebühr an. Eine prüfpflichtige Registrierung wird zunächst ohne Berechnung angelegt. Ihre Einrichtungsgebühr wird berechnet, wenn ihre Unterlagen eingereicht werden, oder bei Genehmigung, falls keine Unterlagen nötig sind. Die wiederkehrende Gebühr beginnt mit der Genehmigung. 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:

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:

Mit Änderungen an den Registrierungsprogrammen kommen neue Status hinzu. Behandeln Sie einen unbekannten Wert nicht als Fehler, sondern als einen Fall, den Ihr Code noch nicht unterstützt. 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: Mindestens ein Ziel ist aktiv.
• 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 beschreibt diesen Lebenszyklus.
• pending_registrations: Noch kein Ziel ist aktiv. Entweder hat sich der Absender dort nicht registriert, wo eine Registrierung erforderlich ist, seine Registrierung wird geprüft oder sie wurde abgelehnt. Folgen Sie next zur Anforderungsabfrage, um für jedes Land den konkreten Fall zu sehen. Ein neuer Long Code kann diesen Status zeigen, während alle drei Gruppen leer sind.

Daneben gruppiert destinations die für den Absender eingerichteten Länder danach, wer den nächsten Schritt ausführen muss. Die Liste 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.

Ein Land, das eine Registrierung verlangt, für das Sie sich aber nicht registriert haben, erscheint in keiner dieser Gruppen. Unter Anforderungen eines Landes 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:

Wenn Sie die Registrierungsoperation für einen Absender aufrufen, der unter 10dlc, tfn oder short_code fällt, erhalten Sie 422. Verwenden Sie stattdessen das jeweilige Programm.

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:

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 oder prüfen Sie die Absenderregistrierung für Ihre Einführung.