SMS
Envíe mensajes SMS en todo el mundo a través de la infraestructura de pasarela SMPP de Orbit. Orbit se conecta con operadores de primer nivel y agregadores en más de 190 países, gestionando automáticamente la concatenación, la codificación y el seguimiento de entregas.Enviar un SMS
to como from se validan como E.164
— formato internacional completo con el prefijo del país. Cómo Orbit valida y
normaliza números está en el
ciclo de vida de los números.
Respuesta
El endpoint responde con HTTP 202 Accepted — el mensaje queda persistido y en cola para entrega. Elid es un identificador de mensaje de la plataforma
con la forma msg_ seguido de 32 caracteres hexadecimales; siga su ciclo de
vida mediante webhooks de entrega.
segments y encoding en cada envío — son la base de la facturación.
Fundamentos de entregabilidad
La entregabilidad de SMS gira en torno a tres cosas, en este orden: desde quién envía, adónde, y a qué velocidad. Un remitente sin registrar es filtrado por el operador antes de que le cueste un segmento.Elegir un tipo de remitente
Qué registro exige su país de destino figura en los
requisitos de cumplimiento por país.
Registro 10DLC y tipos de campaña (EE. UU.)
Si envía a destinos de EE. UU. mediante códigos largos numéricos, los operadores exigen registro; el tráfico no registrado se filtra, se sobrecarga o ambas cosas. Orbit presenta el registro a través de The Campaign Registry en su nombre: la guía completa (marca → campaña → aprobación → niveles de rendimiento) está en la guía de registro 10DLC. El punto clave de EE. UU.: el rendimiento tras el registro se otorga como un tope de segmentos por día y por número según su puntaje de verificación de marca — no como una tasa por segundo. Para destinos no estadounidenses que cierran identificadores alfanuméricos (gran parte de Europa, Brasil, Bangladés, partes de APAC), el flujo paralelo es el registro de identificadores de remitente. India es la excepción: sus identificadores (“Headers” o encabezados) se registran vía DLT/TRAI — vea incorporación DLT de India.Codificación y concatenación
La codificación es la única variable de costo que sobrevive a un remitente bien registrado. SMS se factura por segmento, y la cantidad de segmentos depende enteramente del alfabeto en el que quepa el cuerpo.GSM-7 frente a UCS-2
- GSM-7 — el alfabeto GSM de 7 bits (ASCII más unos extras:
@,£,€, algunos griegos). Un cuerpo que cabe obtiene hasta 160 caracteres por segmento, o 153 caracteres en un envío multiparte (7 caracteres por segmento van para la cabecera de concatenación UDH). - UCS-2 — cualquier carácter fuera de GSM-7 (emoji, CJK, comillas tipográficas, la mayoría de alfabetos no latinos) cambia todo el mensaje a codificación de 16 bits. Un cuerpo obtiene hasta 70 caracteres por segmento, o 67 en multiparte.
Ejemplo resuelto
Su pedido fue enviado — responda SÍ — 30 caracteres, todo GSM-7 → 1
segmento, GSM-7. Un único emoji cambia el alfabeto; un boletín ASCII de
160 caracteres se convierte de inmediato en 2 segmentos UCS-2. Techo
duro: 10 segmentos (1.530 caracteres GSM-7 o 670 caracteres UCS-2);
más allá, el cuerpo se trunca y el envío marca wasTruncated: true.
Ciclo de vida del estado
Cada SMS saliente lleva unstatus que avanza:
queued → sending → sent → delivered (o failed / undelivered /
rejected / expired)
Suscríbase a las transiciones mediante webhooks con los
eventos message.sent, message.delivered y message.failed. Los matices
que sorprenden a los operadores:
submitted_no_receipt— el proveedor aceptó el envío; no llegó ninguna DLR dentro de la ventana de gracia de 30 minutos. Trátelo como resultado desconocido, ni entrega ni fallo.expired— llegó una DLR después de cerrada la ventana; el caso queda cerrado.rejected— puerta de remitente: registro faltante o política de contenido. Determinista hasta que la puerta se desbloquee.
Precios
El precio de SMS es por segmento y varía por país de destino. Consulte la página de precios o el endpointGET /api/v1/pricing/messaging?country=<ISO> para tarifas en tiempo real. Dos
envíos idénticos se facturan distinto en el momento en que la codificación de
uno pasa a UCS-2 — vea
codificación y concatenación.
Límites de velocidad
Los envíos de SMS están limitados por defecto a 100 solicitudes por minuto por inquilino; el límite se clave por inquilino (organización), no por IP ni plan. Excederlo devuelve429 RATE_LIMITED; vea la
guía de límites de velocidad. Los límites por defecto
de cada canal (SMS 100, WhatsApp 80, correo electrónico 200, fax 20, entre
otros) se pueden elevar por canal mediante channel_rate_overrides en la
configuración de mensajería de su organización.
Funciones
- Mensajería A2P y P2P — de aplicación a persona y de persona a persona
- Alcance global — más de 190 países a través de la red de agregadores de Devotel
- Informes de entrega — webhooks de estado en tiempo real por mensaje
- Mensajes concatenados — SMS multiparte manejados de forma transparente (hasta 10 segmentos)
- Validación E.164 — validación automática del formato del número de teléfono
- Soporte Unicode — codificación GSM-7 y UCS-2 completa con detección automática y normalización de puntuación tipográfica