Números

El remitente adecuado para cada mensaje.

Long codes, short codes, números toll-free e IDs de remitente alfanuméricos — aprovisionados, registrados y enrutados a través de un solo endpoint. El remitente desde el que envías decide la capacidad de envío, el coste y qué régimen de cumplimiento aplica.

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..."

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..."

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..."

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..."

Cuatro tipos de remitente, una API.

Los números son la base de la API de SMS de Bird. Busca disponibilidad, compra un número y enruta lo entrante a un webhook con el mismo cliente con el que ya envías. El tipo que elijas depende del volumen, la geografía y cuánto registro estés dispuesto a asumir.

¿Qué remitente debería usar?

La capacidad de envío, el alcance y el esfuerzo de registro difieren según el tipo de remitente. La mayoría del tráfico de aplicación en EE. UU. empieza en un long code 10DLC; los programas de uno-a-muchos de alto volumen pasan a un short code.

Tipo de remitente	Ideal para	Registro
Long code (10DLC)	Conversaciones bidireccionales, OTP, alertas a volumen moderado	Marca + campaña A2P 10DLC
Short code	Marketing y alertas de uno-a-muchos de alto volumen	Verificado por el operador, plazo de semanas
Toll-free	Tráfico en EE. UU./Canadá sin 10DLC, mayor capacidad de envío que un long code	Verificación toll-free
ID de remitente alfanumérico	Alertas de marca unidireccionales donde el país lo permite	Registro previo en muchos países

Elige un tipo de número

Cada tipo de remitente en profundidad — alcance, capacidad de envío y lo que cuesta registrarlo.

Long codesNúmeros locales de 10 dígitos para tráfico bidireccional, registrados mediante A2P 10DLC.Short codesNúmeros de 5–6 dígitos creados para envíos de uno-a-muchos de alta capacidad.Toll-freeNúmeros toll-free verificados para tráfico de EE. UU. y Canadá sin 10DLC.IDs de remitente alfanuméricosEnvía desde el nombre de tu marca donde el país de destino lo permita.

Busca, compra y enruta en unas pocas llamadas.

Encuentra un número por país y capacidad, cómpralo y apunta su tráfico entrante a un webhook — todo desde el mismo SDK con el que envías. El número está activo en cuanto se aprueba cualquier registro requerido.

provision.ts

201 · purchased

const { data: available } = await bird.numbers.search({
  country: "US",
  type:    "long-code",
  capabilities: ["sms"],
}).safe();

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

console.log(number.id); // → "num_8KQ2..."

Registro, gestionado donde se exige.

La mayoría del tráfico de aplicación en EE. UU. necesita registro de marca y campaña A2P 10DLC; el toll-free necesita verificación; muchos países exigen el registro previo del ID de remitente. Bird gestiona cada uno de estos desde el dashboard, y la superficie de cumplimiento rastrea el estado desde la API.

Preguntas frecuentes sobre números de SMS

¿Con qué tipo de número debería empezar?+

Para el tráfico de aplicación en EE. UU., un long code 10DLC cubre la mayoría de los casos de uso bidireccionales y de OTP. Los programas de uno-a-muchos de alto volumen pasan a un short code; el toll-free es una opción para EE. UU./Canadá sin 10DLC.

¿Cuánto tarda en activarse un número?+

Un long code o un número toll-free está disponible de inmediato y empieza a enviar en cuanto se aprueba su registro o verificación. Los short codes los verifica el operador y normalmente tardan semanas.

¿Un mismo número puede enviar y recibir?+

Sí. Los long codes, short codes y números toll-free son bidireccionales: apunta el tráfico entrante de un número a un webhook y las respuestas llegan como eventos firmados. Los IDs de remitente alfanuméricos son solo unidireccionales.

¿Necesito registrarme antes de poder enviar?+

Depende del tipo de remitente y del país. El tráfico de aplicación en EE. UU. necesita A2P 10DLC, el toll-free necesita verificación, y muchos países exigen el registro previo del ID de remitente — todo gestionado desde el dashboard.

El resto de la plataforma de SMS

Una API, un solo conjunto de claves. Explora las demás capacidades.

EnvíoLa API de envío: segmentos, seguridad Unicode, lotes e idempotencia.BidireccionalSMS entrantes y respuestas conversacionales como webhooks firmados con HMAC.CumplimientoRegistro A2P 10DLC, cancelación con STOP/HELP y reglas de ID de remitente.EnrutamientoMás de 150 países, 240 enlaces direct-to-carrier y conmutación por error.AnalíticaMétricas de entrega e interacción a partir de los acuses de recibo del operador.Visión general de la API de SMSLa API de SMS completa: envío, números, bidireccional, cumplimiento, enrutamiento y analítica.

Aprovisiona el número adecuado, enrútalo en minutos.

Los números son una capacidad de la API de SMS de Bird: el envío, la recepción bidireccional, el cumplimiento, el enrutamiento y la analítica vienen con ella.

Explora la plataforma de SMS Comenzar