Nummers

De juiste afzender voor elk bericht.

Long codes, short codes, toll-free nummers en alfanumerieke sender ID's — geprovisioneerd, geregistreerd en gerouteerd via één endpoint. De afzender waarvandaan je verstuurt bepaalt throughput, kosten en welk compliance-regime geldt.

send-otp.ts

200 · 0.4s

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..."

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..."

send-otp.ts

200 · 0.4s

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..."

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..."

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, throughput en wat er nodig is om te registreren.

Long codesLokale 10-cijferige nummers voor two-way verkeer, geregistreerd via A2P 10DLC.Short codes5–6-cijferige nummers gebouwd voor verzenden met hoge throughput van één naar velen.Toll-freeGeverifieerde toll-free nummers voor VS- en Canada-verkeer zonder 10DLC.Alfanumerieke sender ID'sVerstuur vanaf je brandnaam waar het bestemmingsland het toestaat.

Zoek, koop en route in een paar calls.

Vind een nummer op land en capability, koop het, en richt het inkomende verkeer op een webhook — allemaal vanuit dezelfde SDK waarmee je verstuurt. Het nummer is live zodra een vereiste registratie rond is.

provision.ts

201 · purchased

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.

SMS-nummers FAQ

Met welk nummertype moet ik beginnen?+

Voor Amerikaans applicatieverkeer dekt een 10DLC long code de meeste two-way- en OTP-cases. Programma's met hoog volume van één naar velen gaan over naar een short code; toll-free is een optie voor de VS/Canada zonder 10DLC.

Hoe lang duurt het om een nummer live te krijgen?+

Een long code of toll-free nummer is direct beschikbaar en begint met verzenden zodra de registratie of verificatie ervan rond is. Short codes worden door carriers getoetst en duren doorgaans weken.

Kan één nummer zowel verzenden als ontvangen?+

Ja. Long codes, short codes en toll-free nummers zijn two-way: richt het inkomende verkeer van een nummer op een webhook en antwoorden komen binnen als ondertekende events. Alfanumerieke sender ID's zijn alleen one-way.

Moet ik registreren voordat ik kan versturen?+

Dat hangt af van het afzendertype en het land. Amerikaans applicatieverkeer vereist A2P 10DLC, toll-free vereist verificatie, en veel landen vereisen sender-ID-preregistratie — allemaal afgehandeld vanuit het dashboard.

De rest van het SMS-platform

Eén API, één set keys. Verken de andere mogelijkheden.

VerzendenDe send-API: segmenten, Unicode-veiligheid, batch en idempotency.Two-wayInkomende SMS en conversationele antwoorden als HMAC-ondertekende webhooks.ComplianceA2P 10DLC-registratie, STOP/HELP opt-out en sender-ID-regels.Routering150+ landen, 240 direct-to-carrier verbindingen en failover.AnalyticsAflever- en engagementmetrics uit carrier delivery receipts.SMS API-overzichtDe volledige SMS API: verzenden, nummers, two-way, compliance, routering en analytics.

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.

Verken het SMS-platform Aan de slag