Un long code est un numéro de téléphone standard à 10 chiffres qui envoie et reçoit des SMS. C'est l'expéditeur par défaut pour les conversations bidirectionnelles, l'OTP et les alertes à volume modéré. Pour le trafic applicatif américain, il est enregistré via l'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"
Quand un long code est le bon choix.
Les long codes sont l'un des quatre types d'expéditeurs disponibles sur l'interface Numéros SMS Bird, qui fait partie de l<hub>API SMS Bird</hub>. Ils sont locaux, bidirectionnels et rapides à provisionner : le bon point de départ pour la plupart des flux conversationnels et transactionnels avant que le volume ne justifie un code court.
Ce qu'un long code vous apporte.
Présence locale, trafic bidirectionnel, volume modéré.
- 01
Un numéro local à 10 chiffres.
Les destinataires voient un indicatif de leur propre pays ou région, ce qui se lit comme un véritable expéditeur plutôt qu'un envoi marketing en masse.
- 02
Bidirectionnel par défaut.
Dirigez le trafic entrant du numéro vers un webhook et les réponses arrivent sous forme d'événements signés, la base des flux conversationnels.
- 03
Enregistré via l'A2P 10DLC.
Le trafic applicatif américain passe par des campagnes 10DLC enregistrées, ce qui lui vaut un débit vérifié et la confiance des opérateurs plutôt qu'un risque de filtrage.
- 04
Actif dès que l'enregistrement aboutit.
Achetez le numéro immédiatement ; il commence à porter du trafic enregistré une fois sa campagne 10DLC approuvée.
Achetez-en un et commencez à envoyer.
Recherchez par pays et fonctionnalité, puis achetez le numéro avec le même client que celui utilisé pour l'envoi. Le trafic entrant est routé par un webhook d'espace de travail abonné à sms.received, et non par numéro. La même structure de code provisionne tout type d'expéditeur ; seul number_type change.
// 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..."
L'enregistrement fait partie du contrat.
Pour envoyer du trafic application-to-person vers des numéros américains, un long code passe par une campagne A2P 10DLC enregistrée. Bird dépose la marque et la campagne depuis le tableau de bord et signale le statut d'approbation via l'API, pour que vous sachiez exactement quand le plein débit est disponible.
Autres façons d'envoyer
Les long codes sont l'un des quatre types d'expéditeurs. Comparez les autres.
Commencez sur un long code, montez en charge au besoin.
Les long codes sont l'un des types d'expéditeurs de la surface des numéros SMS de Bird. Provisionnez-en un, enregistrez la campagne et routez l'entrant depuis la même API que celle avec laquelle vous envoyez.