Cómo crear un servidor de SMS OTP sin Twilio

Crear un flujo seguro de verificación de usuarios no debería requerir lidiar con interminables aprobaciones de operadores ni pagar tarifas exorbitantes por mensaje. En este tutorial, te mostraremos cómo crear un servidor de SMS OTP utilizando tu propio dispositivo Android y un backend local, evitando los altos costes y la burocracia de los proveedores tradicionales de SMS A2P.

¿Por qué crear un servidor de SMS OTP personalizado?

Cuando los desarrolladores buscan las mejores API para llamadas salientes y SMS desde sistemas backend, a menudo son dirigidos a gigantes de las telecomunicaciones tradicionales como Twilio, Vonage o MessageBird. Sin embargo, para desarrolladores independientes, startups y pequeños negocios fuera de EE. UU., estas plataformas se han vuelto cada vez más imprácticas. Entre el registro obligatorio de 10DLC, las tarifas de verificación de los operadores y los complejos procesos de configuración, el simple hecho de intentar enviar una contraseña de un solo uso (OTP) puede requerir semanas de trabajo administrativo.

Además, las pasarelas tradicionales te facturan por cada segmento de 160 caracteres y cobran tarifas base elevadas. Si estás creando un servicio localizado —como un sistema de reservas para una clínica, un portal para una autoescuela o un control de asistencia—, necesitas una API de SMS de bajo coste que simplemente funcione. Al aprender a crear tu propia pasarela de SMS con un teléfono Android, evitas por completo el registro con operadores y envías mensajes directamente desde un número que tus clientes ya reconocen.

Comparativa: API de SMS tradicionales vs. Pasarela Android de MySMSGate

A continuación, se muestra una comparación directa de lo que se necesita para enviar SMS transaccionales y OTP a través de las API tradicionales frente al uso de una pasarela basada en Android como MySMSGate.

Paso 1: Crear una cuenta e iniciar sesión en la aplicación MySMSGate

Para convertir un dispositivo Android en una pasarela de SMS programable, necesitas un servicio intermediario que conecte tu código backend con el sistema operativo Android. Aquí es donde entra en juego MySMSGate.

Primero, dirígete a la página de registro de MySMSGate para crear tu cuenta gratuita. Una vez que hayas iniciado sesión, verás tu clave API y un código QR único en tu panel web. Este código QR elimina la necesidad de copiar y pegar manualmente largas credenciales de API en tu dispositivo móvil.

A continuación, descarga la aplicación complementaria de Android en tu teléfono. Abre la aplicación, selecciona la opción para escanear el código QR de configuración y apunta tu cámara a la pantalla de tu ordenador. La aplicación se configurará automáticamente, establecerá una conexión segura a través de notificaciones push para permanecer activa en modo de suspensión y vinculará las ranuras de tu tarjeta SIM física con tu panel de desarrollador. Ahora ya estás listo para enrutar mensajes programáticos a través de tu teléfono.

Paso 2: Configurar tu hardware (teléfono y mini PC)

Muchos desarrolladores se preguntan: ¿cómo puedo crear mi propia API de SMS localmente usando un teléfono y un mini PC? La arquitectura de hardware para un servidor OTP local autoalojado es notablemente simple y resistente. No necesitas costosos racks de servidores; un mini PC básico (como un Intel NUC o una Raspberry Pi) con Linux, combinado con un teléfono Android de repuesto, es más que suficiente.

Conecta tu mini PC a tu red local. Este mini PC alojará la base de datos principal de tu aplicación y la lógica del backend (por ejemplo, Node.js, Python o Go). Tu teléfono Android no necesita estar conectado físicamente al mini PC mediante USB. Dado que MySMSGate gestiona la comunicación a través de webhooks seguros basados en la nube y endpoints de API, tu teléfono solo necesita una conexión estable a Wi-Fi o datos móviles. Esto te permite colocar el teléfono en una zona con óptima recepción de señal, incluso si tu mini PC está guardado en un armario de servidores.

Aprovechamiento del soporte Dual SIM y multidispositivo

Si diriges un negocio con múltiples sucursales, o si deseas separar el tráfico de OTP transaccionales de las alertas de marketing, puedes conectar un número ilimitado de teléfonos Android a una sola cuenta de MySMSGate. Si tu teléfono admite tarjetas Dual SIM, la plataforma te permite elegir mediante programación desde qué ranura de SIM enviar cada llamada de API saliente, dándote un control total sobre el enrutamiento y las tarifas de los operadores locales.

Paso 3: Escribir el código del servidor OTP

Ahora que tu hardware está conectado, puedes escribir la lógica del backend para generar, almacenar y enviar contraseñas de un solo uso. A continuación, se muestra un ejemplo completo y ligero en Node.js que demuestra cómo generar un OTP seguro de 6 dígitos, almacenarlo en memoria con una marca de tiempo de expiración y enviarlo a través de la API REST de MySMSGate.

const axios = require('axios');

// In-memory store for demonstration (use Redis in production)
const otpCache = new Map();

const MYSMSGATE_API_URL = 'https://mysmsgate.net/api/v1/send';
const API_KEY = 'YOUR_MYSMSGATE_API_KEY';

