httpSMS es un proyecto open source que convierte tu teléfono Android en un SMS gateway. Instalas la app en el teléfono y usas una API HTTP simple para enviar mensajes y recibir SMS entrantes via webhook. Funciona con cifrado AES-256 extremo a extremo y es self-hostable con Docker.

¿Necesito un número virtual o pagar Twilio?

No. httpSMS usa la SIM card de tu propio teléfono Android. No necesitas números virtuales ni servicios de pago como Twilio. Solo necesitas un Android con SIM activa y el servidor httpSMS corriendo (self-hosted o cloud).

¿Qué licencia tiene httpSMS?

httpSMS está licenciado bajo AGPL-3.0, una licencia copyleft fuerte que requiere que cualquier modificación distribuida también sea open source.

¿Qué SDKs disponibles para httpSMS?

httpSMS ofrece SDKs oficiales para Go y JavaScript/TypeScript. La API REST es compatible con cualquier lenguaje que pueda hacer peticiones HTTP.

¿Cómo se instala httpSMS con Docker?

Clonas el repo, copias los archivos .env.docker a .env en los directorios api/ y web/, configuras Firebase, SMTP y opcionalmente Cloudflare Turnstile, y ejecutas docker compose up --build.

httpSMS: tu Android como gateway SMS por API HTTP

Twilio cobra por mensaje. Los números virtuales tienen latencia y a veces no entregan. Y si estás construyendo un bot que necesita verificación SMS real o enviar notificaciones a usuarios, necesitas una alternativa que no cueste $0.0079 por mensaje.

httpSMS resuelve esto de la forma más directa posible: usa el teléfono Android que ya tienes. Lo instalas, configuras la API, y tienes un SMS gateway completo con la misma SIM que usas para tus mensajes personales.

Cómo funciona

El flujo es simple:

Instalas la app de httpSMS en un Android (cualquier modelo con SIM activa)
La app se conecta al servidor httpSMS (self-hosted o cloud)
Haces una petición HTTP a la API para enviar un SMS
El servidor notifica a la app Android
La app envía el SMS usando el sistema nativo de Android
Los SMS entrantes se reenvían a tu webhook

El servidor API está escrito en Go usando Fiber, con CockroachDB como base de datos. La app Android es nativa en Kotlin con Material Design. El stack completo corre en Docker.

Qué puedes hacer con él

Los casos de uso reales son más amplios de lo que parece:

2FA personal: generar códigos de verificación sin depender de un tercero
Bots que necesitan SMS real: bots de Telegram, Discord o Slack que envían alertas por SMS
Notificaciones automatizadas: alertas de servidor, monitoring, pipelines CI/CD
Integraciones legacy: sistemas que solo aceptan SMS como canal de entrada
Testing de flujos SMS: probar automatizaciones que envían/reciben SMS sin pagar por un servicio mock

Self-hosting con Docker

El setup completo (API + web UI + base de datos + cache) corre en Docker Compose:

git clone https://github.com/NdoleStudio/httpsms.git
cd httpsms

# Configurar variables de entorno
cp api/.env.docker api/.env
cp web/.env.docker web/.env

# Editar con tus credenciales
# Firebase (para notificaciones push al Android)
# SMTP (para emails del sistema)
# Cloudflare Turnstile (opcional, anti-bot)

docker compose up --build

Necesitas configurar tres servicios externos:

Firebase: para enviar notificaciones push al Android cuando hay un SMS entrante o una orden de envío
SMTP: para emails del sistema (alertas, reseteos de contraseña)
Cloudflare Turnstile: opcional, para protección anti-bot en el login

Una vez levantado, la API está disponible en http://localhost:8000 y la web UI en http://localhost:5173.

SDKs disponibles

La API REST funciona con cualquier lenguaje, pero hay SDKs oficiales:

Go: github.com/NdoleStudio/httpsms-go
JavaScript/TypeScript: github.com/NdoleStudio/httpsms-node

Ejemplo de envío en JavaScript:

import { Client } from '@ndolestudio/httpsms-node'

const client = new Client({ apiKey: 'tu-api-key' })

await client.messages.send({
  from: '+34600000000',  // Tu número Android
  to: '+34611111111',
  content: 'Tu código de verificación es 123456'
})

Seguridad

El cifrado es AES-256 extremo a extremo entre el servidor y la app Android. Nadie entre medias puede leer el contenido de los mensajes. Las API keys se gestionan desde el panel web.

Para producción, recomiendan poner el servidor detrás de un reverse proxy con TLS (nginx, Caddy o Traefik) y restringir el acceso al panel con Cloudflare Turnstile.

Limitaciones a tener en cuenta

Un Android debe estar siempre encendido: la app necesita estar corriendo en un teléfono con SIM activa para que el gateway funcione
Depende de tu operador: los SMS se envían a través de tu plan de telefonía. Si tu operador limita SMS masivos, lo bloqueará
Latencia: no es instantáneo como una API cloud. Hay un salto extra servidor → push notification → Android → SMS
No es para volume alto: si necesitas enviar miles de SMS por minuto, esto no es la herramienta. Es para casos de bajo volume donde el coste de Twilio no se justifica

El contexto

httpSMS lleva desde 2022 en GitHub y ha acumulado más de 4.000 estrellas. Es un proyecto maduro, mantenido por Ndole Studio, con updates regulares y una comunidad activa.

La alternativa comercial más cercana es Twilio Programmable Messaging, que cobra ~$0.0079 por SMS en España. Si envías 1.000 SMS al mes, son ~$8/mes. Si envías 10.000, son ~$79/mes. Con httpSMS, el coste es tu plan de telefonía existente: cero.

Para desarrolladores que necesitan SMS programático sin volumen alto y sin querer depender de un tercero, httpSMS es de las mejores opciones open source disponibles.