Pasarela SMS en Android: convierte un teléfono tuyo en una pasarela para tus códigos de verificación

Qué necesitas

• Un teléfono con Android 8.0 o posterior, con la SIM cuyos códigos quieres. Funcionan teléfonos de una o de dos SIM, y no hace falta root.
• Un teléfono real. Los emuladores no se admiten como pasarela: la idea es una SIM real en una red móvil real.
• La app de BusySMS de Google Play (paquete net.busysms.app).
• Una cuenta de BusySMS. Inicias sesión con un código de un solo uso que se envía a tu correo; no hay contraseña que crear.

Configura la pasarela en cinco pasos

1. 1

   Instala la app

   Instala BusySMS desde Google Play en el teléfono que tiene la SIM. Google Play es la única forma de instalarla, así que las actualizaciones llegan como siempre.

2. 2

   Inicia sesión con tu correo electrónico

   Escribe tu correo electrónico y el código que te enviamos. Cuando tu número ya esté en la cuenta, también podrás entrar con él. La misma cuenta funciona en la web, en los clientes MCP y en la extensión para Chrome.

3. 3

   Registra el teléfono y verifica la SIM

   Elige la SIM. BusySMS envía un código a ese número y la app lo captura, lo que demuestra que la SIM realmente tiene ese número. Hasta que un número está verificado, nada de lo que recibe se guarda, se puede leer ni se factura.

4. 4

   Permite el acceso a los SMS y enciende la pasarela

   Permite el acceso a los SMS cuando la app lo pida. También se recomienda dar acceso a las notificaciones, porque la app de Mensajes de algunos fabricantes entrega los códigos como notificaciones. Enciende la pasarela: Android muestra una notificación persistente mientras dure la captura, y desde ahí puedes detenerla en cualquier momento.

5. 5

   Lee tu primer código

   Abre SMS recibidos en el panel, o crea una clave de API en API REST y llama a GET /api/v1/codes. Cualquier código que llegue al teléfono a partir de ahora aparece en ambos.

Lee un código por la API REST

Cada petición lleva tu clave de API, que empieza por bsk_live_, en la cabecera Authorization: Bearer. La clave pertenece a tu cuenta, así que solo ve tus propios teléfonos, además de los números que alguien haya compartido contigo.

export BUSYSMS_API_KEY=bsk_live_xxxxxxxx

# Wait up to 60 s for the next code on any of your numbers
curl -s -H "Authorization: Bearer $BUSYSMS_API_KEY" \
  "https://busysms.net/api/v1/codes?timeoutMs=60000"

// Node 18+ (built-in fetch)
const res = await fetch("https://busysms.net/api/v1/codes?timeoutMs=60000", {
  headers: { Authorization: `Bearer ${process.env.BUSYSMS_API_KEY}` },
});
if (!res.ok) throw new Error(`BusySMS ${res.status}: ${await res.text()}`);

const { code, message } = await res.json();
console.log(code ?? "No new code within 60 s", message?.sender);

import os
import requests

r = requests.get(
    "https://busysms.net/api/v1/codes",
    params={"timeoutMs": 60000},
    headers={"Authorization": f"Bearer {os.environ['BUSYSMS_API_KEY']}"},
    timeout=75,  # longer than the long-poll itself
)
r.raise_for_status()
print(r.json()["code"] or "No new code within 60 s")

Con timeoutMs mayor que cero, la llamada hace long-polling hasta 90 segundos y solo devuelve un código que llegue después de iniciar la petición, nunca uno anterior, porque enviar un código ya usado gasta un intento de inicio de sesión. Los endpoints, filtros y códigos de error están en la guía de la API de pasarela SMS.

Cuatro formas de leer los códigos

Límites que conviene conocer antes de empezar

• En una SIM configurada con solo códigos, solo se capturan los mensajes que parecen un código de verificación; los demás se quedan en el teléfono. No se captura nada mientras la pasarela está apagada.
• Si llega un código con la pasarela apagada, vuelve a encenderla: BusySMS recoge los mensajes de verificación de los últimos 15 minutos.
• El ahorro de batería puede detener las apps en segundo plano. Si dejan de llegar códigos, excluye BusySMS de la optimización de batería y deja su notificación visible.
• Los mensajes capturados se borran en un plazo máximo de 7 días. Guarda tú mismo lo que necesites conservar más tiempo.
• Para leer códigos necesitas una prueba o una suscripción activa. Si vence, el teléfono sigue capturando, pero las lecturas por API y MCP devuelven 402 payment_required hasta que se resuelva la facturación.
• Apagar la pasarela no detiene la facturación de un número verificado. Quita el número en el panel para dejar de pagarlo.

Precios

$5 por número de teléfono verificado al mes, con una semana gratis (7 días de prueba) en cada cuenta. Una sola suscripción cubre toda la cuenta y se cobra con tarjeta a través de Stripe en el panel web: añade un número y la factura sube $5; quita uno y baja. La app de Android muestra tu plan, pero no lo vende.

Dudas

Preguntas frecuentes