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.
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: "+15005550006",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).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 nel dettaglio: copertura, throughput e requisiti di registrazione.
Cerca, acquista e instrada in poche chiamate.
Trova un numero per paese e funzionalità, acquistalo e indirizza il traffico in entrata verso un webhook, tutto dallo stesso SDK che usi per inviare. Il numero è attivo non appena l'eventuale registrazione richiesta viene completata.
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.
Il resto della piattaforma SMS
Un'unica API, un unico set di chiavi. Esplora le altre funzionalità.
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.