Numeri

Il mittente giusto per ogni messaggio.

Long code, short code, numeri toll-free e sender ID alfanumerici — provisionati, registrati e instradati attraverso un unico endpoint. Il mittente da cui invii decide throughput, costo e quale regime di conformità si applica.

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

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

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 in profondità — copertura, throughput e cosa serve per registrarlo.

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 capacità, acquistalo e indirizza il suo traffico in entrata verso un webhook — tutto dallo stesso SDK con cui invii. Il numero è attivo non appena viene superata qualsiasi registrazione richiesta.

provision.ts

201 · purchased

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

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

console.log(number.id); // → "num_8KQ2..."

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.

FAQ sui numeri SMS

Con quale tipo di numero dovrei iniziare?

Per il traffico applicativo USA, un long code 10DLC copre la maggior parte dei casi d'uso bidirezionali e OTP. I programmi one-to-many ad alto volume passano a uno short code; il toll-free è un'opzione per USA/Canada senza 10DLC.

Quanto tempo serve per rendere attivo un numero?

Un long code o un numero toll-free è disponibile immediatamente e inizia a inviare una volta superata la sua registrazione o verifica. Gli short code sono verificati dai carrier e tipicamente richiedono settimane.

Un singolo numero può sia inviare che ricevere?

Sì. Long code, short code e numeri toll-free sono bidirezionali: indirizza il traffico in entrata di un numero verso un webhook e le risposte arrivano come eventi firmati. I sender ID alfanumerici sono solo unidirezionali.

Devo registrarmi prima di poter inviare?

Dipende dal tipo di mittente e dal paese. Il traffico applicativo USA richiede A2P 10DLC, il toll-free richiede la verifica e molti paesi richiedono la pre-registrazione del sender ID — tutto gestito dal dashboard.

Il resto della piattaforma SMS

Un'unica API, un unico set di chiavi. Esplora le altre funzionalità.

InvioL'API di invio: segmenti, sicurezza Unicode, batch e idempotency.BidirezionaleSMS in entrata e risposte conversazionali come webhook firmati con HMAC.ConformitàRegistrazione A2P 10DLC, opt-out STOP/HELP e regole sui sender ID.RoutingOltre 150 paesi, 240 collegamenti direct-to-carrier e failover.AnalisiMetriche di consegna ed engagement dalle ricevute di consegna dei carrier.Panoramica dell'API SMSL'API SMS completa: invio, numeri, bidirezionale, conformità, routing e analisi.

Provisiona il numero giusto, instradalo in pochi minuti.

I numeri sono una delle funzionalità dell'API SMS di Bird: invio, bidirezionale in entrata, conformità, routing e analisi arrivano insieme a essi.

Esplora la piattaforma SMS Inizia ora