> ## Documentation Index > Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt > Use this file to discover all available pages before exploring further. # SMS: envíe y reciba en todo el mundo > Ponga SMS en producción en Orbit: adjunte un remitente, regístrelo donde se exija, prediga la codificación y el costo por segmento, lea el ciclo de vida de entrega y escale con grupos de remitentes. # 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 ```bash theme={null} curl -X POST https://api.orbit.devotel.io/api/v1/messages/sms \ -H "X-API-Key: dv_live_sk_..." \ -H "Content-Type: application/json" \ -d '{ "to": "+14155552671", "from": "+18005551234", "body": "¡Hola desde Orbit!" }' ``` Tanto `to` como `from` se validan como [E.164](https://es.wikipedia.org/wiki/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](/concepts/number-lifecycle). ### Respuesta El endpoint responde con **HTTP 202 Accepted** — el mensaje queda persistido y en cola para entrega. El `id` 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](/webhooks/overview). ```json theme={null} { "data": { "id": "msg_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6", "status": "queued", "channel": "sms", "segments": 1, "encoding": "GSM-7" } } ``` Lea `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 | Tipo de remitente | Ideal para | Restricción | | ------------------------------------------------------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | **Identificador de remitente alfanumérico** (`MyBrand`) | Reconocimiento de marca; mercados donde los identificadores numéricos se suprimen | Registro requerido en muchos países; no admite respuestas (unidireccional) | | **Código largo numérico** (`+14155550123`) | SMS bidireccional, respuestas, soporte conversacional | El rendimiento varía por país (EE. UU.: regístrese en [10DLC](#registro-10dlc-y-tipos-de-campaña-ee-uu) para rendimiento completo) | | **Código corto** (`12345`) | Campañas de alto rendimiento, envíos de OTP memorizables | Largo plazo del operador, mayor costo | | **Grupo de remitentes** | Alto volumen, presencia local, rotación de remitentes degradados | Vea [grupos de remitentes](/guides/sender-pools) | Qué registro exige su país de destino figura en los [requisitos de cumplimiento por país](/compliance/country-requirements). ## 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](/guides/10dlc-registration). 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](/compliance/sender-id-registration). India es la excepción: sus identificadores ("Headers" o encabezados) se registran vía DLT/TRAI — vea [incorporación DLT de India](/compliance/dlt-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. Un solo carácter no GSM-7 reclasifica todo el mensaje. Orbit normaliza los infractores accidentales — comillas tipográficas pegadas, guiones largos, apóstrofes rizados, caracteres invisibles de ancho cero — a equivalentes seguros de GSM-7 antes de contar, de modo que un error de copiado no duplique su factura de segmentos. El modelo completo de codificación y segmentación está en el [concepto de segmentos y codificación de SMS](/concepts/sms-segments-and-encoding). ### 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 un `status` que avanza: `queued` → `sending` → `sent` → `delivered` (o `failed` / `undelivered` / `rejected` / `expired`) Suscríbase a las transiciones mediante [webhooks](/webhooks/overview) 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. La máquina de estados de concepto en [ciclo de vida de entregas](/concepts/delivery-lifecycle); el manejo de fallos en [solución de problemas: mensaje no entregado o fallido](/troubleshooting/message-undelivered-failed). ## Precios El precio de SMS es por segmento y varía por país de destino. Consulte la [página de precios](https://orbit.devotel.io/pricing) o el endpoint `GET /api/v1/pricing/messaging?country=` 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](#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 devuelve `429 RATE_LIMITED`; vea la [guía de límites de velocidad](/guides/rate-limits). 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