Aller au contenu
Localtonet Localtonet Tableau de bord

Bot SMS

Aide pour cette page
Sur cette page 7 sections
  1. Fonctionnement
  2. Avant de commencer
  3. Configurer l'application SMS
  4. Télécharger et installer
  5. Accorder les autorisations
  6. Se connecter avec le jeton
  7. Se connecter au bot Telegram
  8. Ouvrir le bot
  9. Envoyer /login avec votre clé API
  10. Commandes
  11. Exemples
  12. Dépannage
  13. Pages associées

L'application Localtonet SMS transforme un téléphone Android en point d'accès SMS : elle signale les SMS entrants, envoie des SMS et compose des codes USSD. Vous la pilotez depuis Telegram avec le bot SMS Localtonet, ou depuis le tableau de bord.

Fonctionnement #

  • L'application Localtonet SMS s'exécute sur le téléphone Android et se connecte avec un AuthToken.
  • Le bot SMS Localtonet est un bot Telegram. Une fois que vous vous êtes connecté avec votre clé API, il vous transmet les SMS reçus sur vos téléphones et accepte des commandes pour ceux-ci.
  • Le tableau de bord peut aussi envoyer des SMS et exécuter des codes USSD : dans l'onglet SMS d'un appareil du Gestionnaire de proxys, et sous Paramètres SMS d'un jeton dans Mes jetons.

Avant de commencer #

  • Un téléphone Android avec une carte SIM. L'application SMS est conçue pour Android 5.0 et versions ultérieures.
  • Un AuthToken pour ce téléphone. Si l'application Localtonet fonctionne déjà sur le téléphone, utilisez le même jeton : le tableau de bord relie l'application SMS à un appareil par son jeton.
  • Votre clé API. Elle s'affiche sur le Tableau de bord sous Clé API.
  • Un compte Telegram, pour utiliser le bot.

Configurer l'application SMS #

  1. Télécharger et installer #

    Téléchargez l'application SMS pour Android depuis localtonet.com/download/localtonet-smsapp.zip. Le même lien se trouve derrière Télécharger l'application SMS dans l'onglet SMS d'un appareil du Gestionnaire de proxys. Extrayez l'archive et installez l'application sur le téléphone. Android vous demande d'abord d'autoriser l'installation d'applications depuis cette source.

  2. Accorder les autorisations #

    Ouvrez Localtonet Sms. L'application demande les autorisations dont elle a besoin :

    AutorisationNécessaire pour
    Envoyer des SMSEnvoyer des messages depuis la carte SIM du téléphone.
    Lire les SMS, recevoir des SMSLire la boîte de réception et signaler les messages entrants.
    Appels téléphoniquesExécuter des codes USSD. L'application les compose.
    Appareil photoScanner le code QR d'un jeton.
    NotificationsAfficher la notification de l'application pendant son exécution.
  3. Se connecter avec le jeton #

    Saisissez ou collez le jeton dans Enter Authtoken, ou scannez le code QR du jeton depuis Mes jetons, puis sélectionnez Save. L'application affiche le nom du jeton, votre offre et l'état de la connexion. Connected et Listening Sms signifient qu'elle est prête. Wrong Token signifie que le jeton n'est pas valide. Logout déconnecte l'application.

Laissez l'application en cours d'exécution. Les commandes n'atteignent le téléphone que tant que l'application SMS est connectée.

Se connecter au bot Telegram #

  1. Ouvrir le bot #

    Ouvrez t.me/localtonet_sms_bot dans Telegram et démarrez une conversation.

  2. Envoyer /login avec votre clé API #

    Telegram
    /login <API_KEY>

    Le bot répond You are now authorized as suivi de l'e-mail de votre compte. Une clé erronée reçoit la réponse Invalid API key.

Dès lors, le bot envoie à cette conversation chaque SMS qui arrive sur un téléphone de votre compte. Chaque message indique le nom du jeton du téléphone, le numéro de l'expéditeur et le texte.

La clé API contrôle tout votre compte, pas seulement les SMS. Envoyez /login uniquement dans la conversation privée avec le bot, jamais dans un groupe. Si la clé fuite, changez-la sur le tableau de bord avec Modifier dans la carte Clé API, puis reconnectez-vous au bot avec la nouvelle clé.

Commandes #

/login prend votre clé API. Les autres commandes prennent l'AuthToken du téléphone concerné. Séparez les éléments par des espaces simples.

CommandeFonctionArguments
/login <API_KEY>Associe cette conversation Telegram à votre compte.Votre clé API.
/helpAffiche la liste des commandes.Aucun.
/readallsms <AUTH_TOKEN> <HOURS>Lit la boîte de réception SMS du téléphone et vous envoie les messages reçus au cours des dernières heures.Le jeton du téléphone et un nombre entier d'heures. Sans ce nombre, la dernière heure est lue.
/sendussdcode <AUTH_TOKEN> <USSD_CODE>Compose un code USSD sur le téléphone.Le jeton du téléphone et le code, par exemple *123#. Le code ne doit pas contenir d'espaces.
/sendsms <AUTH_TOKEN> <PHONE_NUMBER> <MESSAGE>Envoie un SMS depuis la carte SIM du téléphone.Le jeton du téléphone, le numéro du destinataire avec l'indicatif du pays et sans espaces, puis le message. Le message peut contenir des espaces.

Exemples #

Telegram
/readallsms <AUTH_TOKEN> 1
/sendussdcode <AUTH_TOKEN> *123#
/sendsms <AUTH_TOKEN> +15615557689 Hello
  • Après /readallsms, le bot répond Reading all Sms puis envoie les messages un par un.
  • Après /sendsms, le bot répond Sending Sms avec le numéro. Lorsque le téléphone signale que le message a été envoyé et remis, le bot relaie ces rapports.
  • Après /sendussdcode, le bot répond Sending ussd code avec le code. Le bot confirme seulement que le code a été envoyé au téléphone.

Dépannage #

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

Cette conversation n'est pas connectée, ou la connexion a été perdue. Envoyez de nouveau /login <API_KEY>.

Invalid API key

Copiez de nouveau la clé depuis le tableau de bord. Écrivez la commande sous la forme /login, un espace, puis la clé, sans rien après.

You need to enter authtoken and …

La commande n'a pas le bon nombre d'éléments. Consultez le tableau ci-dessus : /sendussdcode exige exactement un jeton et un code, /sendsms exige un jeton, un numéro et un message.

Le bot confirme une commande mais rien ne se passe sur le téléphone

Vérifiez que le jeton de la commande est bien celui avec lequel l'application SMS s'est connectée, que l'application affiche Connected, et qu'elle dispose des autorisations SMS et téléphone.

Les SMS entrants n'arrivent plus dans Telegram

Les messages sont envoyés à la conversation qui s'est connectée avec votre clé API actuelle. Si vous avez changé la clé API, envoyez /login avec la nouvelle clé. Vérifiez aussi que l'application SMS du téléphone est toujours connectée.

Le tableau de bord affiche « Vous devez acheter du solde pour utiliser cette fonctionnalité. »

L'envoi de SMS et l'exécution de codes USSD depuis le tableau de bord nécessitent du solde sur votre compte. Voir Offres et solde.

Support