SMS API FAQ

Installieren Sie das SDK und senden Sie in etwa fünf Minuten an den zugelassenen Testempfänger +15005550006. Sie können einen CI-Check ausliefern, bevor Sie eine Nummer bereitstellen.

Ein Sende-Endpunkt, Zwei-Wege-Eingangsverkehr, Nummernbereitstellung (Long Codes, Short Codes, gebührenfreie Nummern und alphanumerische Absenderkennungen), A2P 10DLC- und Opt-out-Compliance, Direct-to-Carrier-Routing und Zustellanalysen – alles über eine API.

Bird erreicht über 150 Länder über 240 direkte Carrier-Verbindungen, mit Carrier-Grade-Routenumschaltung, wenn ein Carrier-Pfad sich verschlechtert.

Um Application-to-Person-Verkehr an US-Nummern zu senden, ja. Die Marken- und Kampagnenregistrierung erfolgt im Dashboard, und der Status ist über die API abfragbar.

Pro Nachricht, zu einem Tarif, der vom Zielland und dem verwendeten Sendertyp abhängt – ein US-Long-Code und eine alphanumerische UK-Sender-ID werden also separat berechnet. Die Tarife sind pro Land auf der SMS-Preisseite veröffentlicht.

Ja, die Abrechnung erfolgt pro Segment, nicht pro Nachricht. Ein Segment fasst 160 GSM-7-Zeichen oder 70, sobald ein einzelnes Emoji oder ein nicht-lateinisches Zeichen die gesamte Nachricht auf Unicode umstellt. Längere Texte werden aufgeteilt, und jedes Segment wird berechnet – ein einzelnes Sonderzeichen kann die Kosten einer großen Kampagne verdoppeln.

Carrier-Gebühren fallen pro Nachricht an und variieren je nach Ziel und Carrier. In den USA fallen bei 10DLC zusätzlich Registrierungsgebühren für Marke und Kampagne an. Beides ist auf der Seite für SMS-Carrier-Gebühren aufgeführt.

Das SMS-Log zeigt die Segmentanzahl und die Kosten jeder einzelnen Nachricht an, sobald sie bepreist ist; SMS-Metriken aggregieren akzeptiertes Volumen, Segmente und Ausgaben über die Zeit.

Eine GSM-7-Nachricht fasst 160 Zeichen pro Segment; der Wechsel zu Unicode (UCS-2) für Emoji oder nicht-lateinische Schriften reduziert das auf 70. Längere Nachrichten werden über mehrere Segmente verkettet, und das SDK meldet die Anzahl, bevor Sie senden.

Zwölf Segmente, das entspricht ungefähr 1.836 GSM-7-Zeichen oder 804 Unicode-Zeichen. Bird kürzt niemals: Ein Body über dem Limit wird als 422 zurückgegeben. Das Limit zählt Segmente statt Zeichen, weil die beiden Kodierungen unterschiedlich viel fassen.

Bis zu 100 in einem Batch-Aufruf, jede mit eigenem Empfänger und Text. Eine einzelne Nachricht geht an genau einen Empfänger, daher ist ein Batch die Methode zum Verteilen.

Ein Free-Tier-Schlüssel erlaubt 10 Einzelsendungen und 5 Batch-Aufrufe pro Minute; kostenpflichtige Pläne erhöhen beides. Jede Antwort enthält einen IETF-RateLimit-Header, der anzeigt, was übrig ist und wann das Fenster zurückgesetzt wird – takten Sie danach statt nach einer fest kodierten Zahl.

Das wird von den Netzbetreibern festgelegt, nicht von Bird. Ein registrierter 10DLC Long Code erhält Durchsatz basierend auf dem Trust-Score der Marke und dem Kampagnentyp: mehr als eine nicht registrierte Nummer, weniger als ein Short Code. Short Codes erhalten die höchste und berechenbarste Rate.

Für US-Anwendungsverkehr deckt ein 10DLC-Long-Code die meisten Zwei-Wege- und OTP-Anwendungsfälle ab. Programme mit hohem Volumen und Eins-zu-Viele-Versand wechseln zu einem Short Code; Toll-Free ist eine Option für die USA/Kanada ohne 10DLC.

Ein Long Code oder eine Toll-Free-Nummer ist sofort verfügbar und beginnt mit dem Versand, sobald die Registrierung oder Verifizierung abgeschlossen ist. Short Codes werden von den Carriern geprüft und dauern in der Regel mehrere Wochen.

Ja. Long Codes, Short Codes und Toll-Free-Nummern sind bidirektional: Leiten Sie den eingehenden Verkehr einer Nummer an einen Webhook weiter, und Antworten treffen als signierte Events ein. Alphanumerische Sender-IDs sind nur unidirektional.

