Saltar al contenido
Localtonet Localtonet Panel

Bot de SMS

Ayuda con esta página
En esta página 7 secciones
  1. Cómo funciona
  2. Antes de empezar
  3. Configura la app de SMS
  4. Descarga e instala
  5. Concede los permisos
  6. Inicia sesión con el token
  7. Inicia sesión en el bot de Telegram
  8. Abre el bot
  9. Envía /login con tu clave de API
  10. Comandos
  11. Ejemplos
  12. Solución de problemas
  13. Páginas relacionadas

La app de SMS de Localtonet convierte un teléfono Android en un punto de acceso SMS: informa de los SMS entrantes, envía SMS y marca códigos USSD. La controlas desde Telegram con el bot de SMS de Localtonet, o desde el dashboard.

Cómo funciona #

  • La app de SMS de Localtonet se ejecuta en el teléfono Android e inicia sesión con un AuthToken.
  • El bot de SMS de Localtonet es un bot de Telegram. Cuando inicias sesión con tu clave de API, te envía los SMS que llegan a tus teléfonos y acepta comandos para ellos.
  • El dashboard también puede enviar SMS y ejecutar códigos USSD: en la pestaña SMS de un dispositivo en el Gestor de proxies y en Configuración de SMS de un token en Mis tokens.

Antes de empezar #

  • Un teléfono Android con tarjeta SIM. La app de SMS está creada para Android 5.0 y posteriores.
  • Un AuthToken para ese teléfono. Si la app de Localtonet ya se ejecuta en el teléfono, usa el mismo token: el dashboard conecta la app de SMS a un dispositivo por su token.
  • Tu clave de API. Se muestra en el Panel, en Clave de API.
  • Una cuenta de Telegram, para usar el bot.

Configura la app de SMS #

  1. Descarga e instala #

    Descarga la app de SMS para Android desde localtonet.com/download/localtonet-smsapp.zip. El mismo enlace está detrás de Descargar app de SMS, en la pestaña SMS de un dispositivo en el Gestor de proxies. Extrae el archivo e instala la app en el teléfono. Android te pide primero que permitas instalar apps desde este origen.

  2. Concede los permisos #

    Abre Localtonet Sms. La app pide los permisos con los que funciona:

    PermisoNecesario para
    Send SMSEnviar mensajes desde la tarjeta SIM del teléfono.
    Read SMS, receive SMSLeer la bandeja de entrada e informar de los mensajes entrantes.
    Phone callsEjecutar códigos USSD. La app los marca.
    CameraEscanear el código QR de un token.
    NotificationsMostrar la notificación de la app mientras se ejecuta.
  3. Inicia sesión con el token #

    Escribe o pega el token en Enter Authtoken, o escanea el código QR del token desde Mis tokens y luego selecciona Save. La app muestra el nombre del token, tu plan y el estado de la conexión. Connected y Listening Sms significan que está lista. Wrong Token significa que el token no es válido. Logout cierra la sesión de la app.

Deja la app en ejecución. Los comandos llegan al teléfono solo mientras la app de SMS está conectada.

Inicia sesión en el bot de Telegram #

  1. Abre el bot #

    Abre t.me/localtonet_sms_bot en Telegram e inicia un chat.

  2. Envía /login con tu clave de API #

    Telegram
    /login <API_KEY>

    El bot responde You are now authorized as seguido del correo de tu cuenta. Si la clave es incorrecta, responde Invalid API key.

A partir de ese momento, el bot envía a este chat todos los SMS que llegan a un teléfono de tu cuenta. Cada mensaje muestra el nombre del token del teléfono, el número del remitente y el texto.

La clave de API controla toda tu cuenta, no solo los SMS. Envía /login solo en el chat privado con el bot, nunca en un grupo. Si la clave se filtra, cámbiala en el Panel con Cambiar en la tarjeta Clave de API e inicia sesión de nuevo en el bot con la clave nueva.

Comandos #

/login recibe tu clave de API. Los demás comandos reciben el AuthToken del teléfono al que van dirigidos. Separa las partes con un solo espacio.

ComandoQué haceArgumentos
/login <API_KEY>Vincula este chat de Telegram a tu cuenta.Tu clave de API.
/helpMuestra la lista de comandos.Ninguno.
/readallsms <AUTH_TOKEN> <HOURS>Lee la bandeja de entrada de SMS del teléfono y te envía los mensajes recibidos en las últimas horas.El token del teléfono y un número entero de horas. Sin el número, se lee la última hora.
/sendussdcode <AUTH_TOKEN> <USSD_CODE>Marca un código USSD en el teléfono.El token del teléfono y el código, por ejemplo *123#. El código no debe contener espacios.
/sendsms <AUTH_TOKEN> <PHONE_NUMBER> <MESSAGE>Envía un SMS desde la tarjeta SIM del teléfono.El token del teléfono, el número del destinatario con prefijo de país y sin espacios, y después el mensaje. El mensaje puede contener espacios.

Ejemplos #

Telegram
/readallsms <AUTH_TOKEN> 1
/sendussdcode <AUTH_TOKEN> *123#
/sendsms <AUTH_TOKEN> +15615557689 Hello
  • Tras /readallsms, el bot responde Reading all Sms y después envía los mensajes uno a uno.
  • Tras /sendsms, el bot responde Sending Sms con el número. Cuando el teléfono informa de que el mensaje se envió y se entregó, el bot retransmite esos avisos.
  • Tras /sendussdcode, el bot responde Sending ussd code con el código. El bot solo confirma que el código se envió al teléfono.

Solución de problemas #

You need to authorize first. Use /login <apikey>

Este chat no ha iniciado sesión, o se perdió el inicio de sesión. Envía de nuevo /login <API_KEY>.

Invalid API key

Copia de nuevo la clave desde el Panel. Escribe el comando como /login, un espacio y después la clave, sin nada más detrás.

You need to enter authtoken and …

El comando no tiene el número correcto de partes. Revisa la tabla de arriba: /sendussdcode necesita exactamente un token y un código, y /sendsms necesita un token, un número y un mensaje.

El bot confirma un comando pero no ocurre nada en el teléfono

Comprueba que el token del comando es el que usó la app de SMS para iniciar sesión, que la app muestra Connected y que tiene los permisos de SMS y de teléfono.

Los SMS entrantes dejaron de llegar a Telegram

Los mensajes se envían al chat que inició sesión con tu clave de API actual. Si cambiaste la clave de API, envía /login con la clave nueva. Comprueba también que la app de SMS del teléfono sigue conectada.

El dashboard dice Necesitas comprar saldo para usar esta función.

Enviar SMS y ejecutar códigos USSD desde el dashboard necesita Saldo en tu cuenta. Consulta Planes y saldo.

Soporte