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.`,
  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

Dove si colloca uno short code.

Uno short code è uno dei quattro tipi di mittente disponibili su Bird SMS numbers, parte della più ampia Bird SMS API. È l'opzione ideale quando un singolo numero deve inviare grandi volumi a molti destinatari e sei disposto a sacrificare la velocità di provisioning in cambio del throughput e della fiducia degli operatori 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.

Il provisioning di uno short code utilizza lo stesso client e la stessa struttura di chiamata di qualsiasi altro tipo di mittente: cambia solo il campo type. Cerca per paese e funzionalità, acquista il numero e indirizza il traffico in entrata 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 approvato dagli operatori per l'invio SMS ad alto volume uno-a-molti: campagne marketing, notifiche e OTP ad alta frequenza. È il tipo di mittente con il throughput più elevato e viene sottoposto a verifica da parte dell'operatore prima di poter inviare.
Quanto tempo serve per provisionare uno short code?
Pianifica in settimane, non in minuti. Gli operatori verificano ogni programma short code prima della messa in produzione, quindi comporta tempi di attivazione reali, a differenza di un long code, che puoi acquistare e iniziare a usare non appena la registrazione viene approvata.
Short code dedicato o condiviso?
Uno short code dedicato è esclusivamente tuo, quindi la sua reputazione di invio è interamente la tua. Uno short code condiviso suddivide un numero tra più mittenti tramite keyword: più economico, più rapido da attivare, ma erediti la reputazione di tutti gli altri che lo utilizzano.
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