Short code

Costruito per inviare su larga scala.

Uno short code è un numero a 5–6 cifre costruito per gli SMS one-to-many ad alto volume: marketing, alert e OTP ad alta frequenza. I carrier verificano ogni programma prima che possa inviare, quindi i tempi di provisioning si misurano in settimane anziché in minuti.

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

Dove si colloca uno short code.

Uno short code è uno dei quattro tipi di mittente sui numeri SMS di Bird, parte della più ampia API SMS di Bird. È l'opzione a cui ricorri quando un singolo numero deve spingere alti volumi verso molti destinatari — e sei disposto a barattare la velocità di provisioning con il throughput e la fiducia dei carrier che ne derivano.

Cosa ti dà uno short code.

Throughput elevato, verificato dai carrier, fatto per il one-to-many.

  1. 01

    Il throughput più elevato di qualsiasi tipo di mittente.

    Uno short code è progettato perché un singolo numero trasporti un carico in uscita pesante, ed è ciò che fa arrivare in tempo una campagna in giornata o un fan-out di alert.

  2. 02

    Dedicato o condiviso.

    Prendi uno short code dedicato e la sua reputazione di invio è solo tua; condividine uno dietro delle keyword per avviarti più velocemente e a minor costo, al prezzo di ereditare la reputazione dei tuoi vicini.

  3. 03

    Verificato dai carrier prima di inviare.

    Ogni programma di short code viene esaminato dai carrier, così il numero arriva con la loro fiducia già consolidata anziché doverla guadagnare sotto traffico reale.

  4. 04

    Ideale per il one-to-many.

    Invii di marketing, alert transazionali e OTP ad alta frequenza si adattano tutti a uno short code. Per il traffico bidirezionale conversazionale un long code è di solito il punto di partenza migliore.

Cercalo, acquistalo e instradalo.

Provisionare uno short code usa lo stesso client e la stessa forma di chiamata di qualsiasi altro tipo di mittente — cambia solo il campo type. Cerca per paese e capacità, acquista il numero e indirizza il suo inbound verso un 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();

La verifica ti procura il throughput.

Il compromesso è diretto: uno short code si guadagna il suo throughput elevato e affidabile presso i carrier passando prima per la verifica, quindi metti in conto un tempo di attesa in settimane. Ricorri a uno quando il volume di un programma supera ciò che un long code sostiene, oppure quando ti serve un tasso di invio alto e prevedibile dal primo giorno. Se il tuo traffico è bidirezionale e conversazionale, o il volume è moderato, un long code è attivo prima e costa meno per iniziare.

FAQ sugli short code

Cos'è uno short code SMS?+
Uno short code è un numero a 5–6 cifre che i carrier approvano per gli SMS one-to-many ad alto volume — campagne di marketing, alert e OTP ad alta frequenza. È il tipo di mittente con il throughput più elevato e passa attraverso la verifica del carrier prima di poter inviare.
Quanto tempo serve per provisionare uno short code?+
Pianifica in settimane, non in minuti. I carrier verificano ogni programma di short code prima che vada in produzione, quindi uno short code comporta un tempo di attesa reale — a differenza di un long code, che puoi acquistare e da cui iniziare a inviare non appena la registrazione è superata.
Short code dedicato o condiviso?+
Uno short code dedicato è solo tuo, quindi la sua reputazione di invio è interamente tua. Uno short code condiviso suddivide un numero tra più mittenti dietro delle keyword — più economico e più rapido da avviare, ma erediti la reputazione di tutti gli altri che lo usano.
Quando dovrei usare invece un long code?+
Quando il traffico è bidirezionale e conversazionale, oppure quando il volume non giustifica la verifica e i tempi di attesa. Un long code è locale, bidirezionale di default e attivo non appena la sua campagna 10DLC è superata.

Scegli il tipo di mittente che il tuo volume richiede.

Uno short code è uno dei tipi di mittente sulla superficie dei numeri SMS di Bird. Provisionane uno quando volume e throughput giustificano la verifica e instrada l'inbound dalla stessa API con cui invii.

Inizia con un canale.
Aggiungi gli altri quando sei pronto.

Una chiave API di test è subito tua. La produzione si sblocca quando aggiungi un metodo di pagamento e verifichi un mittente.

Usi Claude Code, Cursor o Codex? Copia un prompt di configurazione e il tuo agente installerà la CLI e le skill di Bird per te. Scegli il tuo:

Cursor