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.`,
  category: "authentication",
}).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 sendertypen op Bird SMS-nummers, onderdeel van de bredere Bird SMS API. Het is de optie waar u naar grijpt wanneer één nummer een hoog volume naar veel ontvangers moet versturen, en u bereid bent inrichtingssnelheid in te ruilen voor de doorvoer en het carriervertrouwen dat erbij hoort.

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.

Het inrichten van een short code gebruikt dezelfde client en dezelfde call-structuur als elk ander sendertype: alleen het type-veld verandert. Zoek op land en functionaliteit, koop het nummer en koppel inkomend verkeer aan 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 door carriers wordt goedgekeurd voor high-volume one-to-many SMS: marketingcampagnes, meldingen en OTP met hoge snelheid. Het is het sendertype met de hoogste doorvoer, en het doorloopt een carrier-goedkeuring voordat het kan verzenden.
Hoe lang duurt het provisioneren van een short code?
Plan in weken, niet in minuten. Carriers beoordelen elk short code-programma voordat het live gaat, dus een short code brengt een echte doorlooptijd met zich mee — anders dan een long code, die u direct kunt kopen en waarmee u kunt verzenden zodra de registratie is afgerond.
Dedicated of gedeelde short code?
Een dedicated short code is uitsluitend van u, dus de verzendreputatie is volledig de uwe. Een shared short code deelt een nummer tussen afzenders via keywords: goedkoper, sneller op te starten, maar u erft de reputatie van iedereen die het nummer deelt.
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