Das hängt vom Sendertyp und Land ab. US-Anwendungsverkehr erfordert A2P 10DLC, Toll-Free benötigt eine Verifizierung, und viele Länder verlangen eine Vorabregistrierung der Sender-ID – alles direkt über das Dashboard verwaltbar.

Es ist eine kurze Zeichenfolge – in der Regel Ihr Markenname –, die beim Empfänger im „Von"-Feld anstelle einer Telefonnummer angezeigt wird. Es ist eine Bezeichnung auf der Nachricht, keine Nummer, die Ihnen gehört.

Halten Sie sie kurz: in der Regel bis zu 11 Zeichen in GSM-Netzen. Die genaue Beschränkung hängt vom Zielland und Netzbetreiber ab und davon, was jeweils akzeptiert wird.

Eine gebührenfreie Nummer ist eine 8xx-Nummer (800, 888, 877 und die übrigen gebührenfreien Vorwahlen), die SMS in den USA und Kanada senden und empfangen kann. Sie überträgt Anwendungs-Traffic ohne A2P 10DLC, sobald sie die Toll-Free-Verifizierung bestanden hat.

Nein. Gebührenfreie Nummern sind vom A2P 10DLC-System ausgenommen. Stattdessen durchlaufen sie eine Toll-Free-Verifizierung, bei der die Netzbetreiber den Anwendungsfall und den Nachrichteninhalt prüfen, bevor die Nummer mit vollem Volumen senden darf.

Ein 10-stelliger Long Code (10DLC) ist eine standardmäßige lokale Telefonnummer, die für Application-to-Person-SMS in den USA zugelassen ist, sobald Marke und Kampagne bei den Netzbetreibern registriert sind.

Registrierte 10DLC Long Codes erhalten geprüften Durchsatz, der vom Trust-Score der Marke und dem Kampagnentyp abhängt: mehr als eine nicht registrierte Nummer, weniger als ein Short Code.

Ein Short Code ist eine 5–6-stellige Nummer, die von Netzbetreibern für SMS mit hohem Volumen im Eins-zu-viele-Versand zugelassen wird: Marketingkampagnen, Benachrichtigungen und OTP mit hoher Rate. Er bietet den höchsten Durchsatz aller Absendertypen und durchläuft eine Prüfung durch die Netzbetreiber, bevor er senden kann.

Planen Sie in Wochen, nicht in Minuten. Netzbetreiber prüfen jedes Short-Code-Programm, bevor es live geht – ein Short Code hat daher eine echte Vorlaufzeit, anders als eine Long Code-Nummer, die Sie kaufen und nutzen können, sobald die Registrierung abgeschlossen ist.

Ein dedizierter Short Code gehört Ihnen allein – seine Versandreputation liegt vollständig in Ihrer Hand. Ein geteilter Short Code teilt eine Nummer über Keywords auf mehrere Absender auf: günstiger, schneller einsatzbereit, aber Sie übernehmen die Reputation aller anderen Nutzer auf dieser Nummer.

Sie. Bei einem Freitext-Versand übergeben Sie eine Nummer, die Ihrem Workspace gehört, einen Short Code oder eine alphanumerische Absenderkennung, sofern das Zielland dies zulässt. Lassen Sie den Absender weg, wird der Versand abgelehnt statt geraten. Ein Template-Versand ist die Ausnahme, da er seinen eigenen Absender auswählt.

Sie teilt Bird und den Netzbetreibern mit, warum Sie senden, und länderspezifische Compliance-Regeln wie Opt-out-Richtlinien und Ruhezeiten basieren darauf. Bei einem Freitext-Versand ist sie erforderlich; ein Template-Versand übernimmt die Klassifizierung des Templates.

Übergeben Sie einen Idempotency-Key, und eine wiederholte Anfrage gibt das ursprüngliche Ergebnis zurück, anstatt die Nachricht doppelt zu senden. Ohne Key wird ein erneuter Versuch als neue Nachricht behandelt.

Jede Statusänderung löst einen HMAC-signierten Webhook aus (queued, sent, delivered oder failed) – inklusive der Zustellbestätigung des Netzbetreibers und der Segment-Anzahl.

Jede Nachricht, die an Ihre bereitgestellte Nummer gesendet wird, kommt als HMAC-signierter sms.received-Webhook an. Sie verifizieren eine Signatur, lesen from, to und text aus und leiten die Nachricht in Ihre eigene Logik weiter – dasselbe Format, das Sie bereits für Zustellbestätigungen verarbeiten.

Ja. Antworten Sie, indem Sie von derselben Nummer senden, auf der die Nachricht eingegangen ist. Setzen Sie from auf Ihre Nummer und to auf den ursprünglichen Absender – so bleibt der Thread durchgehend auf einer Nummer.

