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.`,
  category: "authentication",
}).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 disponibles sur les numéros Bird SMS, qui font partie de l<hub>API Bird SMS</hub>. Cest l'option à privilégier quand un seul numéro doit envoyer un volume élevé à de nombreux destinataires, et que vous êtes prêt à sacrifier la rapidité de mise en service pour le débit et la confiance des opérateurs qui en découlent.

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.

Le provisionnement d'un short code utilise le même client et la même structure d'appel que tout autre type d'expéditeur : seul le champ type change. Recherchez par pays et fonctionnalité, achetez le numéro et dirigez ses messages entrants 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 approuvé par les opérateurs pour l'envoi de SMS en masse (one-to-many) : campagnes marketing, alertes et OTP à haut débit. C'est le type d'expéditeur offrant le débit le plus élevé, et il passe par une vérification de l'opérateur avant de pouvoir émettre.
Combien de temps faut-il pour provisionner un short code ?
Prévoyez en semaines, pas en minutes. Les opérateurs vérifient chaque programme de short code avant sa mise en service, ce qui implique un vrai délai de mise en place — contrairement à un numéro long, que vous pouvez acheter et utiliser dès que l'enregistrement est validé.
Short code dédié ou partagé ?
Un short code dédié vous appartient exclusivement : sa réputation d'envoi est entièrement la vôtre. Un short code partagé répartit un numéro entre plusieurs expéditeurs via des mots-clés : moins cher, plus rapide à mettre en place, mais vous héritez de la réputation de tous les autres utilisateurs du numéro.
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