Long codes

Numéros locaux, bidirectionnels par défaut.

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.

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

Quand un long code est le bon choix.

Les long codes sont l'un des quatre types d'expéditeurs de la surface des numéros SMS de Bird, qui fait partie de l'API SMS de Bird au sens large. Ils sont locaux, bidirectionnels et rapides à provisionner — le bon point de départ pour la plupart du trafic conversationnel et transactionnel avant que le volume ne justifie un short code.

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.
Pointez le trafic entrant du numéro vers un webhook et les réponses arrivent sous forme d'événements signés — le socle 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 par capacité, achetez le numéro et routez son entrant vers un webhook — le même client que celui avec lequel vous envoyez. La même forme de code provisionne n'importe quel type d'expéditeur ; seul le champ de type change.

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();

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.

FAQ sur les long codes

Qu'est-ce qu'un long code 10DLC ?+

Un long code à 10 chiffres (10DLC) est un numéro de téléphone local standard autorisé pour le SMS application-to-person aux États-Unis une fois sa marque et sa campagne enregistrées auprès des opérateurs.

Quel débit obtient un long code ?+

Les long codes 10DLC enregistrés obtiennent un débit vérifié qui dépend du score de confiance de la marque et du type de campagne — plus qu'un numéro non enregistré, moins qu'un short code.

Un long code peut-il recevoir des réponses ?+

Oui. Les long codes sont bidirectionnels : routez l'entrant du numéro vers un webhook et les réponses arrivent sous forme d'événements signés HMAC.

Quand devrais-je passer plutôt à un short code ?+

Lorsque le volume one-to-many dépasse ce que le débit d'un long code permet, ou lorsqu'un programme nécessite le débit plus élevé et plus prévisible qu'offre un short code vérifié par les opérateurs.

Autres façons d'envoyer

Les long codes sont l'un des quatre types d'expéditeurs. Comparez les autres.

Short codesNuméros à 5–6 chiffres conçus pour l'envoi one-to-many à fort débit.Toll-freeNuméros toll-free vérifiés pour le trafic États-Unis et Canada sans 10DLC.Sender IDs alphanumériquesEnvoyez depuis le nom de votre marque là où le pays de destination l'autorise.Tous les numéros SMSComparez chaque type d'expéditeur — portée, débit et enregistrement.Aperçu de l'API SMSL'API SMS complète : envoi, numéros, bidirectionnel, conformité, routage et analyse.

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.

Explorez les numéros SMS Commencer