Bird adds the sender to your suppression list and fires sms_suppression.created, and blocks later sends from that sender to that number automatically. HELP returns a help reply and START opts them back in, all handled before they reach your code, so you stay compliant without writing the keyword logic yourself.

Sie benötigen eine Nummer mit Zwei-Wege-Funktion. Langwahlnummern, Kurzwahlnummern und gebührenfreie Nummern unterstützen eingehende Nachrichten; alphanumerische Absenderkennungen sind nur für den Versand und können keine Antworten empfangen.

Ihre Nachricht wird direkt über eine unserer 240 Direktverbindungen an den Mobilfunkbetreiber übergeben – nicht über eine Kette von Resellern. Weniger Zwischenstationen bedeuten weniger Stellen, an denen eine Nachricht hängen bleiben oder eine Zustellbestätigung verloren gehen kann.

Bird wählt die Route in Echtzeit neu. Wenn ein Pfad beginnt, Empfangsbestätigungen zu verlieren oder langsamer zu werden, nimmt die nächste Nachricht eine gesündere Verbindung zum selben Betreiber – und der von Ihnen geschriebene Versandaufruf ändert sich nie.

Jede Nachricht gibt eine Carrier-Zustellbestätigung als sms.delivered- oder sms.failed-Webhook zurück, mit mcc_mnc, Land und latency_ms. Das ist die eigene Bestätigung des Betreibers, keine Schlussfolgerung unsererseits.

Ja. Wir führen bei jedem Versand einen MNP-Lookup durch, um den aktuellen Betreiber des Empfängers zu ermitteln, sodass eine portierte Nummer an den Carrier geroutet wird, der sie tatsächlich hält. Für eigenständige Nummernabfragen siehe Lookup.

Das Routing balanciert Kosten und Zustellqualität pro Ziel. Transaktionaler Verkehr wie Einmalpasswörter bevorzugt den qualitativ hochwertigsten Pfad; Massenverkehr kann sich eher an den günstigsten Kosten orientieren. Die Auswahl erfolgt pro Nachricht, hinter demselben API-Aufruf.

Aus der Zustellbestätigung (DLR) des Netzbetreibers für jeden Versand. Bird ordnet die Bestätigung der Nachricht zu und fasst diese Bestätigungen dann zu Zustell-, Fehler- und Latenzkennzahlen zusammen. Ein Zustellzähler ist die Bestätigung des Netzbetreibers – keine Schätzung von Bird.

Yes, from its own endpoint. The stats API has one breakdown per dimension (carrier, country, originator, category, status, error code, tag) plus daily and hourly series, and each row carries the one dimension you asked for. Crossing two of them, such as a carrier inside a country, means two calls and joining the rows yourself. A failure rate that looks fine nationally often turns out to be one carrier rejecting one sender ID.

Beides. Jeder Zustellstatus wird bereits als Webhook gesendet, sodass Sie aus dem Event-Stream Ihren eigenen Datenspeicher aufbauen können. Die Stats-API ist da, wenn Sie die Aggregation Bird überlassen möchten, statt selbst einen Zähler zu pflegen.

Übergeben Sie die Nachrichten-ID an den Events-Endpunkt und Sie erhalten die vollständige Timeline: eingereiht, gesendet, zugestellt oder fehlgeschlagen – jeweils mit Zeitstempel und im Fehlerfall dem Reason-Code des Netzbetreibers. Das ist der Bericht, den Sie tatsächlich brauchen, wenn ein Kunde sagt, eine SMS sei nie angekommen.

Ja. Ein Opt-out ist umkehrbar. Ein Empfänger, der START sendet, wird von der Sperrliste entfernt und kann wieder Nachrichten empfangen. Die Entscheidung liegt beim Empfänger.

Die Sperrliste ist eine abfragbare API-Ressource. Prüfen Sie eine Nummer, bevor Sie eine Zielgruppe erstellen, damit ein abgemeldeter Empfänger nie erneut in einen Versand aufgenommen wird.

Das hängt davon ab, wohin und was Sie senden. US-Anwendungsverkehr erfordert eine A2P 10DLC-Marken- und Kampagnenregistrierung. Viele Länder verlangen eine Vorabregistrierung der Absenderkennung für alphanumerische Absender. Opt-out-Handling gilt überall und erfordert keine Einrichtung.

Bird reicht jede Registrierung bei den Netzbetreibern oder Registrierungsstellen ein und meldet den Status über die API. Ihr Code kann den Status der Registrierung abfragen und auf die Genehmigung warten, anstatt in eine Kampagne zu senden, die noch nicht aktiv ist.

