Long Codes, Short Codes, Toll-Free-Nummern und alphanumerische Sender-IDs — bereitgestellt, registriert und geroutet über einen Endpunkt. Der Absender, von dem Sie senden, entscheidet über Durchsatz, Kosten und welches Compliance-Regelwerk gilt.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const code = generateOtp();
const { data, error } = await bird.sms.send({
from: "Bird",
to: "+15005550006",
text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."Today at 2:14 PM
Vier Absendertypen, eine API.
Nummern sind das Fundament der Bird SMS-API. Suchen Sie nach Verfügbarkeit, kaufen Sie eine Nummer und routen Sie eingehenden Traffic an einen Webhook mit demselben Client, mit dem Sie bereits senden. Welchen Typ Sie wählen, hängt vom Volumen, der Geografie und davon ab, wie viel Registrierung Sie übernehmen können.
Welchen Absender sollte ich verwenden?
Durchsatz, Reichweite und Registrierungsaufwand unterscheiden sich je nach Absendertyp. Der meiste US-Anwendungstraffic beginnt auf einem 10DLC-Long-Code; Programme mit hohem One-to-Many-Volumen wechseln zu einem Short Code.
| Absendertyp | Am besten für | Registrierung |
|---|---|---|
| Long Code (10DLC) | Zwei-Wege-Konversationen, OTP, Benachrichtigungen bei moderatem Volumen | A2P 10DLC Marke + Kampagne |
| Short Code | Marketing und Benachrichtigungen mit hohem One-to-Many-Volumen | Carrier-geprüft, Vorlaufzeit in Wochen |
| Toll-Free | USA/Kanada-Traffic ohne 10DLC, höherer Durchsatz als ein Long Code | Toll-Free-Verifizierung |
| Alphanumerische Sender-ID | Einseitige Marken-Benachrichtigungen, wo das Land es erlaubt | Vorabregistrierung in vielen Ländern |
Wählen Sie einen Nummerntyp
Jeder Absendertyp im Detail — Reichweite, Durchsatz und was die Registrierung erfordert.
Suchen, kaufen und routen in wenigen Aufrufen.
Finden Sie eine Nummer nach Land und Fähigkeit, kaufen Sie sie und richten Sie ihren eingehenden Traffic auf einen Webhook — alles über dasselbe SDK, mit dem Sie senden. Die Nummer ist aktiv, sobald jede erforderliche Registrierung abgeschlossen ist.
const { data: available } = await bird.numbers.search({
country: "US",
type: "long-code",
capabilities: ["sms"],
}).safe();
const { data: number } = await bird.numbers.buy({
number: available[0].number,
webhook: "https://example.com/webhooks/bird",
}).safe();
console.log(number.id); // → "num_8KQ2..."Registrierung, dort abgewickelt, wo sie erforderlich ist.
Der meiste US-Anwendungstraffic erfordert eine A2P 10DLC-Marken- und Kampagnenregistrierung; Toll-Free erfordert eine Verifizierung; viele Länder verlangen eine Sender-ID-Vorabregistrierung. Bird betreibt jede davon über das Dashboard, und die Compliance-Oberfläche verfolgt den Status über die API.
SMS-Nummern-FAQ
Mit welchem Nummerntyp sollte ich beginnen?+
Wie lange dauert es, eine Nummer aktiv zu schalten?+
Kann eine Nummer sowohl senden als auch empfangen?+
Muss ich registrieren, bevor ich senden kann?+
Der Rest der SMS-Plattform
Eine API, ein Satz Keys. Entdecken Sie die anderen Funktionen.
Stellen Sie die richtige Nummer bereit, routen Sie sie in Minuten.
Nummern sind eine Funktion der Bird SMS-API: Senden, eingehende Zwei-Wege-Kommunikation, Compliance, Routing und Analytics gehören dazu.