async function generateAndSendOTP(phoneNumber) {
  // Generate a cryptographically secure 6-digit code
  const otp = Math.floor(100000 + Math.random() * 900000).toString();
  const expiresAt = Date.now() + 5 * 60 * 1000; // 5 minutes expiry

  // Store OTP details
  otpCache.set(phoneNumber, { otp, expiresAt });

  // Prepare payload for MySMSGate API
  const payload = {
    to: phoneNumber,
    message: `Your verification code is ${otp}. It will expire in 5 minutes.`
  };

  try {
    const response = await axios.post(MYSMSGATE_API_URL, payload, {
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      }
    });
    console.log('OTP dispatched successfully:', response.data);
    return { success: true };
  } catch (error) {
    console.error('Failed to dispatch OTP via MySMSGate:', error.response ? error.response.data : error.message);
    return { success: false, error: 'SMS gateway communication failure' };
  }
}

Esta integración limpia de la API REST solo requiere una única solicitud POST para enviar el mensaje. No hay SDK complicados que mantener, lo que facilita la portabilidad de esta lógica a Python, Go, PHP o Ruby utilizando nuestra documentación de integración estándar.

Paso 4: Añadir verificación y seguimiento por webhook

Enviar el OTP es solo la mitad de la batalla; tu servidor también debe verificar la entrada del usuario y rastrear si el SMS realmente llegó a su dispositivo. Para verificar el código cuando el usuario lo envíe, implementa un endpoint de verificación simple en el backend de tu mini PC:

function verifyOTP(phoneNumber, userSubmittedCode) {
  const record = otpCache.get(phoneNumber);
  if (!record) {
    return { verified: false, reason: 'No OTP requested or code expired' };
  }

  if (Date.now() > record.expiresAt) {
    otpCache.delete(phoneNumber);
    return { verified: false, reason: 'OTP has expired' };
  }

  if (record.otp === userSubmittedCode) {
    otpCache.delete(phoneNumber); // Clear code after successful use
    return { verified: true };
  } 

  return { verified: false, reason: 'Incorrect code' };
}

Para supervisar el estado de entrega en tiempo real, configura una URL de webhook en tu panel de MySMSGate. Cada vez que tu teléfono Android envíe el mensaje y reciba un recibo de entrega de red del operador, MySMSGate enviará una actualización de estado de vuelta a tu servidor local. Si un mensaje no se puede entregar debido a un número no válido o a un error del operador, el saldo de tu cuenta se reembolsará automáticamente, garantizando que nunca pagues por intentos de verificación no entregados.

Expandiendo el servidor: Control de asistencia y alertas

Una vez que entiendas cómo configurar un servidor de SMS OTP, puedes reutilizar fácilmente la misma infraestructura de backend para gestionar otros flujos de trabajo empresariales. Por ejemplo, los centros educativos locales, las academias de tutoría y los clubes deportivos suelen preguntar cómo crear un control de asistencia con envío automático de SMS a los padres.

Al conectar tu registro digital de asistencia o quiosco de entrada al backend de tu mini PC, puedes activar alertas automáticas salientes. Cuando un estudiante escanea su tarjeta de identificación o registra su entrada, tu sistema puede llamar instantáneamente a la API de MySMSGate para enviar un mensaje personalizado: "Hola, su hijo ha llegado sin problemas al centro de tutoría a las 3:15 PM."

Del mismo modo, los negocios de servicios locales, como talleres de reparación de automóviles, clínicas dentales y salones de belleza, pueden utilizar esta configuración para crear plantillas de alertas por SMS para confirmaciones de reservas, recordatorios de citas y notificaciones de "listo para recoger". Dado que envías estas alertas desde tu propia tarjeta SIM, los clientes pueden responder directamente al SMS. Estas respuestas se reenvían a tu panel web de MySMSGate en tiempo real, lo que te permite mantener conversaciones bidireccionales desde tu navegador sin tener que coger el teléfono.

Preguntas frecuentes (FAQ)

Encuentra respuestas a las preguntas más comunes sobre cómo crear tu propia pasarela de SMS local y servidor OTP.

¿Cómo puedo crear mi propia API de SMS localmente usando un teléfono y un mini PC?

Para crear una API de SMS local, configura un mini PC (como una Raspberry Pi o Intel NUC) que ejecute el backend de tu aplicación y emparéjalo con un teléfono Android que ejecute la aplicación MySMSGate. El mini PC genera el contenido del SMS y lo envía al endpoint de la API REST de MySMSGate. La pasarela en la nube reenvía la solicitud a tu teléfono Android conectado a través de notificaciones push seguras, y la tarjeta SIM física del teléfono envía el SMS localmente.

¿Necesito la aprobación del operador o el registro 10DLC para enviar OTP?

No. Dado que MySMSGate enruta los mensajes a través de tu propio teléfono Android (personal o de negocios) y tarjeta SIM, no necesitas registrarte para el sistema A2P 10DLC, someterte a verificación de marca ni esperar las aprobaciones de los operadores. Puedes comenzar a enviar alertas transaccionales y códigos de verificación inmediatamente después de configurar la aplicación.

¿Cómo gestiona MySMSGate los fallos en la entrega de SMS?

Si un SMS no se entrega debido a problemas de red, un número de teléfono no válido o la falta de saldo del operador en tu tarjeta SIM, MySMSGate rastrea el estado del fallo a través de webhooks y reembolsa automáticamente la tarifa de API de $0.02 al saldo de tu cuenta. Solo pagas por los mensajes que se envían correctamente desde tu dispositivo.

¿Puedo utilizar tarjetas Dual SIM para enrutar mensajes OTP?

Sí. La aplicación Android de MySMSGate es totalmente compatible con dispositivos Dual SIM. Al realizar una solicitud POST a nuestra API, puedes definir mediante programación qué ranura de SIM (SIM 1 o SIM 2) debe utilizarse para enviar el mensaje, lo que te permite optimizar el enrutamiento en función de las tarifas de los operadores locales.