SMS

Short Code, Long Code, Toll-Free oder alphanumerisch: Welchen SMS-Absendertyp sollte ich verwenden?

Wählen Sie einen Absendertyp, den das Zielland unterstützt, und verwenden Sie eine Nummer, wenn Empfänger antworten können müssen.

Ein Absender, der in einem Zielland funktioniert, kann in einem anderen unzulässig sein. Auch die Antwortfähigkeit hängt von der jeweiligen Nummer und ihrer Route ab.

Was sind die vier Absendertypen?

Bird unterstützt Long Codes, Short Codes, Toll-Free-Nummern und alphanumerische Absenderkennungen. Ihre API-Werte sind long_code, short_code, toll_free und alphanumeric.

Die Länderrichtlinie kann Toll-Free-Nummern erlauben und gleichzeitig Long Codes ablehnen. Auch die Registrierungsanforderungen können sich unterscheiden:

The toll_free value is distinct from long_code. A country can permit one and refuse the other, and the two usually demand different registration.

  • Long Code. Eine gewöhnliche Telefonnummer für Messaging. Senden und Empfangen hängen von ihren SMS-Fähigkeiten und der Zielland-Unterstützung ab.
  • Toll-Free. Eine SMS-fähige Nummer in einem unterstützten Toll-Free-Nummernbereich, mit eigenen Verifizierungs- und Routing-Anforderungen.
  • Short Code. Eine kurze numerische Kennung für Messaging-Programme. Länge, Verfügbarkeit, Senderate und Registrierung variieren je nach Markt.
  • Alphanumerisch. Ein Name, der als Absender angezeigt wird, mit einer Begrenzung auf 11 Zeichen. Ein längerer Markenname erfordert eine kürzere Absenderkennung. Empfänger können nicht darauf antworten.

Welche Absendertypen können eine Antwort empfangen?

Geeignete Long Codes, Toll-Free-Nummern und Short Codes können Antworten unterstützen. Prüfen Sie die SMS-Fähigkeiten der Nummer und die Ziellandroute, da die Nummernform allein keine Antwortfähigkeit garantiert.

Wenn Ihr Programm eingehende Nachrichten benötigt, wählen Sie eine Nummer mit Antwortfähigkeit, da Empfänger nicht auf einen alphanumerischen Namen antworten können. Diese Anforderung gilt auch, wenn ein Abonnent ein Stopp-Schlüsselwort an den Absender zurücksenden muss.

Die Länderrichtlinie gibt die Antwortfähigkeit als direction mit dem Wert one_way oder two_way für jeden Absendertyp an. Mit einer unterstützten Nummer und Route können eingehende SMS Ihre Anwendung erreichen.

Wie wähle ich, ohne die Regeln jedes Landes zu kennen?

Verwenden Sie die veröffentlichten Absendertyp-Richtlinien des Ziellandes und prüfen Sie dann die Anforderungen des Absenders, den Sie verwenden möchten. Ein Land veröffentlicht Richtlinieneinträge für seine gemeldeten Absendertypen. Ein fehlender Typ wird dort nicht unterstützt. Ein gelisteter Typ hat weiterhin seinen eigenen Verfügbarkeitsstatus.

Jeder Richtlinieneintrag enthält folgende Felder:

  • status, einer von available, restricted, coming_soon oder unavailable.
  • registration_mode, einer der Werte none, optional oder required, und das Programm program, das die Registrierung durchführt, sofern eines vorgesehen ist.
  • sender_id_behavior: preserved behält die von Ihnen übermittelte Absenderkennung bei, overwritten ersetzt sie vor der Zustellung und unknown bedeutet, dass das Verhalten nicht bestätigt ist. Dies ist unabhängig vom Registrierungsmodus: Eine erforderliche Registrierung kann die Absenderkennung auch nach der Genehmigung überschrieben lassen. Eine optionale Registrierung behält die genehmigte Absenderkennung bei und überschreibt sie vor der Genehmigung.
  • registration_timeline_min und registration_timeline_max, in Werktagen, sofern das Land einen Schätzwert veröffentlicht.
  • throughput_mps, die veröffentlichte maximale Senderate in Nachrichten pro Sekunde für diesen Absendertyp und dieses Zielland. Ein Wert von 30 beschreibt beispielsweise eine Obergrenze von 30 Nachrichten pro Sekunde. Ein null-Wert liefert keine veröffentlichte Rate. Prüfen Sie die verfügbare Konto-, Absender- und Carrier-Kapazität, da diese Ihre tatsächliche Senderate zusätzlich einschränken können.
  • direction, Einweg- oder Zweiweg-SMS.
  • allowed_source_countries, die Länder, aus denen der Absender stammen darf. Eine leere Liste bedeutet keine Einschränkung des Herkunftslandes.

