Toll-free

Eén 8xx-nummer, VS en Canada.

Een toll-free nummer is een 8xx-nummer dat SMS verstuurt en ontvangt in de VS en Canada. Het draagt applicatieverkeer zonder A2P 10DLC, zodra het toll-free verificatie heeft doorstaan — wat hogere, beter voorspelbare throughput oplevert dan een ongeregistreerde long code.

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

Wanneer een toll-free nummer past.

Toll-free is een van de vier afzendertypes op Bird SMS-nummers, onderdeel van de bredere Bird SMS API. Grijp ernaar wanneer één nummer zowel de VS als Canada moet dekken en je liever A2P 10DLC-registratie overslaat — verificatie verzorgt in plaats daarvan de carrierbeoordeling.

Wat een toll-free nummer je geeft.

Grensoverschrijdend bereik, two-way verkeer, geen 10DLC.

  1. 01

    VS en Canada vanaf één nummer.

    Eén enkel 8xx-nummer bereikt ontvangers aan beide kanten van de grens, zodat je niet per land een aparte afzender hoeft te provisioneren en beheren.

  2. 02

    Standaard two-way.

    Richt het inkomende verkeer van het nummer op een webhook en antwoorden komen binnen als ondertekende events — hetzelfde conversationele fundament als elk Bird-nummer.

  3. 03

    Geen A2P 10DLC nodig.

    Toll-free verkeer staat volledig buiten het 10DLC-systeem, dus er is geen brand-en-campagneregistratie in te dienen voordat je verstuurt.

  4. 04

    Doorstaan via toll-free verificatie.

    Carriers beoordelen eerst de use case en berichtinhoud; zodra de verificatie rond is, verstuurt het nummer op volle snelheid in plaats van afgeknepen of gefilterd.

Koop er een en begin met verzenden.

Zoek op land en capability, koop het nummer, en route de inbound ervan naar een webhook — dezelfde client waarmee je verstuurt. Dezelfde codevorm provisioneert elk afzendertype; alleen het type-veld verandert.

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

Verificatie hoort erbij.

Voordat een toll-free nummer applicatieverkeer kan versturen, gaat het door toll-free verificatie — de carriers beoordelen je use case, voorbeeldberichten en opt-in voordat ze het nummer goedkeuren. Bird dient de verificatie in vanuit het dashboard en rapporteert de status via de API, zodat je precies weet wanneer het nummer rond is. Als je Amerikaanse verkeer al over A2P 10DLC loopt, is een long code de alternatieve afzender.

Toll-free FAQ

Wat is een toll-free SMS-nummer?+
Een toll-free nummer is een 8xx-nummer (800, 888, 877 en de overige toll-free prefixen) dat SMS verstuurt en ontvangt in de VS en Canada. Het draagt applicatieverkeer zonder A2P 10DLC, zodra het toll-free verificatie heeft doorstaan.
Vereisen toll-free nummers 10DLC-registratie?+
Nee. Toll-free nummers staan buiten het A2P 10DLC-systeem. In plaats daarvan gaan ze door toll-free verificatie, waarbij de carriers de use case en berichtinhoud beoordelen voordat het nummer op volle snelheid mag verzenden.
Kan een toll-free nummer antwoorden ontvangen?+
Ja. Toll-free nummers zijn two-way: route de inbound van het nummer naar een webhook en antwoorden komen binnen als HMAC-ondertekende events, net als bij elk ander Bird SMS-nummer.
Wanneer moet ik in plaats daarvan een long code gebruiken?+
Grijp naar een long code wanneer je een lokaal netnummer wilt of je Amerikaanse verkeer al via A2P 10DLC loopt. Een toll-free nummer wint wanneer je één 8xx-afzender wilt die zowel de VS als Canada dekt zonder 10DLC-campagnes te registreren.

Eén geverifieerd nummer voor het hele continent.

Toll-free is één afzendertype op de Bird SMS-nummers-surface. Provisioneer een 8xx-nummer, doorloop verificatie, en route inbound vanuit dezelfde API waarmee je verstuurt.

Begin met één kanaal.
Voeg de rest toe wanneer je er klaar voor bent.

Een test-API-key is direct beschikbaar. Productietoegang wordt ontgrendeld zodra je een betaalmethode toevoegt en een afzender verifieert.

Gebruik je Claude Code, Cursor of Codex? Kopieer een setup-prompt en je agent installeert de Bird CLI en skills voor je. Kies de jouwe:

Cursor