Long codes

Números locales, bidireccionales por defecto.

Un long code es un número de teléfono estándar de 10 dígitos que envía y recibe SMS. Es el remitente por defecto para conversaciones bidireccionales, OTP y alertas a volumen moderado. Para el tráfico de aplicación en EE. UU. se registra mediante A2P 10DLC.

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

Cuándo un long code es la opción correcta.

Los long codes son uno de los cuatro tipos de remitente en la superficie de números de SMS de Bird, parte de la API de SMS de Bird más amplia. Son locales, bidireccionales y rápidos de aprovisionar — el punto de partida adecuado para la mayoría del tráfico conversacional y transaccional antes de que el volumen justifique un short code.

Lo que te aporta un long code.

Presencia local, tráfico bidireccional, volumen moderado.

01
Un número local de 10 dígitos.
Los destinatarios ven un prefijo de su propio país o región, lo que se lee como un remitente real en lugar de un envío masivo de marketing.
02
Bidireccional por defecto.
Apunta el tráfico entrante del número a un webhook y las respuestas llegan como eventos firmados — la base de los flujos conversacionales.
03
Registrado mediante A2P 10DLC.
El tráfico de aplicación en EE. UU. circula por campañas 10DLC registradas, lo que obtiene capacidad de envío verificada y la confianza de los operadores en lugar de un riesgo de filtrado.
04
Activo en cuanto se aprueba el registro.
Compra el número de inmediato; empieza a llevar tráfico registrado una vez aprobada su campaña 10DLC.

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.

long-code.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();

El registro es parte del trato.

Para enviar tráfico application-to-person a números de EE. UU., un long code circula por una campaña A2P 10DLC registrada. Bird presenta la marca y la campaña desde el dashboard y reporta el estado de aprobación a través de la API, para que sepas exactamente cuándo está disponible toda la capacidad de envío.

Preguntas frecuentes sobre long codes

¿Qué es un long code 10DLC?+

Un long code de 10 dígitos (10DLC) es un número de teléfono local estándar autorizado para SMS application-to-person en EE. UU. una vez que su marca y campaña están registradas ante los operadores.

¿Cuánta capacidad de envío obtiene un long code?+

Los long codes 10DLC registrados obtienen una capacidad de envío verificada que depende de la puntuación de confianza de la marca y del tipo de campaña — más que un número no registrado, menos que un short code.

¿Un long code puede recibir respuestas?+

Sí. Los long codes son bidireccionales: enruta lo entrante del número a un webhook y las respuestas llegan como eventos firmados con HMAC.

¿Cuándo debería pasar a un short code en su lugar?+

Cuando el volumen de uno-a-muchos supera lo que admite la capacidad de envío de un long code, o cuando un programa necesita el ritmo más alto y predecible que ofrece un short code verificado por el operador.

Otras formas de enviar

Los long codes son uno de cuatro tipos de remitente. Compara el resto.

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.Todos los números de SMSCompara cada tipo de remitente — alcance, capacidad de envío y registro.Visión general de la API de SMSLa API de SMS completa: envío, números, bidireccional, cumplimiento, enrutamiento y analítica.

Empieza en un long code, escala cuando lo necesites.

Los long codes son un tipo de remitente en la superficie de números de SMS de Bird. Aprovisiona uno, registra la campaña y enruta lo entrante desde la misma API con la que envías.

Explora los números de SMS Comenzar