Un número gratuito (toll-free) es un número 8xx que envía y recibe SMS en EE. UU. y Canadá. Transporta tráfico de aplicaciones sin A2P 10DLC, una vez que ha superado la verificación toll-free, lo que ofrece un rendimiento más alto y predecible que un código largo no registrado.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const { data, error } = await bird.sms.send({
from: "Bird",
to: "+15005550006",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."
Cuándo encaja un número toll-free.
Toll-free es uno de los cuatro tipos de remitente en números SMS de Bird, parte de la API de SMS de Bird más amplia. Úsalo cuando un solo número deba cubrir tanto EE. UU. como Canadá y prefieras omitir el registro A2P 10DLC: la verificación se encarga de la revisión del operador.
Lo que te aporta un número toll-free.
Alcance transfronterizo, tráfico bidireccional, sin 10DLC.
- 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.
- 02
Bidireccional por defecto.
Dirige 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.
- 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.
- 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 estructura de código aprovisiona cualquier tipo de remitente; solo cambia el campo de tipo.
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 gratuito pueda enviar tráfico de aplicaciones, pasa por la verificación toll-free: los operadores revisan tu caso de uso, mensajes de ejemplo y opt-in antes de aprobar el número. Bird presenta la verificación desde el panel 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 en EE. UU. ya funciona con A2P 10DLC, un código largo es el remitente alternativo.
Otras formas de enviar
El toll-free es uno de cuatro tipos de remitente. Compara el resto.
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.