Nein. Es verwendet denselben Client und dieselben Schlüssel wie Versand, Nummern und Zwei-Wege-Kommunikation. Registrierungsstatus und Sperrliste sind API-Ressourcen neben dem Sendeaufruf, sodass eine einzige Integration sowohl den Versand als auch die zugehörigen Regeln abdeckt.

Um Spoofing einzudämmen, stellen viele Länder nur alphanumerische Absenderkennungen zu, die vorab beim lokalen Netzbetreiber oder der Regulierungsbehörde registriert wurden. Wo diese Regel gilt, wird eine nicht registrierte Absenderkennung abgelehnt oder umgeschrieben.

Bird übernimmt das. Sie geben die Absenderkennung und das Zielland im Dashboard ein, Bird leitet sie an die lokale Registrierungsstelle weiter, und die API meldet den Status, damit Sie wissen, wann die Absenderkennung aktiv ist.

Die Genehmigung läuft über externe Netzbetreiber und Registrierungsstellen und variiert je nach Land – in der Regel Tage bis Wochen. Fragen Sie den Registrierungsstatus über die API ab und warten Sie auf die Freigabe, bevor Sie über diese Absenderkennung senden.

A2P 10DLC ist das US-Netzbetreiber-Framework für Application-to-Person-SMS über standardmäßige 10-stellige Long Codes. Ein Unternehmen registriert die Marke hinter seinem Traffic und eine Kampagne, die die Nachrichten beschreibt – beides wird von den Netzbetreibern geprüft, bevor Durchsatz gewährt wird.

Die Marke ist die juristische Person, die den Traffic sendet. Eine Kampagne beschreibt einen bestimmten Messaging-Anwendungsfall unter dieser Marke. Eine Marke kann mehrere Kampagnen haben, und Nummern werden einer Kampagne zugeordnet, nicht der Marke.

Die Prüfung von Marke und Kampagne läuft über die Netzbetreiber und die Registrierungsstelle und dauert in der Regel Tage bis Wochen. Fragen Sie den Kampagnenstatus über die API ab, damit Ihr Code auf die Genehmigung wartet, bevor er sendet.

Nein. 10DLC ist ein US-Framework. Andere Länder haben eigene Regeln – viele erfordern stattdessen eine Vorab-Registrierung der Absenderkennung, und die Opt-out-Keyword-Verarbeitung gilt überall, wo Sie senden.

Ihr Aufruf an Bird ist es – über HTTPS –, ebenso der eingehende Webhook, den wir Ihnen senden. Den letzten Hop können wir nicht verschlüsseln: SMS ist ein Carrier-Protokoll ohne Ende-zu-Ende-Verschlüsselung, und die Nachricht ist auf dem Endgerät und für den Carrier lesbar. Deshalb sollten Sie keine vertraulichen Informationen im Nachrichtentext übermitteln und für sensible Inhalte WhatsApp oder E-Mail bevorzugen.

Jedes Event ist HMAC-signiert. Verifizieren Sie die Signatur mit dem Secret Ihres Endpunkts, bevor Sie auf die Payload reagieren, und rotieren Sie dieses Secret bei Bedarf über das Dashboard.

In der Region, in der Ihre Organisation gehostet ist – entweder us1 oder eu1. Ihr API-Key trägt dies im Präfix (bk_us1_…, bk_eu1_…), sodass die SDKs und die CLI automatisch den richtigen Endpunkt wählen, ohne dass Sie einen konfigurieren müssen.

Nur das, worauf Sie ihn einschränken. Ein Key enthält eine Liste von Scopes, jeweils mit Lese- oder Schreibrecht, sodass ein Key, der SMS sendet, nicht Ihre Nummern verwalten oder einen anderen Kanal auslesen kann. Steuerungsaktionen wie die Verwaltung von Mitgliedern und das Ausstellen von Keys sind nur im Dashboard möglich – kein Key hat darauf Zugriff.

Beides. Ein Key akzeptiert eine Allowlist von CIDR-Bereichen und lehnt Anfragen von allen anderen Adressen ab. Beim Rotieren bleibt der alte Key für eine Übergangsfrist aktiv (standardmäßig 24 Stunden, oder null für sofortige Sperrung), sodass ein Wechsel keine Downtime erfordert.

Ja. Das Audit-Log ist ein schreibgeschütztes, organisationsweites Protokoll jeder Verwaltungsaktion – mit Akteur, Workspace, Zeitpunkt und Ergebnis – und lässt sich für Ihr eigenes SIEM im OCSF-Format exportieren.

Zertifizierungen und Sicherheitsdokumentation finden Sie im Trust Center unter trust.bird.com. Der Auftragsverarbeitungsvertrag, die Datenschutzerklärung und die Nutzungsrichtlinien sind unter bird.com/legal veröffentlicht. Für einen Vendor-Fragebogen wenden Sie sich an Ihr Bird-Account-Team.