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

Quando un long code è la scelta giusta.

I long code sono uno dei quattro tipi di mittente sulla superficie dei numeri SMS di Bird, parte della più ampia API SMS di Bird. Sono locali, bidirezionali e rapidi da provisionare — il punto di partenza giusto per la maggior parte del traffico conversazionale e transazionale prima che il volume giustifichi uno short code.

Cosa ti dà un long code.

Presenza locale, traffico bidirezionale, volume moderato.

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.
02
Bidirezionale di default.
Indirizza il traffico in entrata del numero verso un webhook e le risposte arrivano come eventi firmati — il fondamento per i flussi conversazionali.
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.
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 capacità, acquista il numero e instrada il suo inbound verso un webhook — lo stesso client con cui invii. La stessa forma di codice provisiona 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.

FAQ sui long code

Cos'è un long code 10DLC?+

Un long code a 10 cifre (10DLC) è un numero di telefono locale standard autorizzato per gli SMS application-to-person negli USA una volta che il suo brand e la sua campagna sono registrati presso i carrier.

Quanto throughput ottiene un long code?+

I long code 10DLC registrati ottengono un throughput verificato che dipende dal trust score del brand e dal tipo di campagna — più di un numero non registrato, meno di uno short code.

Un long code può ricevere risposte?+

Sì. I long code sono bidirezionali: instrada l'inbound del numero verso un webhook e le risposte arrivano come eventi firmati con HMAC.

Quando dovrei passare invece a uno short code?+

Quando il volume one-to-many supera ciò che il throughput di un long code sostiene, oppure quando un programma necessita del tasso più alto e prevedibile che fornisce uno short code verificato dal carrier.

Altri modi per inviare

I long code sono uno dei quattro tipi di mittente. Confronta gli altri.

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.Tutti i numeri SMSConfronta ogni tipo di mittente — copertura, throughput e registrazione.Panoramica dell'API SMSL'API SMS completa: invio, numeri, bidirezionale, conformità, routing e analisi.

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.

Esplora i numeri SMS Inizia ora