Qué es una API SMS
Una API de SMS (o SMS API) es la conexión que permite a tu software enviar y recibir mensajes de texto sin pasar por un panel: tu aplicación hace una petición HTTPS y la plataforma se encarga del resto. La API SMS de Mensatek funciona como una pasarela SMS (SMS gateway): recibe la petición, entrega el mensaje a la operadora del destinatario y te devuelve el estado de cada envío. Es la forma de automatizar el envío de SMS de tu empresa (códigos de verificación, recordatorios de cita, avisos de pedido, alertas o campañas de marketing con SMS masivos) desde tu ERP, tu CRM, tu tienda online o tu aplicación móvil, con los datos y la lista de contactos que ya tienes.
Cómo enviar SMS por API, paso a paso
- Consigue tus credenciales. Date de alta y copia tu Usuario API y tu API Token desde la configuración de tu cuenta.
- Autentícate. Cada petición va por POST y HTTPS con autenticación básica: la cabecera Authorization lleva «UsuarioAPI:APIToken» codificado en Base64 (con cURL basta la opción
--user). - Envía el SMS. Llama a
EnviarSMScon el remitente, la lista de destinatarios en JSON y el texto del mensaje. - Guarda el idMensaje. La respuesta indica cuántos mensajes se han enviado y el identificador para seguir el envío.
- Recibe los estados. Activa el reenvío de reports a tu URL para saber al momento si cada SMS se ha entregado, o consúltalo con
GetReportSMS.
curl -X POST https://api.mensatek.com/v7/EnviarSMS \ --user 'UsuarioAPI:APIToken' \ --form 'Remitente=MIEMPRESA' \ --form 'Destinatarios=[{"Movil":"34600000000","Variable_1":"Pedro"},{"Movil":"34600000001","Variable_1":"Ana"}]' \ --form 'Mensaje=Te recordamos tu cita del martes a las 10:00' \ --form 'Resp=JSON' # → Res (mensajes enviados), idMensaje y créditos usados
El parámetro Destinatarios admite uno o miles de móviles en la misma petición, cada uno con hasta diez variables (Variable_1 a Variable_10) para personalizar el texto. Con Fecha programas el envío para más tarde, y con Resp eliges si la respuesta llega en JSON, XML o texto.
Qué puedes hacer con la API de SMS
- Envío de SMS individuales y masivos en una sola petición, con remitente alfanumérico (tu marca, registrada en la CNMC) o numérico.
- Programar, cancelar y reprogramar envíos con
EnviarSMS,CancelarSMSyReprogramarSMS. - Estados de entrega de la operadora en tu URL o por consulta con
GetReportSMS. - Enlaces cortos, landing pages, códigos QR y archivos (PDF, documentos, vídeos, vCard) dentro del SMS, con estadísticas de clics; los archivos se suben con
CargarFichero. - GSM o Unicode: 160 caracteres por parte en el alfabeto estándar, o 70 con Unicode si necesitas otros alfabetos o emojis.
- Fail2Voice: si el número no puede recibir el SMS, por ejemplo un fijo, el mensaje se entrega como llamada de voz.
- Lista de bajas: los números que se han dado de baja en tu cuenta se excluyen solos de los envíos.
- Plantillas y saldo: consulta tus plantillas con
GetPlantillasSMSy tus créditos conGetCreditos. - SMS certificado, OTP, RCS y WhatsApp con sus propias APIs y la misma autenticación.
Casos de uso de la API SMS
- Verificación y seguridad: códigos de un solo uso para registros, accesos y pagos; para esto tienes también la API de OTP, que genera y valida el código por ti.
- Notificaciones de pedidos y envíos: confirmación de compra, pedido enviado, reparto de hoy.
- Recordatorios de cita: clínicas, talleres, peluquerías y cualquier empresa que trabaje con agenda, para reducir las ausencias.
- Alertas: avisos de sistemas, incidencias, cambios de horario o comunicaciones urgentes a clientes y empleados.
- Campañas de marketing: enviar SMS promocionales desde tu CRM a los clientes que han dado su consentimiento, con enlace de baja.
Enviar y recibir SMS desde tu aplicación
La API no solo envía. Con un número virtual para recibir SMS, los mensajes que te escriben tus clientes llegan a tu aplicación en cuanto se reciben, además de a la bandeja de entrada del panel. Así puedes montar confirmaciones de cita por respuesta, encuestas de una pregunta o atención al cliente por SMS de ida y vuelta.
Lenguajes de programación y plugins
Al ser una API REST sobre HTTPS, funciona con cualquier lenguaje de programación que pueda hacer una petición POST. La documentación incluye ejemplos listos para copiar en cURL, PHP, Python, Java, C# y Ruby, con la descripción de cada parámetro y de cada código de respuesta. Si trabajas con WooCommerce, WordPress o PrestaShop, tienes plugins que ya usan la API y no necesitas programar.
Qué mirar al elegir un proveedor de SMS API
- Estados de entrega reales: que cada SMS devuelva el informe de la operadora, no solo un «enviado».
- Documentación completa y en español, con ejemplos que funcionen al copiarlos y un equipo técnico al que llamar.
- Escala y latencia: que un envío de SMS a miles de destinatarios salga en minutos y un código de verificación, en segundos.
- Precio claro por mensaje, sin cuotas mensuales ni costes de integración.
- Cumplimiento: protección de datos (RGPD), remitentes registrados en la CNMC y gestión de bajas.
- Enviar y recibir: que la misma pasarela SMS te permita recibir las respuestas de tus clientes y, si lo necesitas, pasar a RCS, WhatsApp o SMS certificado sin otra integración.
Con la API SMS de Mensatek tienes todo eso a través de una sola conexión, y puedes comprobarlo en la documentación antes de registrarte.
Seguridad, velocidad y precio de la API SMS
- Seguridad: peticiones solo por HTTPS y POST, credenciales propias de la API distintas de tu contraseña y control de acceso por país: si tu servidor está en otro país, autoriza su dirección IP en la configuración de seguridad de tu cuenta.
- Velocidad: cada cuenta envía por defecto entre 50 y 70 SMS por segundo, unos 250.000 a la hora. Si necesitas más, se amplía a petición.
- Precio: la API no tiene cuota ni coste de integración. Cada SMS a España consume 1 crédito, entre 0,029 y 0,043 € según el bono, igual que desde el panel. Tienes los envíos internacionales en la página de precios.
- Pruebas: con los créditos de prueba del alta puedes hacer tus primeras peticiones reales y enviarte un SMS al teléfono que verificaste.
Una API para todos tus canales
La misma autenticación sirve para el resto de servicios de la plataforma: RCS, WhatsApp, email, mensajes de voz, notificaciones push, SMS y email certificados, contratación online, OTP, verificación de identidad y sellado de tiempo. Con el envío omnicanal, un mismo aviso puede salir por SMS y, si no se entrega, por otro canal. Las tienes todas, con su documentación, en la API de integración.