Números largos, números cortos, números gratuitos e identificadores alfanuméricos de remitente: aprovisionados, registrados y enrutados a través de un único endpoint. El remitente desde el que envías determina el rendimiento, el coste y el régimen de cumplimiento aplicable.
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: "+31612345678",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_01m11jw130e7svjzv70kgqr38w"
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 detalle: alcance, rendimiento y lo que se necesita para registrarlo.
Busca, compra y enruta en unas pocas llamadas.
Find a number by country and capability and buy it, from the same SDK you send with. Inbound traffic is routed by a workspace webhook subscribed to sms.received rather than per number, so one subscription covers every number you hold. The number is live as soon as any required registration clears.
const { data: page, error: searchError } = await bird.numbers.available
.list({
country_code: "US",
number_type: "local",
capabilities: ["sms"],
})
.safe();
if (searchError) throw searchError;
const { data: order, error: orderError } = await bird.numbers.orders
.create({ number: page.data[0].number })
.safe();
if (orderError) throw orderError;
console.log(order.status, order.number_id); // → "completed" "nda_0ydh2yfw..."
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.
El resto de la plataforma de SMS
Una API, un solo conjunto de claves. Explora las demás capacidades.
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.