Sie können veröffentlichte Länderrichtlinien unter SMS-Ziele vergleichen. Prüfen Sie die Anforderungen Ihres Absenders separat, da die Länderrichtlinie nicht den Registrierungsstatus dieses Absenders festlegt:

bird sms senders requirements <sender-id> --country-code NL

Eine nicht leere allowed_source_countries-Liste beschränkt die Zulässigkeit auf Absender aus diesen Ländern. Ein Absender aus einem anderen Land hat unter dieser Richtlinie keine Route. Eine Registrierung kann diesen Ursprung nicht zulässig machen.

Was bestimmt, welchen Absender Bird tatsächlich verwendet?

Für einen Freitext-API-Versand geben Sie den zulässigen Absender in from an. Die API wählt keinen Absenderpool, wenn Sie dieses Feld weglassen. Ein System-Template-Versand wählt seinen Absender aus dem Template. Der zurückgegebene from-Wert identifiziert den für diese Nachricht verwendeten Absender.

Die Routing-Priorität der Länderrichtlinie wählt nicht den Absender für eine Freitext-Anfrage. Ihre Anwendung gibt ihn an.

Registrierung und Zugang zum Zielland sind getrennt. Ein registrierter Absender kann trotzdem blockiert werden, wenn der Workspace das Zielland nicht aktiviert hat, mit E12020.

Was sollte ich konkret tun?

  1. Wählen Sie einen Absendertyp, den das Zielland unterstützt, einschließlich etwaiger Herkunftsland-Einschränkungen.
  2. Wählen Sie eine unterstützte Nummer, wenn Antworten erforderlich sind, einschließlich eingehender Stopp-Schlüsselwörter.
  3. Planen Sie die erforderliche Registrierung und jede optionale Registrierung ein, die Sie wählen, und nutzen Sie den veröffentlichten Zeitrahmen zur Planung des Starts.
  4. Vergleichen Sie die veröffentlichte Senderate-Obergrenze mit Ihrer Spitzenlast und bestätigen Sie dann die Konto-, Absender- und Carrier-Kapazität.
  5. Bestätigen Sie die Absender-Registrierung und den Zugang des Workspaces zum Zielland vor dem Versand.

Kurz gesagt

  1. Bird unterscheidet vier Absendertypen.

    Die API listet long_code, short_code, alphanumeric und toll_free auf. Ein Zielland kann einen Typ erlauben und einen anderen ablehnen.

  2. Antworten erfordern eine unterstützte Nummer und Route.

    Ein alphanumerischer Absender kann nur senden. Eine Nummer benötigt SMS-Fähigkeit und eine unterstützte Eingangsroute, um Antworten zu empfangen.

  3. Die Länderrichtlinie legt die zulässigen Absendertypen fest.

    Die Ziellandrichtlinie gibt die Verfügbarkeit von Absendertypen und zulässige Herkunftsländer an. Eine Registrierung erzeugt keine fehlende Route.

  4. Registrierung und Kapazität hängen vom Absendertyp und Zielland ab.

    Veröffentlichte Registrierungszeiten sind Schätzwerte. Die maximale Senderate wird in Nachrichten pro Sekunde angegeben.

In die Praxis umsetzen.

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.

Bauen Sie auf demselben Netzwerk auf.

Ein Test-API-Schlüssel steht Ihnen sofort zur Verfügung. Der Produktivbetrieb wird freigeschaltet, sobald Sie eine Zahlungsmethode hinzufügen und einen Absender verifizieren.

Ihre nächste Idee.
Bereit zur Verbindung.