Numeri

Il mittente giusto per ogni messaggio.

Numeri lunghi, codici brevi, numeri toll-free e sender ID alfanumerici: provisioning, registrazione e instradamento attraverso un unico endpoint. Il mittente da cui invii determina throughput, costi e quale regime di conformità si applica.

send-notification.ts

202 · 0.4s

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const { data, error } = await bird.sms.send({
  from:     "Bird",
  to:       "+31612345678",
  text:     "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
  category: "transactional",
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_01m11jw130e7svjzv70kgqr38w"

send-notification.ts

202 · 0.4s

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const { data, error } = await bird.sms.send({
  from:     "Bird",
  to:       "+31612345678",
  text:     "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
  category: "transactional",
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_01m11jw130e7svjzv70kgqr38w"

Quattro tipi di mittente, un'unica API.

I numeri sono il fondamento dell'API SMS di Bird. Cerca la disponibilità, acquista un numero e instrada l'inbound verso un webhook con lo stesso client con cui già invii. Quale tipo scegliere dipende dal volume, dalla geografia e da quanta registrazione puoi gestire.

Quale mittente dovrei usare?

Throughput, copertura e impegno di registrazione differiscono per tipo di mittente. La maggior parte del traffico applicativo USA inizia su un long code 10DLC; i programmi one-to-many ad alto volume passano a uno short code.

Tipo di mittente	Ideale per	Registrazione
Long code (10DLC)	Conversazioni bidirezionali, OTP, alert a volume moderato	Brand + campagna A2P 10DLC
Short code	Marketing e alert one-to-many ad alto volume	Verificato dal carrier, tempi di attesa in settimane
Toll-free	Traffico USA/Canada senza 10DLC, throughput superiore a un long code	Verifica toll-free
Sender ID alfanumerico	Alert brandizzati unidirezionali dove il paese lo consente	Pre-registrazione in molti paesi

Scegli un tipo di numero

Ogni tipo di mittente nel dettaglio: copertura, throughput e requisiti di registrazione.

Long codeNumeri locali a 10 cifre per il traffico bidirezionale, registrati tramite A2P 10DLC.Short codeNumeri a 5–6 cifre costruiti per l'invio one-to-many ad alto throughput.Toll-freeNumeri toll-free verificati per il traffico USA e Canada senza 10DLC.Sender ID alfanumericiInvia dal nome del tuo brand dove il paese di destinazione lo consente.

Cerca, acquista e instrada in poche chiamate.

Trova un numero per paese e funzionalità e acquistalo dallo stesso SDK con cui invii i messaggi. Il traffico in entrata viene instradato tramite un webhook del workspace iscritto a sms.received anziché per singolo numero, quindi una sola sottoscrizione copre tutti i numeri in tuo possesso. Il numero è attivo non appena l'eventuale registrazione richiesta viene completata.

provision.ts

201 · purchased

const { data: page, error: searchError } = await bird.numbers.available
  .list({
    country_code: "US",
    number_type:  "local",
    capabilities: ["sms"],
  })
  .safe();
if (searchError) throw searchError;

const { data: order, error: orderError } = await bird.numbers.orders
  .create({ number: page.data[0].number })
  .safe();
if (orderError) throw orderError;

console.log(order.status, order.number_id); // → "completed" "nda_0ydh2yfw..."

Registrazione, gestita dove è richiesta.

La maggior parte del traffico applicativo USA richiede la registrazione di brand e campagna A2P 10DLC; il toll-free richiede la verifica; molti paesi richiedono la pre-registrazione del sender ID. Bird gestisce ciascuna di queste dal dashboard e la superficie di conformità monitora lo stato dall'API.