Lange codes, korte codes, toll-free nummers en alfanumerieke afzender-ID's: ingericht, geregistreerd en gerouteerd via één endpoint. Het afzendertype bepaalt de doorvoer, de kosten en welk complianceregime van toepassing is.
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 afzendertypes, één API.
Nummers zijn het fundament van de Bird SMS API. Zoek beschikbaarheid, koop een nummer, en route inbound naar een webhook met dezelfde client waarmee je al verstuurt. Welk type je kiest, hangt af van volume, geografie en hoeveel registratie je op je kunt nemen.
Welke afzender moet ik gebruiken?
Throughput, bereik en registratie-inspanning verschillen per afzendertype. Het meeste Amerikaanse applicatieverkeer begint op een 10DLC long code; programma's met hoog volume van één naar velen gaan over naar een short code.
| Afzendertype | Beste voor | Registratie |
|---|---|---|
| Long code (10DLC) | Two-way gesprekken, OTP, alerts bij gematigd volume | A2P 10DLC brand + campagne |
| Short code | Marketing en alerts van één naar velen op hoog volume | Door carriers getoetst, doorlooptijd in weken |
| Toll-free | VS/Canada-verkeer zonder 10DLC, hogere throughput dan een long code | Toll-free verificatie |
| Alfanumerieke sender ID | One-way branded alerts waar het land het toestaat | Preregistratie in veel landen |
Kies een nummertype
Elk afzendertype in detail: bereik, doorvoer en wat er nodig is om te registreren.
Zoek, koop en route in een paar calls.
Zoek een nummer op land en functionaliteit, koop het en verwijs het inkomende verkeer naar een webhook — alles vanuit dezelfde SDK waarmee je berichten verstuurt. Het nummer is actief zodra een eventueel vereiste registratie is afgerond.
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..."Registratie, geregeld waar het vereist is.
Het meeste Amerikaanse applicatieverkeer vereist A2P 10DLC brand- en campagneregistratie; toll-free vereist verificatie; veel landen vereisen sender-ID-preregistratie. Bird beheert elk hiervan vanuit het dashboard, en de compliance-surface volgt de status via de API.
De rest van het SMS-platform
Eén API, één set keys. Verken de andere mogelijkheden.
Provisioneer het juiste nummer, route het in minuten.
Nummers zijn één mogelijkheid van de Bird SMS API: verzenden, two-way inbound, compliance, routering en analytics komen ermee mee.