Una API SMS es una interfaz de programación que permite a su software enviar y recibir mensajes de texto a través de un proveedor: usted hace una petición HTTP (o abre una conexión SMPP) con el número, el remitente y el texto, y el proveedor entrega el mensaje e informa del resultado. Así es como las apps envían códigos OTP, alertas y notificaciones sin infraestructura de telecomunicaciones propia.
¿Qué es una API SMS?
Una API SMS pone el gateway SMS de un proveedor al alcance de los desarrolladores. La mayoría son API REST sobre HTTPS: usted se autentica con una API key o un token, hace un POST con el mensaje y recibe un ID de mensaje. El proveedor se encarga del enrutamiento hacia los operadores, la codificación, la división de mensajes largos y los informes de entrega. Muchos proveedores ofrecen también SMPP para remitentes de gran volumen. El sistema que hay detrás de la API se explica en qué es un gateway SMS.
¿Cómo funciona una API SMS?
- Autenticación. Cada petición lleva una API key, un bearer token o credenciales básicas.
- Envío de la petición. Normalmente un POST con el número de destino en formato E.164, un sender ID o número, el texto del mensaje y, opcionalmente, una URL de callback.
- Obtención de un ID. La API devuelve un ID de mensaje (o un error como número inválido o saldo insuficiente).
- El proveedor encamina el mensaje al operador de destino, directamente o a través de un agregador.
- Recepción del estado. Los informes de entrega llegan a su webhook a medida que cambia el estado: en cola, enviado, entregado, fallido, con un código de error.
- Recepción de respuestas. Los SMS entrantes a su número o short code se envían a otro webhook.
Una petición de envío típica, en términos sencillos: to = +447700900123, from = SuMarca, text = «Su código es 482917», callback = su URL de estado. Los nombres de los campos cambian según el proveedor. Guarde los números en el formato internacional descrito en formato de número E.164.
Integración de una API SMS paso a paso
- Elija el protocolo. HTTP para la mayoría de las apps; SMPP si envía mucho volumen o revende. Vea SMPP vs HTTP para SMS.
- Registre los remitentes. Antes de salir a producción, registre sender ID, números o plantillas en los países que lo exigen. Vea registro del sender ID para SMS.
- Mantenga las claves en secreto. Llame a la API desde su servidor, nunca desde una app móvil o el navegador, para que no se pueda extraer la clave.
- Gestione los webhooks. Verifique las firmas si el proveedor las ofrece, responda rápido y procese de forma asíncrona.
- Gestione errores y reintentos. Reintente ante errores de red y temporales con espera progresiva; no reintente errores permanentes como número inválido.
- Controle la codificación y la longitud. Mantenga los mensajes en GSM-7 cuando sea posible. Vea GSM-7 frente a Unicode.
- Proteja los disparadores. Limite la frecuencia de cualquier formulario público que envíe SMS, para frenar el SMS pumping.
- Pruebe en teléfonos reales en cada país de destino antes del lanzamiento. Vea cómo probar una ruta SMS.
¿Qué es una API key de SMS?
Una API key de SMS es la credencial secreta que identifica su cuenta en cada petición a la API. Cualquiera que la tenga puede enviar mensajes que se le facturan a usted, así que trátela como una contraseña: guárdela en variables de entorno o en un gestor de secretos, restrínjala por IP donde el proveedor lo permita, rótela periódicamente y revóquela de inmediato si se filtra.
Qué buscar en una API SMS para desarrolladores
| Área | Qué comprobar |
|---|---|
| Calidad de las rutas | Qué rutas hay detrás de la API en sus países, y si los informes de entrega vienen de los operadores |
| Informes de entrega | Webhooks con estados y códigos de error claros. Vea códigos de estado DLR de SMS |
| Documentación y SDK | Ejemplos claros, sandbox o modo de prueba, librerías para su lenguaje |
| Límites | Peticiones por segundo, longitud de los mensajes, endpoints de envío masivo |
| Soporte de cumplimiento | Ayuda con el registro de sender ID, 10DLC, DLT y plantillas |
| Controles antifraude | Listas de países permitidos, límites de frecuencia, alertas de gasto |
| Modelo de precios | Por parte de mensaje y por país, facturado por enviado o por entregado |
Más criterios en cómo elegir un proveedor de SMS A2P.
¿Cuánto cuesta una API SMS?
El precio de una API SMS es casi siempre por parte de mensaje, fijado por país de destino, porque las tarifas de terminación de los operadores son la mayor parte del coste. Algunos proveedores añaden cuotas mensuales por números o sender ID. La API más barata no siempre es la más barata por mensaje entregado: vea los precios del SMS explicados.
Rutas para su API SMS
Si opera su propia plataforma o API y necesita rutas superiores, VoIPMatcher consigue rutas SMS A2P por HTTP y SMPP a través de sus carriers y las gestiona. Solicite una ruta SMS para su API.
Preguntas frecuentes
¿Qué diferencia hay entre una API SMS y un gateway SMS?
El gateway SMS es el sistema que encamina los mensajes hacia las redes móviles; la API SMS es la interfaz que usan los desarrolladores para acceder a él. Cuando se comparan API SMS, en realidad se comparan el gateway, las rutas y el soporte que hay detrás de cada API, además de la calidad de su documentación y sus herramientas.
¿Puedo enviar SMS desde mi web con una API?
Sí. El backend de su web llama a la API SMS para enviar mensajes como confirmaciones de pedido, recordatorios o códigos de verificación. Haga la llamada desde el servidor, nunca desde el código del navegador, para que la API key siga siendo secreta. Proteja cualquier formulario público que dispare SMS con detección de bots y límites de frecuencia para evitar abusos.
¿Existe una API SMS gratuita?
Algunos proveedores ofrecen crédito de prueba o modos sandbox para hacer pruebas, pero enviar SMS reales siempre cuesta dinero porque los operadores móviles cobran por cada mensaje entregado. Los servicios que prometen envío de SMS gratis para siempre suelen depender de rutas no autorizadas o de publicidad, lo que hace la entrega poco fiable e inadecuada para uso profesional.
¿Una API SMS puede recibir mensajes?
Sí, si tiene un número o un short code que acepte SMS entrantes. El proveedor reenvía cada mensaje entrante a la URL de su webhook con el remitente, el texto y la hora. Esto permite usos bidireccionales como respuestas, bajas por palabra clave como STOP y conversaciones de soporte. Los sender ID alfanuméricos no pueden recibir respuestas.
¿Cuánto se tarda en integrar una API SMS?
Una integración básica que envía un mensaje y gestiona los informes de entrega puede llevar a un desarrollador unas horas con una API REST bien documentada. Dejarla lista para producción lleva más: el registro de sender ID y plantillas en cada país, la gestión de errores, los reintentos, las bajas, la monitorización y los controles antifraude pueden sumar de días a semanas según los países.
¿Necesita una ruta?
Envíe el destino, el tipo de ruta y la tarifa objetivo. Le respondemos con lo que podemos ofrecer.