Short codes

Conçus pour envoyer à grande échelle.

Un short code est un numéro à 5–6 chiffres conçu pour le SMS one-to-many à fort volume : marketing, alertes et OTP à débit élevé. Les opérateurs vérifient chaque programme avant qu'il ne puisse envoyer, le délai de provisionnement se mesure donc en semaines plutôt qu'en minutes.

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

Today at 2:14 PM

Hey Ada — your Bird sign-in code is 482917. It'll expire in 10 minutes. Don't share it with anyone.
482917
Delivered

Où s'inscrit un short code.

Un short code est l'un des quatre types d'expéditeurs des numéros SMS de Bird, qui fait partie de l'API SMS de Bird au sens large. C'est l'option vers laquelle vous vous tournez lorsqu'un seul numéro doit pousser un fort volume vers de nombreux destinataires — et que vous êtes prêt à échanger la rapidité de provisionnement contre le débit et la confiance des opérateurs qui l'accompagnent.

Ce qu'un short code vous apporte.

Fort débit, vérifié par les opérateurs, fait pour le one-to-many.

  1. 01

    Le débit le plus élevé de tous les types d'expéditeurs.

    Un short code est conçu pour qu'un seul numéro porte une lourde charge sortante, ce qui permet à une campagne le jour même ou à une diffusion d'alertes d'arriver à temps.

  2. 02

    Dédié ou partagé.

    Prenez un short code dédié et sa réputation d'envoi vous appartient à vous seul ; partagez-en un derrière des mots-clés pour démarrer plus vite et moins cher, au prix d'hériter de la réputation de vos voisins.

  3. 03

    Vérifié par les opérateurs avant d'envoyer.

    Chaque programme de short code est examiné par les opérateurs, le numéro arrive donc avec leur confiance déjà établie plutôt que de devoir la gagner sous trafic réel.

  4. 04

    Idéal pour le one-to-many.

    Les envois marketing, les alertes transactionnelles et l'OTP à débit élevé conviennent tous à un short code. Pour le trafic conversationnel bidirectionnel, un long code est généralement le meilleur point de départ.

Recherchez-le, achetez-le et routez-le.

Provisionner un short code utilise le même client et la même forme d'appel que n'importe quel autre type d'expéditeur — seul le champ de type change. Recherchez par pays et par capacité, achetez le numéro et pointez son entrant vers un webhook.

short-code.ts
201 · purchased
const { data: available } = await bird.numbers.search({
  country: "US",
  type:    "short-code",
  capabilities: ["sms"],
}).safe();

const { data: number } = await bird.numbers.buy({
  number:  available[0].number,
  webhook: "https://example.com/webhooks/bird",
}).safe();

La vérification vous achète du débit.

Le compromis est direct : un short code obtient son débit élevé et reconnu par les opérateurs en passant d'abord par une vérification, prévoyez donc un délai de quelques semaines. Optez pour lui lorsque le volume d'un programme dépasse ce que prend en charge un long code, ou lorsque vous avez besoin d'un débit d'envoi élevé et prévisible dès le premier jour. Si votre trafic est bidirectionnel et conversationnel, ou si le volume est modéré, un long code est actif plus tôt et coûte moins cher à démarrer.

FAQ sur les short codes

Qu'est-ce qu'un short code SMS ?+
Un short code est un numéro à 5–6 chiffres que les opérateurs approuvent pour le SMS one-to-many à fort volume — campagnes marketing, alertes et OTP à débit élevé. C'est le type d'expéditeur au débit le plus élevé, et il passe par une vérification des opérateurs avant de pouvoir envoyer.
Combien de temps faut-il pour provisionner un short code ?+
Comptez en semaines, pas en minutes. Les opérateurs vérifient chaque programme de short code avant sa mise en service, un short code comporte donc un véritable délai — contrairement à un long code, que vous pouvez acheter et depuis lequel commencer à envoyer dès que l'enregistrement aboutit.
Short code dédié ou partagé ?+
Un short code dédié est à vous seul, sa réputation d'envoi vous appartient donc entièrement. Un short code partagé répartit un numéro entre plusieurs expéditeurs derrière des mots-clés — moins cher, plus rapide à démarrer, mais vous héritez de la réputation de tous les autres qui l'utilisent.
Quand devrais-je utiliser plutôt un long code ?+
Lorsque le trafic est bidirectionnel et conversationnel, ou que le volume ne justifie pas la vérification et le délai. Un long code est local, bidirectionnel par défaut, et actif dès que sa campagne 10DLC aboutit.

Choisissez le type d'expéditeur que votre volume requiert.

Un short code est l'un des types d'expéditeurs de la surface des numéros SMS de Bird. Provisionnez-en un lorsque le volume et le débit justifient la vérification, et routez l'entrant depuis la même API que celle avec laquelle vous envoyez.

Commencez avec un seul canal.
Ajoutez les autres quand vous êtes prêt.

Une clé API de test est disponible immédiatement. L'accès production se débloque dès que vous ajoutez un moyen de paiement et vérifiez un expéditeur.

Vous utilisez Claude Code, Cursor ou Codex ? Copiez un prompt de configuration et votre agent installe la CLI Bird et les compétences pour vous. Choisissez le vôtre :

Cursor