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.
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: "+31612345678",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_01m11jw130e7svjzv70kgqr38w"
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.
- 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: la base 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 funzionalità e acquista il numero, lo stesso client con cui invii. Il traffico in entrata viene instradato da un webhook del workspace iscritto a sms.received, non per numero. La stessa struttura di codice provisiona qualsiasi tipo di mittente; cambia solo number_type.
// A US long code is a `local` number: the type names the numbering plan's
// own category, and "long code" is not one of them.
const { data: page, error: searchError } = await bird.numbers.available
.list({
country_code: "US",
number_type: "local",
capabilities: ["sms"],
})
.safe();
if (searchError) throw searchError;
const { data: order, error: orderError } = await bird.numbers.orders
.create({ number: page.data[0].number })
.safe();
if (orderError) throw orderError;
console.log(order.status, order.number_id); // → "completed" "nda_0ydh2yfw..."
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.
Mettilo in pratica.
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Altri modi per inviare
I long code sono uno dei quattro tipi di mittente. Confronta gli altri.
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.