Zum Inhalt springen
Localtonet Localtonet Dashboard

SMS-Bot

Hilfe zu dieser Seite
Auf dieser Seite 7 Abschnitte
  1. So funktioniert es
  2. Bevor Sie beginnen
  3. Die SMS-App einrichten
  4. Herunterladen und installieren
  5. Die Berechtigungen erteilen
  6. Mit dem Token anmelden
  7. Beim Telegram-Bot anmelden
  8. Den Bot öffnen
  9. /login mit Ihrem API-Schlüssel senden
  10. Befehle
  11. Beispiele
  12. Fehlerbehebung
  13. Verwandte Seiten

Die Localtonet-SMS-App macht ein Android-Telefon zu einem SMS-Endpunkt: Sie meldet eingehende SMS, sendet SMS und wählt USSD-Codes. Sie steuern sie über Telegram mit dem Localtonet-SMS-Bot oder über das Dashboard.

So funktioniert es #

  • Die Localtonet-SMS-App läuft auf dem Android-Telefon und meldet sich mit einem AuthToken an.
  • Der Localtonet-SMS-Bot ist ein Telegram-Bot. Nachdem Sie sich mit Ihrem API-Schlüssel angemeldet haben, sendet er Ihnen die SMS, die auf Ihren Telefonen eingehen, und akzeptiert Befehle für diese Telefone.
  • Das Dashboard kann ebenfalls SMS senden und USSD-Codes ausführen: auf der Registerkarte SMS eines Geräts im Proxy-Manager und unter SMS-Einstellungen eines Tokens in Meine Tokens.

Bevor Sie beginnen #

  • Ein Android-Telefon mit SIM-Karte. Die SMS-App ist für Android 5.0 und neuer gebaut.
  • Ein AuthToken für dieses Telefon. Läuft die Localtonet-App bereits auf dem Telefon, verwenden Sie dasselbe Token: Das Dashboard verbindet die SMS-App anhand ihres Tokens mit einem Gerät.
  • Ihr API-Schlüssel. Er wird im Dashboard unter API-Schlüssel angezeigt.
  • Ein Telegram-Konto, um den Bot zu nutzen.

Die SMS-App einrichten #

  1. Herunterladen und installieren #

    Laden Sie die SMS-App für Android von localtonet.com/download/localtonet-smsapp.zip herunter. Derselbe Link steht hinter SMS-App herunterladen auf der Registerkarte SMS eines Geräts im Proxy-Manager. Entpacken Sie das Archiv und installieren Sie die App auf dem Telefon. Android fordert Sie zuerst auf, die Installation von Apps aus dieser Quelle zu erlauben.

  2. Die Berechtigungen erteilen #

    Öffnen Sie Localtonet Sms. Die App fragt die Berechtigungen ab, mit denen sie arbeitet:

    BerechtigungWofür sie nötig ist
    SMS sendenNachrichten von der SIM-Karte des Telefons senden.
    SMS lesen, SMS empfangenDen Posteingang lesen und eingehende Nachrichten melden.
    TelefonanrufeUSSD-Codes ausführen. Die App wählt sie.
    KameraDen QR-Code eines Tokens scannen.
    BenachrichtigungenDie Benachrichtigung der App anzeigen, solange sie läuft.
  3. Mit dem Token anmelden #

    Geben Sie das Token bei Enter Authtoken ein oder fügen Sie es dort ein, oder scannen Sie den QR-Code des Tokens aus Meine Tokens, und wählen Sie dann Save. Die App zeigt den Tokennamen, Ihren Plan und den Verbindungsstatus. Connected und Listening Sms bedeuten, dass sie bereit ist. Wrong Token bedeutet, dass das Token ungültig ist. Logout meldet die App ab. Die App zeigt diese Bezeichnungen nur auf Englisch.

Lassen Sie die App laufen. Befehle erreichen das Telefon nur, solange die SMS-App verbunden ist.

Beim Telegram-Bot anmelden #

  1. Den Bot öffnen #

    Öffnen Sie t.me/localtonet_sms_bot in Telegram und starten Sie einen Chat.

  2. /login mit Ihrem API-Schlüssel senden #

    Telegram
    /login <API_KEY>

    Der Bot antwortet mit You are now authorized as, gefolgt von der E-Mail-Adresse Ihres Kontos. Auf einen falschen Schlüssel antwortet er mit Invalid API key.

