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: "+31612345678",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_01m11jw130e7svjzv70kgqr38w"
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.
Find a number by country and capability and buy it, from the same SDK you send with. Inbound traffic is routed by a workspace webhook subscribed to sms.received rather than per number, so one subscription covers every number you hold. The number is live as soon as any required registration clears.
const { data: page, error: searchError } = await bird.numbers.available
.list({
country_code: "US",
number_type: "local",
capabilities: ["sms"],
})
.safe();
if (searchError) throw searchError;
const { data: order, error: orderError } = await bird.numbers.orders
.create({ number: page.data[0].number })
.safe();
if (orderError) throw orderError;
console.log(order.status, order.number_id); // → "completed" "nda_0ydh2yfw..."
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.