Definición
Una API de SMS es una interfaz web, normalmente REST sobre HTTPS con JSON, que permite a un software enviar SMS, recibir respuestas y obtener estados de entrega de forma programática, sin gestionar directamente conexiones de telecomunicaciones.
Una llamada típica envía a un endpoint, junto con un token de API, el destinatario en formato E.164, el ID de remitente (sender ID) y el texto, y recibe a cambio un ID de mensaje. Los estados de entrega y las respuestas entrantes llegan después mediante webhooks.
Frente a SMPP, una API HTTP es más fácil de integrar, funciona a través de firewalls estándar y encaja con aplicaciones web y serverless. SMPP es más eficiente para volúmenes muy altos y sostenidos.
Buenas prácticas: mantener los tokens en el servidor, hacer que los envíos sean idempotentes para que los reintentos no dupliquen mensajes, gestionar las respuestas 429 de límite de frecuencia y verificar las solicitudes de webhook.
La API REST de OmniChannels.ai en api.broadnet.me usa autenticación mediante bearer token y cubre el SMS junto con WhatsApp, RCS y otros canales.
Ejemplo
POST /sms {"to":"+971501234567","from":"AcmeBank","text":"Your code is 482913"}