Langwahlnummern, Kurzwahlnummern, gebührenfreie Nummern und alphanumerische Sender-IDs: bereitgestellt, registriert und über einen einzigen Endpoint geroutet. Der Absender, über den Sie senden, bestimmt Durchsatz, Kosten und das geltende Compliance-Regime.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const { data, error } = await bird.sms.send({
from: "Bird",
to: "+15005550006",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."
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 für die Registrierung nötig ist.
Suchen, kaufen und routen in wenigen Aufrufen.
Finden Sie eine Nummer nach Land und Funktion, kaufen Sie sie und leiten Sie eingehenden Traffic an einen Webhook weiter – alles über dasselbe SDK, mit dem Sie auch senden. Die Nummer ist aktiv, sobald eine eventuell 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.
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.