Long code

Numeri locali, bidirezionali di default.

Un long code è un numero di telefono standard a 10 cifre che invia e riceve SMS. È il mittente predefinito per conversazioni bidirezionali, OTP e alert a volume moderato. Per il traffico applicativo USA viene registrato tramite A2P 10DLC.

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:       "+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..."
Hi Ada, reminder of your appointment tomorrow at 14:30 with Dr. Kowalski.
Your order #4821 has shipped. Track it: bird.ly/t/4821x
Your subscription renews on 3 Sep for €12/mo. Manage it here: bird.ly/account

Quando un long code è la scelta giusta.

I long code sono uno dei quattro tipi di mittente sulla superficie Bird SMS numbers, parte della più ampia Bird SMS API. Sono locali, bidirezionali e rapidi da attivare: il punto di partenza ideale per la maggior parte del traffico conversazionale e transazionale, prima che i volumi giustifichino uno short code.

Cosa ti dà un long code.

Presenza locale, traffico bidirezionale, volume moderato.

  1. 01

    Un numero locale a 10 cifre.

    I destinatari vedono un prefisso del proprio paese o regione, che si legge come un mittente reale anziché come un invio massivo di marketing.

  2. 02

    Bidirezionale di default.

    Indirizza il traffico in entrata del numero verso un webhook e le risposte arrivano come eventi firmati: la base per i flussi conversazionali.

  3. 03

    Registrato tramite A2P 10DLC.

    Il traffico applicativo USA passa attraverso campagne 10DLC registrate, che ottiene un throughput verificato e la fiducia dei carrier anziché un rischio di filtraggio.

  4. 04

    Attivo non appena la registrazione è superata.

    Acquisti il numero immediatamente; inizia a trasportare traffico registrato una volta approvata la sua campagna 10DLC.

Acquistane uno e inizia a inviare.

Cerca per paese e funzionalità, acquista il numero e instrada il traffico in entrata verso un webhook, lo stesso client con cui invii. La stessa struttura di codice gestisce qualsiasi tipo di mittente; cambia solo il campo type.

long-code.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();

La registrazione fa parte del pacchetto.

Per inviare traffico application-to-person verso numeri USA, un long code passa attraverso una campagna A2P 10DLC registrata. Bird presenta il brand e la campagna dal dashboard e riporta lo stato di approvazione tramite l'API, così sai esattamente quando è disponibile il throughput completo.

Inizia con un long code, scala quando ne hai bisogno.

I long code sono uno dei tipi di mittente sulla superficie dei numeri SMS di Bird. Provisionane uno, registra la campagna 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