Toll-free

Un seul numéro 8xx, États-Unis et Canada.

Un numéro gratuit (toll-free) est un numéro 8xx qui envoie et reçoit des SMS aux États-Unis et au Canada. Il achemine le trafic applicatif sans A2P 10DLC, une fois la vérification toll-free validée, ce qui offre un débit plus élevé et plus prévisible qu'un code long non enregistré.

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

Quand un numéro toll-free convient.

Le numéro gratuit est l'un des quatre types d'expéditeur disponibles sur Bird SMS numbers, qui fait partie de l'écosystème plus large de Bird SMS API. Choisissez-le lorsqu'un seul numéro doit couvrir les États-Unis et le Canada et que vous préférez éviter l'enregistrement A2P 10DLC : la vérification se charge de l'examen par les opérateurs.

Ce qu'un numéro toll-free vous apporte.

Portée transfrontalière, trafic bidirectionnel, pas de 10DLC.

  1. 01

    Les États-Unis et le Canada depuis un seul numéro.

    Un unique numéro 8xx atteint les destinataires des deux côtés de la frontière, vous n'avez donc pas à provisionner et gérer un expéditeur distinct par pays.

  2. 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 même base conversationnelle que pour tout numéro Bird.

  3. 03

    Pas besoin d'A2P 10DLC.

    Le trafic toll-free se situe entièrement en dehors du système 10DLC, il n'y a donc aucun enregistrement de marque et de campagne à déposer avant d'envoyer.

  4. 04

    Validé via la vérification toll-free.

    Les opérateurs examinent d'abord le cas d'usage et le contenu des messages ; une fois la vérification aboutie, le numéro envoie à plein volume plutôt que d'être limité ou filtré.

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 tout type d'expéditeur ; seul le champ type change.

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

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

La vérification fait partie du contrat.

Avant qu'un numéro gratuit puisse envoyer du trafic applicatif, il doit passer par la vérification toll-free : les opérateurs examinent votre cas d'usage, des exemples de messages et le consentement (opt-in) avant d'approuver le numéro. Bird soumet la vérification depuis le tableau de bord et en signale le statut via l'API, pour que vous sachiez exactement quand le numéro est validé. Si votre trafic aux États-Unis passe déjà par A2P 10DLC, un code long constitue l'alternative.

FAQ sur le toll-free

Qu'est-ce qu'un numéro SMS toll-free ?
Un numéro toll-free est un numéro 8xx (800, 888, 877 et les autres préfixes toll-free) qui envoie et reçoit des SMS à travers les États-Unis et le Canada. Il porte du trafic applicatif sans A2P 10DLC, une fois qu'il a passé la vérification toll-free.
Les numéros toll-free nécessitent-ils un enregistrement 10DLC ?
Non. Les numéros toll-free se situent en dehors du système A2P 10DLC. Ils passent plutôt par une vérification toll-free, où les opérateurs examinent le cas d'usage et le contenu des messages avant que le numéro ne soit autorisé à envoyer à plein volume.
Un numéro toll-free peut-il recevoir des réponses ?
Oui. Les numéros toll-free sont bidirectionnels : routez l'entrant du numéro vers un webhook et les réponses arrivent sous forme d'événements signés HMAC, comme pour tout autre numéro SMS Bird.
Quand devrais-je utiliser plutôt un long code ?
Optez pour un long code lorsque vous voulez un indicatif local ou que votre trafic américain passe déjà par l'A2P 10DLC. Un numéro toll-free l'emporte lorsque vous voulez un seul expéditeur 8xx qui couvre à la fois les États-Unis et le Canada sans enregistrer de campagnes 10DLC.

Un seul numéro vérifié pour tout le continent.

Le toll-free est l'un des types d'expéditeurs de la surface des numéros SMS de Bird. Provisionnez un numéro 8xx, validez 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