Desarrolladores

API SMS

Tu aplicación envía; nosotros entregamos.

Envía SMS individuales y masivos desde tu software con una API REST documentada: programa envíos, personaliza cada mensaje y recibe los estados de entrega y las respuestas de tus clientes. Con el mismo saldo y las mismas tarifas que el panel.

Estados de entrega de la operadora Sin cuotas Soporte en español
Entregado
Informe de la operadora
En tu URL, en tiempo real

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

  1. Consigue tus credenciales. Date de alta y copia tu Usuario API y tu API Token desde la configuración de tu cuenta.
  2. 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).
  3. Envía el SMS. Llama a EnviarSMS con el remitente, la lista de destinatarios en JSON y el texto del mensaje.
  4. Guarda el idMensaje. La respuesta indica cuántos mensajes se han enviado y el identificador para seguir el envío.
  5. 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.
Envío de SMS a dos destinatarios  ·  API v7
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, CancelarSMS y ReprogramarSMS.
  • 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 GetPlantillasSMS y tus créditos con GetCreditos.
  • 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.

Preguntas frecuentes

Preguntas frecuentes sobre la API SMS

Una conexión que permite a tu aplicación enviar y recibir SMS con peticiones HTTPS, sin usar el panel. La plataforma entrega cada mensaje a la operadora del destinatario y te devuelve su estado.

Con una petición POST a https://api.mensatek.com/v7/EnviarSMS, autenticada con tu Usuario API y tu API Token, que incluya el remitente, los destinatarios en JSON y el mensaje. La respuesta devuelve el idMensaje para seguir el envío.

El servicio que recibe los mensajes de tu aplicación y los entrega en la red de telefonía móvil. La API de Mensatek hace de pasarela: tú haces la petición y ella se encarga de la entrega y de los informes.

No tiene cuota ni coste de integración: pagas los SMS que envías, 1 crédito por SMS a España, entre 0,029 y 0,043 € según el bono.

Sí. Con un número virtual, los SMS que te envían tus clientes llegan a tu aplicación además de a la bandeja de entrada del panel.

Con cualquiera que pueda hacer una petición HTTPS POST. La documentación trae ejemplos en cURL, PHP, Python, Java, C# y Ruby.

Sí. Con los créditos de prueba del alta puedes hacer tus primeras peticiones reales y enviarte un SMS al teléfono que verificaste. Para enviar a otros números compras un bono desde 10 €, sin permanencia.

Tu primer SMS por API, hoy

Alta con créditos de prueba y documentación completa. De las credenciales al primer envío en minutos.