Ab jetzt sendet der Bot jede SMS, die auf einem Telefon Ihres Kontos eingeht, an diesen Chat. Jede Nachricht zeigt den Tokennamen des Telefons, die Nummer des Absenders und den Text.

Der API-Schlüssel steuert Ihr gesamtes Konto, nicht nur SMS. Senden Sie /login nur im privaten Chat mit dem Bot, nie in einer Gruppe. Wenn der Schlüssel offengelegt wird, ändern Sie ihn im Dashboard mit Ändern in der Karte API-Schlüssel und melden Sie sich mit dem neuen Schlüssel erneut beim Bot an.

Befehle #

/login erwartet Ihren API-Schlüssel. Die übrigen Befehle erwarten den AuthToken des Telefons, für das sie bestimmt sind. Trennen Sie die Teile mit einzelnen Leerzeichen.

BefehlFunktionArgumente
/login <API_KEY>Verknüpft diesen Telegram-Chat mit Ihrem Konto.Ihr API-Schlüssel.
/helpZeigt die Liste der Befehle.Keine.
/readallsms <AUTH_TOKEN> <HOURS>Liest den SMS-Posteingang des Telefons und sendet Ihnen die Nachrichten, die in den letzten Stunden eingegangen sind.Das Token des Telefons und eine ganze Zahl für die Stunden. Ohne die Zahl wird die letzte Stunde gelesen.
/sendussdcode <AUTH_TOKEN> <USSD_CODE>Wählt einen USSD-Code auf dem Telefon.Das Token des Telefons und der Code, zum Beispiel *123#. Der Code darf keine Leerzeichen enthalten.
/sendsms <AUTH_TOKEN> <PHONE_NUMBER> <MESSAGE>Sendet eine SMS von der SIM-Karte des Telefons.Das Token des Telefons, die Nummer des Empfängers mit Ländervorwahl und ohne Leerzeichen, dann die Nachricht. Die Nachricht darf Leerzeichen enthalten.

Beispiele #

Telegram
/readallsms <AUTH_TOKEN> 1
/sendussdcode <AUTH_TOKEN> *123#
/sendsms <AUTH_TOKEN> +15615557689 Hello
  • Nach /readallsms antwortet der Bot mit Reading all Sms und sendet dann die Nachrichten einzeln.
  • Nach /sendsms antwortet der Bot mit Sending Sms und der Nummer. Meldet das Telefon, dass die Nachricht gesendet und zugestellt wurde, gibt der Bot diese Meldungen weiter.
  • Nach /sendussdcode antwortet der Bot mit Sending ussd code und dem Code. Der Bot bestätigt nur, dass der Code an das Telefon gesendet wurde.

Fehlerbehebung #

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

Dieser Chat ist nicht angemeldet, oder die Anmeldung ging verloren. Senden Sie erneut /login <API_KEY>.

Invalid API key

Kopieren Sie den Schlüssel erneut aus dem Dashboard. Schreiben Sie den Befehl als /login, ein Leerzeichen, dann den Schlüssel, ohne etwas danach.

You need to enter authtoken and …

Der Befehl hat nicht die richtige Anzahl von Teilen. Prüfen Sie die Tabelle oben: /sendussdcode braucht genau ein Token und einen Code, /sendsms braucht ein Token, eine Nummer und eine Nachricht.

Der Bot bestätigt einen Befehl, aber auf dem Telefon passiert nichts

Prüfen Sie, ob das Token im Befehl dasjenige ist, mit dem sich die SMS-App angemeldet hat, ob die App Connected zeigt und ob sie die SMS- und Telefon-Berechtigungen hat.

Eingehende SMS kommen nicht mehr in Telegram an

Nachrichten werden an den Chat gesendet, der sich mit Ihrem aktuellen API-Schlüssel angemeldet hat. Wenn Sie den API-Schlüssel geändert haben, senden Sie /login mit dem neuen Schlüssel. Prüfen Sie außerdem, ob die SMS-App auf dem Telefon noch verbunden ist.

Das Dashboard meldet „Sie müssen Guthaben kaufen, um diese Funktion zu nutzen.“

Zum Senden von SMS und zum Ausführen von USSD-Codes über das Dashboard ist Guthaben auf Ihrem Konto erforderlich. Siehe Pläne und Guthaben.

Brauchen Sie Hilfe zu dieser Seite? Fragen Sie die Community oder eröffnen Sie ein Support-Ticket.

Support