Short codes

Creados para enviar a gran escala.

Un short code es un número de 5–6 dígitos creado para SMS de uno-a-muchos de alto volumen: marketing, alertas y OTP de alto ritmo. Los operadores verifican cada programa antes de que pueda enviar, así que el plazo de aprovisionamiento se mide en semanas en lugar de minutos.

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

Dónde encaja un short code.

Un short code 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. Es la opción a la que recurres cuando un número tiene que enviar gran volumen a muchos destinatarios — y estás dispuesto a sacrificar velocidad de aprovisionamiento por la capacidad de envío y la confianza del operador que conlleva.

Lo que te aporta un short code.

Alta capacidad de envío, verificado por el operador, hecho para uno-a-muchos.

  1. 01

    La mayor capacidad de envío de cualquier tipo de remitente.

    Un short code está diseñado para que un número lleve una carga saliente intensa, que es lo que hace que una campaña del mismo día o una difusión de alertas llegue a tiempo.

  2. 02

    Dedicado o compartido.

    Toma un short code dedicado y su reputación de envío es solo tuya; comparte uno detrás de palabras clave para empezar más rápido y más barato, a costa de heredar la reputación de tus vecinos.

  3. 03

    Verificado por el operador antes de enviar.

    Los operadores revisan cada programa de short code, así que el número llega con su confianza ya establecida en lugar de tener que ganársela con tráfico en vivo.

  4. 04

    Ideal para uno-a-muchos.

    Los envíos de marketing, las alertas transaccionales y los OTP de alto ritmo encajan todos en un short code. Para tráfico conversacional bidireccional, un long code suele ser el mejor punto de partida.

Búscalo, cómpralo y enrútalo.

Aprovisionar un short code usa el mismo cliente y la misma forma de llamada que cualquier otro tipo de remitente — solo cambia el campo de tipo. Busca por país y capacidad, compra el número y apunta su tráfico entrante a un webhook.

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

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

La verificación te compra capacidad de envío.

El compromiso es directo: un short code se gana su alta capacidad de envío de confianza del operador pasando primero por la verificación, así que planifica un plazo en semanas. Recurre a uno cuando el volumen de un programa supere lo que admite un long code, o cuando necesites un ritmo de envío alto y predecible desde el primer día. Si tu tráfico es bidireccional y conversacional, o el volumen es moderado, un long code está activo antes y cuesta menos empezar.

Preguntas frecuentes sobre short codes

¿Qué es un short code de SMS?+
Un short code es un número de 5–6 dígitos que los operadores aprueban para SMS de uno-a-muchos de alto volumen — campañas de marketing, alertas y OTP de alto ritmo. Es el tipo de remitente con mayor capacidad de envío, y pasa por la verificación del operador antes de poder enviar.
¿Cuánto tarda en aprovisionarse un short code?+
Planifica en semanas, no en minutos. Los operadores verifican cada programa de short code antes de que se active, así que un short code conlleva un plazo real — a diferencia de un long code, que puedes comprar y con el que puedes empezar a enviar en cuanto se aprueba el registro.
¿Short code dedicado o compartido?+
Un short code dedicado es solo tuyo, así que su reputación de envío es enteramente propia. Un short code compartido reparte un número entre varios remitentes detrás de palabras clave — más barato, más rápido de empezar, pero heredas la reputación de todos los demás que lo usan.
¿Cuándo debería usar un long code en su lugar?+
Cuando el tráfico es bidireccional y conversacional, o el volumen no justifica la verificación y el plazo. Un long code es local, bidireccional por defecto y está activo en cuanto se aprueba su campaña 10DLC.

Elige el tipo de remitente que tu volumen requiere.

Un short code es un tipo de remitente en la superficie de números de SMS de Bird. Aprovisiona uno cuando el volumen y la capacidad de envío justifiquen 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