Qué es un SMS por API
El recorrido completo de un mensaje desde tu backend hasta el teléfono del usuario.
Cuando una app te envía el código para iniciar sesión, nadie en esa empresa abrió un teléfono para escribirlo. Un servicio backend hizo una petición HTTP, y en menos de tres segundos el mensaje estaba en tu pantalla. Ese es el SMS programático, también llamado A2P (application-to-person): mensajes que origina un sistema, no una persona.
Entender su recorrido es la base de todo lo que viene en esta academia: cada decisión de diseño —reintentos, codificación, remitente, costos— se explica por alguno de los saltos que hace el mensaje.
El recorrido de un mensaje
Un SMS A2P atraviesa, como mínimo, cuatro sistemas. Tu aplicación llama a la API del proveedor por HTTPS. El proveedor valida la petición, la encola y la traduce a SMPP, el protocolo binario que hablan los operadores. El mensaje llega a la SMSC (Short Message Service Center) del operador del destinatario, que lo almacena y lo entrega al teléfono cuando este tiene señal.
- Tu backend: construye el mensaje y decide a quién enviarlo.
- API del proveedor: autentica, aplica reglas, cobra y enruta.
- SMSC del operador: guarda y reenvía (store and forward) hasta 24–72 horas.
- Terminal: recibe el mensaje y, si se pide, genera un acuse de entrega.
Respuesta síncrona, resultado asíncrono
La respuesta HTTP que recibes al enviar no significa que el mensaje llegó. Significa que el proveedor aceptó el mensaje y te asignó un identificador. El resultado real llega después, por un webhook de estado. Confundir ambas cosas es el error más común de quien integra SMS por primera vez.
// Respuesta típica al enviar
{
"id": "msg_01J9X7Q",
"status": "accepted", // accepted ≠ delivered
"to": "+56912345678",
"segments": 1
}Números en formato E.164
Todas las APIs serias esperan números en E.164: signo más, código de país y número nacional sin espacios ni ceros iniciales. Un móvil chileno se escribe +56912345678; uno mexicano, +5215512345678 o +525512345678 según la normalización del proveedor. Normaliza siempre en el borde de tu sistema, nunca al momento de enviar.
Cuándo conviene SMS
El SMS sigue siendo el único canal que llega a cualquier teléfono, sin app instalada ni datos móviles. Es ideal para códigos de verificación, alertas críticas y recordatorios. Es una mala elección para conversaciones largas o contenido enriquecido: ahí entra la mensajería IP, que verás en la segunda serie.
Lo que el recorrido explica
Cada salto del recorrido tiene consecuencias concretas. La latencia típica de un SMS en la región va de uno a cinco segundos, pero el percentil 99 puede superar el minuto cuando la SMSC del operador está congestionada, por ejemplo en un evento masivo o en horario de cierre de mes. Si tu flujo de login espera un código, diseña la pantalla pensando en ese percentil, no en el promedio.