SMS-bot
Op deze pagina 7 secties
De Localtonet-sms-app maakt van een Android-telefoon een sms-eindpunt: de app meldt binnenkomende sms-berichten, verstuurt sms en kiest USSD-codes. Je bedient de app via Telegram met de Localtonet-sms-bot, of vanuit het dashboard.
Hoe het werkt #
- De Localtonet-sms-app draait op de Android-telefoon en meldt zich aan met een AuthToken.
- De Localtonet-sms-bot is een Telegram-bot. Nadat je je met je API-sleutel hebt aangemeld, stuurt de bot je de sms-berichten die op je telefoons binnenkomen en accepteert hij opdrachten voor die telefoons.
- Het dashboard kan ook sms versturen en USSD-codes uitvoeren: op het tabblad Sms van een apparaat in Proxybeheer, en onder Sms-instellingen van een token in Mijn tokens.
Voordat je begint #
- Een Android-telefoon met een simkaart. De sms-app is gemaakt voor Android 5.0 en nieuwer.
- Een AuthToken voor die telefoon. Als de Localtonet-app al op de telefoon draait, gebruik dan dezelfde token: het dashboard koppelt de sms-app aan een apparaat via zijn token.
- Je API-sleutel. Die staat op het Dashboard onder API-sleutel.
- Een Telegram-account, om de bot te gebruiken.
De sms-app instellen #
-
Downloaden en installeren #
Download de sms-app voor Android via localtonet.com/download/localtonet-smsapp.zip. Dezelfde link zit achter Sms-app downloaden op het tabblad Sms van een apparaat in Proxybeheer. Pak het archief uit en installeer de app op de telefoon. Android vraagt eerst of je apps uit deze bron wilt toestaan.
-
Geef de machtigingen #
Open Localtonet Sms. De app vraagt om de machtigingen waarmee hij werkt:
Machtiging Nodig om Sms verzenden Berichten te versturen vanaf de simkaart van de telefoon. Sms lezen, sms ontvangen De inbox te lezen en binnenkomende berichten te melden. Telefoongesprekken USSD-codes uit te voeren. De app kiest ze. Camera De QR-code van een token te scannen. Meldingen De melding van de app te tonen terwijl hij draait. -
Aanmelden met de token #
Typ of plak de token in Enter Authtoken, of scan de QR-code van de token via Mijn tokens, en kies daarna Save. De app toont de tokennaam, je abonnement en de verbindingsstatus. Connected en Listening Sms betekenen dat de app gereed is. Wrong Token betekent dat de token ongeldig is. Met Logout meld je de app af.
Laat de app draaien. Opdrachten bereiken de telefoon alleen zolang de sms-app verbonden is.
Aanmelden bij de Telegram-bot #
-
Open de bot #
Open t.me/localtonet_sms_bot in Telegram en start een chat.
-
Stuur /login met je API-sleutel #
Telegram/login <API_KEY>De bot antwoordt You are now authorized as gevolgd door het e-mailadres van je account. Bij een verkeerde sleutel antwoordt hij Invalid API key.
Vanaf nu stuurt de bot elke sms die op een telefoon van je account binnenkomt naar deze chat. Elk bericht toont de tokennaam van de telefoon, het nummer van de afzender en de tekst.
De API-sleutel beheert je hele account, niet alleen sms. Stuur /login alleen in de privéchat met de bot, nooit in een groep. Als de sleutel uitlekt, wijzig je hem op het Dashboard met Wijzigen op de kaart API-sleutel en meld je je opnieuw aan bij de bot met de nieuwe sleutel.
Opdrachten #
/login neemt je API-sleutel. De andere opdrachten nemen de AuthToken van de telefoon waarvoor ze bedoeld zijn. Scheid de onderdelen met enkele spaties.
| Opdracht | Wat het doet | Argumenten |
|---|---|---|
/login <API_KEY> | Koppelt deze Telegram-chat aan je account. | Je API-sleutel. |
/help | Toont de lijst met opdrachten. | Geen. |
/readallsms <AUTH_TOKEN> <HOURS> | Leest de sms-inbox van de telefoon en stuurt je de berichten die in de afgelopen uren zijn ontvangen. | De token van de telefoon en een geheel aantal uren. Zonder dat getal wordt het laatste uur gelezen. |
/sendussdcode <AUTH_TOKEN> <USSD_CODE> | Kiest een USSD-code op de telefoon. | De token van de telefoon en de code, bijvoorbeeld *123#. De code mag geen spaties bevatten. |
/sendsms <AUTH_TOKEN> <PHONE_NUMBER> <MESSAGE> | Verstuurt een sms vanaf de simkaart van de telefoon. | De token van de telefoon, het nummer van de ontvanger met landcode en zonder spaties, en daarna het bericht. Het bericht mag spaties bevatten. |
Voorbeelden #
/readallsms <AUTH_TOKEN> 1
/sendussdcode <AUTH_TOKEN> *123#
/sendsms <AUTH_TOKEN> +15615557689 Hello- Na
/readallsmsantwoordt de bot Reading all Sms en stuurt hij daarna de berichten één voor één. - Na
/sendsmsantwoordt de bot Sending Sms met het nummer. Wanneer de telefoon meldt dat het bericht is verzonden en afgeleverd, geeft de bot die meldingen door. - Na
/sendussdcodeantwoordt de bot Sending ussd code met de code. De bot bevestigt alleen dat de code naar de telefoon is gestuurd.
Probleemoplossing #
You need to authorize first. Use /login <apikey>
Deze chat is niet aangemeld, of de aanmelding is verloren gegaan. Stuur /login <API_KEY> opnieuw.
Invalid API key
Kopieer de sleutel opnieuw van het Dashboard. Schrijf de opdracht als /login, één spatie en dan de sleutel, zonder iets erna.
'You need to enter authtoken and …'
De opdracht heeft niet het juiste aantal onderdelen. Controleer de tabel hierboven: /sendussdcode heeft precies een token en een code nodig, /sendsms een token, een nummer en een bericht.
De bot bevestigt een opdracht, maar er gebeurt niets op de telefoon
Controleer of de token in de opdracht dezelfde is als waarmee de sms-app zich heeft aangemeld, of de app Connected toont en of hij de sms- en telefoonmachtigingen heeft.
Binnenkomende sms-berichten komen niet meer aan in Telegram
Berichten worden gestuurd naar de chat die zich met je huidige API-sleutel heeft aangemeld. Als je de API-sleutel hebt gewijzigd, stuur dan /login met de nieuwe sleutel. Controleer ook of de sms-app op de telefoon nog verbonden is.
Het dashboard meldt Je moet saldo kopen om deze functie te gebruiken.
Voor het versturen van sms en het uitvoeren van USSD-codes vanuit het dashboard is saldo op je account nodig. Zie Abonnementen en saldo.