Bot SMS
In questa pagina 7 sezioni
L'app SMS di Localtonet trasforma un telefono Android in un endpoint SMS: segnala gli SMS in arrivo, invia SMS e compone codici USSD. La controlli da Telegram con il bot SMS di Localtonet, oppure dalla dashboard.
Come funziona #
- L'app SMS di Localtonet gira sul telefono Android e accede con un AuthToken.
- Il bot SMS di Localtonet è un bot di Telegram. Dopo aver effettuato l'accesso con la tua chiave API, ti invia gli SMS che arrivano sui tuoi telefoni e accetta comandi per essi.
- Anche la dashboard può inviare SMS ed eseguire codici USSD: nella scheda SMS di un dispositivo in Gestore proxy e sotto Impostazioni SMS di un token in I miei token.
Prima di iniziare #
- Un telefono Android con una SIM. L'app SMS è creata per Android 5.0 e versioni successive.
- Un AuthToken per quel telefono. Se l'app Localtonet è già in esecuzione sul telefono, usa lo stesso token: la dashboard collega l'app SMS a un dispositivo tramite il suo token.
- La tua chiave API. Si trova nella Dashboard sotto Chiave API.
- Un account Telegram, per usare il bot.
Configura l'app SMS #
-
Scarica e installa #
Scarica l'app SMS per Android da localtonet.com/download/localtonet-smsapp.zip. Lo stesso link si trova dietro Scarica l'app SMS nella scheda SMS di un dispositivo nel Gestore proxy. Estrai l'archivio e installa l'app sul telefono. Android ti chiede prima di consentire l'installazione di app da questa fonte.
-
Concedi i permessi #
Apri Localtonet Sms. L'app chiede i permessi con cui funziona:
Permesso Serve per Invia SMS Inviare messaggi dalla SIM del telefono. Leggi SMS, ricevi SMS Leggere la posta in arrivo e segnalare i messaggi ricevuti. Chiamate telefoniche Eseguire codici USSD. L'app li compone. Fotocamera Scansionare il codice QR di un token. Notifiche Mostrare la notifica dell'app mentre è in esecuzione. -
Accedi con il token #
Digita o incolla il token in Enter Authtoken, oppure scansiona il codice QR del token da I miei token, poi seleziona Save. L'app mostra il nome del token, il tuo piano e lo stato della connessione. Connected e Listening Sms significano che è pronta. Wrong Token significa che il token non è valido. Logout disconnette l'app.
Lascia l'app in esecuzione. I comandi raggiungono il telefono solo mentre l'app SMS è connessa.
Accedi al bot di Telegram #
-
Apri il bot #
Apri t.me/localtonet_sms_bot in Telegram e avvia una chat.
-
Invia /login con la tua chiave API #
Telegram/login <API_KEY>Il bot risponde You are now authorized as seguito dall'email del tuo account. Una chiave sbagliata riceve la risposta Invalid API key.
Da quel momento il bot invia a questa chat ogni SMS che arriva su un telefono del tuo account. Ogni messaggio mostra il nome del token del telefono, il numero del mittente e il testo.
La chiave API controlla l'intero account, non solo gli SMS. Invia /login solo nella chat privata con il bot, mai in un gruppo. Se la chiave viene divulgata, cambiala nella Dashboard con Cambia nella scheda Chiave API e accedi di nuovo al bot con la nuova chiave.
Comandi #
/login richiede la tua chiave API. Gli altri comandi richiedono l'AuthToken del telefono a cui sono destinati. Separa le parti con un solo spazio.
| Comando | Cosa fa | Argomenti |
|---|---|---|
/login <API_KEY> | Collega questa chat di Telegram al tuo account. | La tua chiave API. |
/help | Mostra l'elenco dei comandi. | Nessuno. |
/readallsms <AUTH_TOKEN> <HOURS> | Legge la posta SMS in arrivo del telefono e ti invia i messaggi ricevuti nelle ultime ore. | Il token del telefono e un numero intero di ore. Senza il numero, viene letta l'ultima ora. |
/sendussdcode <AUTH_TOKEN> <USSD_CODE> | Compone un codice USSD sul telefono. | Il token del telefono e il codice, ad esempio *123#. Il codice non deve contenere spazi. |
/sendsms <AUTH_TOKEN> <PHONE_NUMBER> <MESSAGE> | Invia un SMS dalla SIM del telefono. | Il token del telefono, il numero del destinatario con il prefisso internazionale e senza spazi, poi il messaggio. Il messaggio può contenere spazi. |
Esempi #
/readallsms <AUTH_TOKEN> 1
/sendussdcode <AUTH_TOKEN> *123#
/sendsms <AUTH_TOKEN> +15615557689 Hello- Dopo
/readallsmsil bot risponde Reading all Sms e poi invia i messaggi uno per uno. - Dopo
/sendsmsil bot risponde Sending Sms con il numero. Quando il telefono segnala che il messaggio è stato inviato e consegnato, il bot inoltra questi resoconti. - Dopo
/sendussdcodeil bot risponde Sending ussd code con il codice. Il bot conferma soltanto che il codice è stato inviato al telefono.
Risoluzione dei problemi #
You need to authorize first. Use /login <apikey>
Questa chat non ha effettuato l'accesso, oppure l'accesso è andato perso. Invia di nuovo /login <API_KEY>.
Invalid API key
Copia di nuovo la chiave dalla Dashboard. Scrivi il comando come /login, uno spazio, poi la chiave, senza nient'altro dopo.
You need to enter authtoken and …
Il comando non ha il numero giusto di parti. Controlla la tabella qui sopra: /sendussdcode richiede esattamente un token e un codice, /sendsms richiede un token, un numero e un messaggio.
Il bot conferma un comando ma sul telefono non succede nulla
Controlla che il token nel comando sia quello con cui ha effettuato l'accesso l'app SMS, che l'app mostri Connected e che abbia i permessi per SMS e telefono.
Gli SMS in arrivo non arrivano più su Telegram
I messaggi vengono inviati alla chat che ha effettuato l'accesso con la tua chiave API attuale. Se hai cambiato la chiave API, invia /login con la nuova chiave. Controlla anche che l'app SMS sul telefono sia ancora connessa.
La dashboard dice Devi acquistare del saldo per usare questa funzione.
Inviare SMS ed eseguire codici USSD dalla dashboard richiede Saldo sul tuo account. Vedi Piani e saldo.