Saltar al contenido principal

SMS por API

Envía SMS por API,
desde tu propio número.

Instala la app Android gratuita, inicia sesión y cada SMS que envíes con la API de Unlimited Messaging saldrá de la SIM de tu móvil, con tu propia tarifa. Tus destinatarios ven tu número, las respuestas vuelven a tu bandeja y a tus webhooks, y la misma petición puede salir también por WhatsApp y por email.

¿Con prisa? Resume este artículo con una IA

El contexto

¿Qué significa enviar SMS por API desde tu móvil?

Enviar SMS por API desde tu número significa que tu código llama a un endpoint REST y el texto sale como un SMS normal desde un móvil que es tuyo. Con Unlimited Messaging, ese móvil ejecuta nuestra app Android gratuita y de código abierto.

Las API de SMS clásicas funcionan de otra manera. Alquilas un número remitente o un código corto a un proveedor, el mensaje viaja por la red A2P (application-to-person) y cada segmento de 160 caracteres se cobra, con una tarifa distinta en cada país. En Estados Unidos, además, hay que registrar una marca y una campaña (A2P 10DLC) antes de enviar.

Con la app Android, el móvil mantiene una conexión abierta con la API de Unlimited Messaging. Cuando llamas a POST /message con "channel": "SMS", la API pasa el mensaje al móvil, este lo envía desde su SIM y cada estado vuelve a medida que la red lo confirma: en cola, enviando, enviado, entregado si tu operador devuelve acuses de entrega, no entregable o fallido. El SMS no tiene confirmación de lectura, así que no hay estado "leído".

El SMS va con tu tarifa, así que Unlimited Messaging no añade ningún coste por mensaje, y tus destinatarios ven el número que ya conocen. Los SMS que recibes después de iniciar sesión vuelven a tu bandeja y al webhook message.received. Está pensado para tu propio tráfico a ritmo humano: recordatorios, códigos, seguimientos, un agente de IA que escribe a tus clientes. Las campañas masivas siguen siendo cosa de un proveedor de SMS dedicado.

Ilustración: un teléfono con burbujas de SMS y una etiqueta SMS, con el titular «El SMS se queda en 160 caracteres».

La petición

Un curl para enviar un SMS, una línea más para sumar WhatsApp y email

El canal SMS usa el mismo endpoint POST /message que WhatsApp y el email. Indícalo en channels con un número de teléfono y saldrá de tu móvil. Añade hasta tres canales para llegar a la misma persona por todas partes en una sola petición.

curlShell
curl https://api.unlimitedmessaging.app/message \
  -H "Authorization: Bearer $UM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": {
    "phone": "+33612345678"
  },
  "channels": [
    {
      "channel": "SMS"
    }
  ],
  "text": "Tu cita es mañana a las 10:00."
}'
Un SMS desde tu propia SIM. Con doble SIM, añade "accountId" en la entrada del canal para elegir la línea.
POST /messageJSON
{
  "to": {
    "phone": "+33612345678",
    "email": "[email protected]"
  },
  "subject": "Tu cita de mañana a las 10:00",
  "text": "Hola, te recordamos que tu cita es mañana a las 10:00. Responde a este mensaje si necesitas cambiarla.",
  "channels": [
    {
      "channel": "WHATSAPP"
    },
    {
      "channel": "SMS",
      "text": "Tu cita es mañana a las 10:00."
    },
    {
      "channel": "EMAIL"
    }
  ]
}
Una petición, tres mensajes: cada canal recibe su copia, con un mismo dispatchId. La entrada SMS sustituye el texto por una versión más corta.

Comparativa

API de SMS clásica frente a SMS desde tu móvil

Las dos envían un SMS desde tu código, pero no sirven para lo mismo. Aquí tienes, con honestidad, cuándo conviene cada una.

API de SMS clásica frente a SMS desde tu móvil
API de SMS clásicatipo Twilio, A2PUnlimited Messagingtu móvil Android
RemitenteNúmero o código corto alquilado al proveedorTu propio número, el que tus clientes conocen
Coste por SMSSe cobra por segmento de 160 caracteres, según el paísTu tarifa, sin coste por SMS añadido por nosotros
Puesta en marchaComprar un número, registrar el remitente (A2P 10DLC en EE. UU.)Instalar la app, iniciar sesión, aparece tu SIM
VolumenAlto rendimiento, pensado para campañasRitmo humano, unos 30 SMS por ventana antes de que Android pregunte
InfraestructuraNada que mantener por tu parteUn móvil encendido, cargado y conectado
RespuestasWebhook hacia tu servidorLa misma bandeja y webhook que WhatsApp y el email
Otros canalesSolo SMS, o productos separadosWhatsApp, email y SMS en una sola petición
Estado de entregaAcuses de entrega del operadorEnviado, y entregado cuando tu operador lo notifica

Nuestro enfoque

El SMS como un canal más de la misma API

No hemos montado un proveedor de SMS. Hemos convertido tu móvil en un canal de la API que ya usas para WhatsApp y email, con los mismos estados, webhooks, SDK y servidor MCP.

Tu SIM, tu número, tu tarifa

El SMS sale del móvil que llevas en el bolsillo o del que dejas en la oficina. Tus destinatarios ven tu número de siempre, y el coste es el que ya cobra tu tarifa.

  1. En los dos sentidos

    Los SMS recibidos después de iniciar sesión vuelven a tu bandeja y al webhook message.received, junto a tus conversaciones de WhatsApp y email.

  2. Doble SIM

    Cada SIM se convierte en su propia cuenta SMS. Elige la línea en cada mensaje con accountId, o deja que elija la API.

  3. Código abierto, sin rastreo

    La app tiene licencia MIT, sin Firebase, sin Play Services y sin analítica. Puedes leer exactamente qué hace una app que tiene permisos de SMS.

Coste por SMS añadido por Unlimited Messaging
0Coste por SMS añadido por Unlimited Messaging
Canales por petición: WhatsApp, SMS, email
3Canales por petición: WhatsApp, SMS, email
Caracteres máx. por SMS, en hasta 10 partes
1530Caracteres máx. por SMS, en hasta 10 partes
Versión de Android necesaria
8.0+Versión de Android necesaria

Cómo funciona

Tu primer SMS en tres pasos

  1. 01

    Instala la app

    Descarga el APK en tu móvil Android desde la página Android o desde GitHub Releases. No está en Google Play, que reserva los permisos de SMS a las apps de SMS predeterminadas. Si Play Protect bloquea la instalación o Android rechaza el permiso de SMS, la FAQ de abajo explica cómo desbloquearlo.

  2. 02

    Inicia sesión

    Pulsa Iniciar sesión: el login de la web se abre en una pestaña del navegador (email, enlace mágico, Google o GitHub). La app nunca ve tu contraseña y cada SIM aparece como una cuenta SMS.

  3. 03

    Envía

    Llama a POST /message con "channel": "SMS", o envía desde el panel, los SDK, n8n o un asistente de IA a través del servidor MCP. Los estados y las respuestas llegan por webhook.

FAQ

Preguntas sobre enviar SMS por API desde tu móvil

Ilian, ingeniero de software senior

Escrito por

· Ingeniero de software senior

Ingeniero de software senior, funda y dirige varias empresas tecnológicas. Diseña productos en torno a las API de mensajería, la automatización y la integración de la IA, y comparte aquí lo que aprende construyendo.

Ver el perfil de LinkedInActualizado el

Convierte tu móvil en una pasarela SMS.

Descarga la app Android gratuita, inicia sesión y envía hoy mismo tu primer SMS por API desde tu propio número.