Toll-free

Un número 8xx, EE. UU. y Canadá.

Un número toll-free es un número 8xx que envía y recibe SMS en EE. UU. y Canadá. Lleva tráfico de aplicación sin A2P 10DLC, una vez que ha superado la verificación toll-free — lo que le compra una capacidad de envío más alta y predecible que un long code no registrado.

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

Cuándo encaja un número toll-free.

El toll-free es uno de los cuatro tipos de remitente en los números de SMS de Bird, parte de la API de SMS de Bird más amplia. Recurre a él cuando un único número deba cubrir tanto EE. UU. como Canadá y prefieras saltarte el registro A2P 10DLC — la verificación se encarga en su lugar de la revisión del operador.

Lo que te aporta un número toll-free.

Alcance transfronterizo, tráfico bidireccional, sin 10DLC.

  1. 01

    EE. UU. y Canadá desde un solo número.

    Un único número 8xx llega a destinatarios a ambos lados de la frontera, así que no aprovisionas ni gestionas un remitente aparte por país.

  2. 02

    Bidireccional por defecto.

    Apunta el tráfico entrante del número a un webhook y las respuestas llegan como eventos firmados — la misma base conversacional que cualquier número de Bird.

  3. 03

    Sin necesidad de A2P 10DLC.

    El tráfico toll-free queda completamente fuera del sistema 10DLC, así que no hay registro de marca y campaña que presentar antes de enviar.

  4. 04

    Aprobado mediante la verificación toll-free.

    Los operadores revisan primero el caso de uso y el contenido de los mensajes; una vez aprobada la verificación, el número envía a pleno volumen en lugar de limitado o filtrado.

Compra uno y empieza a enviar.

Busca por país y capacidad, compra el número y enruta su tráfico entrante a un webhook — el mismo cliente con el que envías. La misma forma de código aprovisiona cualquier tipo de remitente; solo cambia el campo de tipo.

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 verificación es parte del trato.

Antes de que un número toll-free pueda enviar tráfico de aplicación, pasa por la verificación toll-free — los operadores revisan tu caso de uso, mensajes de ejemplo y el opt-in antes de aprobar el número. Bird presenta la verificación desde el dashboard y reporta su estado a través de la API, para que sepas exactamente cuándo el número está aprobado. Si tu tráfico de EE. UU. ya circula por A2P 10DLC, un long code es el remitente alternativo.

Preguntas frecuentes sobre toll-free

¿Qué es un número toll-free de SMS?+
Un número toll-free es un número 8xx (800, 888, 877 y el resto de prefijos toll-free) que envía y recibe SMS en EE. UU. y Canadá. Lleva tráfico de aplicación sin A2P 10DLC, una vez que ha superado la verificación toll-free.
¿Los números toll-free necesitan registro 10DLC?+
No. Los números toll-free quedan fuera del sistema A2P 10DLC. En su lugar pasan por la verificación toll-free, donde los operadores revisan el caso de uso y el contenido de los mensajes antes de permitir que el número envíe a pleno volumen.
¿Un número toll-free puede recibir respuestas?+
Sí. Los números toll-free son bidireccionales: enruta lo entrante del número a un webhook y las respuestas llegan como eventos firmados con HMAC, igual que cualquier otro número de SMS de Bird.
¿Cuándo debería usar un long code en su lugar?+
Recurre a un long code cuando quieras un prefijo local o tu tráfico de EE. UU. ya circule por A2P 10DLC. Un número toll-free gana cuando quieres un único remitente 8xx que cubra tanto EE. UU. como Canadá sin registrar campañas 10DLC.

Un único número verificado para todo el continente.

El toll-free es un tipo de remitente en la superficie de números de SMS de Bird. Aprovisiona un número 8xx, supera la verificación y enruta lo entrante desde la misma API con la que envías.

Empieza con un canal.
Añade los demás cuando estés listo.

Una clave API de prueba es tuya de inmediato. El acceso a producción se desbloquea cuando añades un método de pago y verificas un remitente.

¿Usas Claude Code, Cursor o Codex? Copia un prompt de configuración y tu agente instalará el Bird CLI y las habilidades por ti. Elige el tuyo:

Cursor