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.`,
}).safe();

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

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

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

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

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