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.`,
  category: "authentication",
}).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.`,
  category: "authentication",
}).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 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é, achetez le numéro et routez son trafic entrant vers un webhook, avec le même client que celui utilisé pour l'envoi. La même structure de code provisionne n'importe quel type d'expéditeur ; seul le champ 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 bénéficient d'un débit vérifié qui dépend du score de confiance de la marque et du type de campagne : supérieur à celui d'un numéro non enregistré, inférieur à celui d'un code court.

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