Short codes

Gebouwd om te verzenden op schaal.

Een short code is een 5–6-cijferig nummer gebouwd voor SMS met hoog volume van één naar velen: marketing, alerts en OTP op hoge snelheid. Carriers toetsen elk programma voordat het kan verzenden, dus de provisioning-doorlooptijd wordt gemeten in weken in plaats van minuten.

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

Today at 2:14 PM

Hey Ada — your Bird sign-in code is 482917. It'll expire in 10 minutes. Don't share it with anyone.
482917
Delivered

Waar een short code past.

Een short code is een van de vier afzendertypes op Bird SMS-nummers, onderdeel van de bredere Bird SMS API. Het is de optie waar je naar grijpt wanneer één nummer hoog volume naar veel ontvangers moet pushen — en je bereid bent provisioning-snelheid in te ruilen voor de throughput en het carriervertrouwen dat ermee komt.

Wat een short code je geeft.

Hoge throughput, door carriers getoetst, gemaakt voor één naar velen.

  1. 01

    De hoogste throughput van elk afzendertype.

    Een short code is ontworpen om met één nummer een zware uitgaande belasting te dragen, wat ervoor zorgt dat een same-day campagne of alert fan-out op tijd aankomt.

  2. 02

    Dedicated of gedeeld.

    Neem een dedicated short code en de verzendreputatie ervan is alleen van jou; deel er een achter keywords om sneller en goedkoper te starten, ten koste van het erven van de reputatie van je buren.

  3. 03

    Door carriers getoetst voordat het verstuurt.

    Elk short-code-programma wordt door de carriers beoordeeld, dus het nummer arriveert met hun vertrouwen al gevestigd in plaats van het te verdienen onder live verkeer.

  4. 04

    Beste voor één naar velen.

    Marketingverzendingen, transactionele alerts en OTP op hoge snelheid passen allemaal bij een short code. Voor two-way conversationeel verkeer is een long code meestal het betere startpunt.

Zoek, koop en route het.

Een short code provisioneren gebruikt dezelfde client en dezelfde call-vorm als elk ander afzendertype — alleen het type-veld verandert. Zoek op land en capability, koop het nummer, en richt de inbound ervan op een webhook.

short-code.ts
201 · purchased
const { data: available } = await bird.numbers.search({
  country: "US",
  type:    "short-code",
  capabilities: ["sms"],
}).safe();

const { data: number } = await bird.numbers.buy({
  number:  available[0].number,
  webhook: "https://example.com/webhooks/bird",
}).safe();

Toetsing levert je throughput op.

De afweging is direct: een short code verdient zijn hoge, carriergetrouwde throughput door eerst door toetsing te gaan, dus reken op een doorlooptijd in weken. Grijp ernaar wanneer het volume van een programma groter wordt dan wat een long code aankan, of wanneer je een verzendsnelheid nodig hebt die vanaf dag één hoog en voorspelbaar is. Als je verkeer two-way en conversationeel is, of het volume gematigd is, is een long code sneller live en goedkoper om te starten.

Short code FAQ

Wat is een SMS short code?+
Een short code is een 5–6-cijferig nummer dat carriers goedkeuren voor SMS met hoog volume van één naar velen — marketingcampagnes, alerts en OTP op hoge snelheid. Het is het afzendertype met de hoogste throughput, en het gaat door carriertoetsing voordat het kan verzenden.
Hoe lang duurt het provisioneren van een short code?+
Reken in weken, niet minuten. Carriers toetsen elk short-code-programma voordat het live gaat, dus een short code heeft een echte doorlooptijd — anders dan een long code, die je kunt kopen en waarop je kunt beginnen met verzenden zodra de registratie rond is.
Dedicated of gedeelde short code?+
Een dedicated short code is alleen van jou, dus de verzendreputatie ervan is volledig de jouwe. Een gedeelde short code splitst een nummer over afzenders achter keywords — goedkoper, sneller te starten, maar je erft de reputatie van iedereen die er verder op zit.
Wanneer moet ik in plaats daarvan een long code gebruiken?+
Wanneer verkeer two-way en conversationeel is, of het volume de toetsing en doorlooptijd niet rechtvaardigt. Een long code is lokaal, standaard two-way, en live zodra de 10DLC-campagne rond is.

Kies het afzendertype dat je volume vereist.

Een short code is één afzendertype op de Bird SMS-nummers-surface. Provisioneer er een wanneer volume en throughput de toetsing rechtvaardigen, en route inbound vanuit dezelfde API waarmee je verstuurt.

Begin met één kanaal.
Voeg de rest toe wanneer je er klaar voor bent.

Een test-API-key is direct beschikbaar. Productietoegang wordt ontgrendeld zodra je een betaalmethode toevoegt en een afzender verifieert.

Gebruik je Claude Code, Cursor of Codex? Kopieer een setup-prompt en je agent installeert de Bird CLI en skills voor je. Kies de jouwe:

Cursor