コンテンツへスキップ
Localtonet Localtonet ダッシュボード

SMSボット

このページのヘルプ
このページの内容 7セクション
  1. 仕組み
  2. 始める前に
  3. SMSアプリをセットアップする
  4. ダウンロードしてインストールする
  5. 権限を許可する
  6. トークンでサインインする
  7. Telegramボットにログインする
  8. ボットを開く
  9. APIキーを付けて/loginを送信する
  10. コマンド
  11. 例
  12. トラブルシューティング
  13. 関連ページ

Localtonet SMSアプリは、Androidスマートフォンを、受信したSMSの通知、SMSの送信、USSDコードのダイヤルを行うSMSエンドポイントにします。操作は、TelegramのLocaltonet SMSボットか、ダッシュボードから行えます。

仕組み #

  • Localtonet SMSアプリはAndroidスマートフォンで動作し、AuthTokenでサインインします。
  • Localtonet SMSボットはTelegramのボットです。APIキーでログインすると、スマートフォンに届いたSMSをあなたに転送し、スマートフォンに対するコマンドを受け付けます。
  • ダッシュボードからも、SMSの送信とUSSDコードの実行ができます。プロキシマネージャーのデバイスのSMSタブと、マイトークンのトークンのSMS設定で操作できます。

始める前に #

  • SIMカードを入れたAndroidスマートフォン。SMSアプリはAndroid 5.0以降向けです。
  • そのスマートフォン用のAuthToken。スマートフォンですでにLocaltonetアプリが動作している場合は、同じトークンを使います。ダッシュボードは、トークンを使ってSMSアプリをデバイスに接続します。
  • ご自身のAPIキー。ダッシュボードのAPIキーに表示されます。
  • ボットを使うためのTelegramアカウント。

SMSアプリをセットアップする #

  1. ダウンロードしてインストールする #

    Android用のSMSアプリをlocaltonet.com/download/localtonet-smsapp.zipからダウンロードします。プロキシマネージャーのデバイスのSMSタブにあるSMSアプリをダウンロードも、同じリンクです。アーカイブを展開し、スマートフォンにアプリをインストールします。Androidは、先にこの提供元からのアプリのインストールを許可するよう求めます。

  2. 権限を許可する #

    Localtonet Smsを開きます。アプリは、動作に必要な権限を要求します。

    権限用途
    SMSの送信スマートフォンのSIMカードからメッセージを送信します。
    SMSの読み取り、SMSの受信受信トレイを読み取り、受信したメッセージを通知します。
    電話の発信USSDコードを実行します。アプリがダイヤルします。
    カメラトークンのQRコードをスキャンします。
    通知アプリの動作中に、アプリの通知を表示します。
  3. トークンでサインインする #

    Enter Authtokenにトークンを入力または貼り付けるか、マイトークンのトークンのQRコードをスキャンして、Saveを選びます。アプリには、トークン名、プラン、接続状態が表示されます。ConnectedとListening Smsが表示されれば準備完了です。Wrong Tokenは、トークンが無効であることを示します。Logoutで、アプリからサインアウトします。

アプリは起動したままにしてください。コマンドがスマートフォンに届くのは、SMSアプリが接続されている間だけです。

Telegramボットにログインする #

  1. ボットを開く #

    Telegramでt.me/localtonet_sms_botを開き、チャットを開始します。

  2. APIキーを付けて/loginを送信する #

    Telegram
    /login <API_KEY>

    ボットが、You are now authorized asに続けてアカウントのメールアドレスを返信します。キーが正しくない場合は、Invalid API key.と返信されます。

以降、ボットは、アカウントのスマートフォンに届いたすべてのSMSをこのチャットに送ります。各メッセージには、スマートフォンのトークン名、送信者の番号、本文が表示されます。

APIキーが管理するのはSMSだけでなく、アカウント全体です。/loginは、ボットとのプライベートチャットでのみ送信し、グループでは絶対に送信しないでください。キーが漏えいした場合は、ダッシュボードのAPIキーカードで変更を選んで変更し、新しいキーでもう一度ボットにログインしてください。

コマンド #

/loginにはAPIキーを指定します。そのほかのコマンドには、対象のスマートフォンのAuthTokenを指定します。各部分は、半角スペース1つで区切ります。

コマンド動作引数
/login <API_KEY>このTelegramチャットをアカウントに関連付けます。APIキー。
/helpコマンドの一覧を表示します。なし。
/readallsms <AUTH_TOKEN> <HOURS>スマートフォンのSMS受信トレイを読み取り、直近の数時間に受信したメッセージを送信します。スマートフォンのトークンと、時間数を表す整数。数値を省略すると、直近1時間を読み取ります。
/sendussdcode <AUTH_TOKEN> <USSD_CODE>スマートフォンでUSSDコードをダイヤルします。スマートフォンのトークンとコード(例:*123#)。コードにスペースを含めることはできません。
/sendsms <AUTH_TOKEN> <PHONE_NUMBER> <MESSAGE>スマートフォンのSIMカードからSMSを送信します。スマートフォンのトークン、国番号付きでスペースなしの宛先番号、そしてメッセージ。メッセージにはスペースを含められます。

例 #

Telegram
/readallsms <AUTH_TOKEN> 1
/sendussdcode <AUTH_TOKEN> *123#
/sendsms <AUTH_TOKEN> +15615557689 Hello
  • /readallsmsの後、ボットはReading all Smsと返信し、続けてメッセージを1件ずつ送ります。
  • /sendsmsの後、ボットは番号付きでSending Smsと返信します。スマートフォンがメッセージの送信と配信を報告すると、ボットがその報告を転送します。
  • /sendussdcodeの後、ボットはコード付きでSending ussd codeと返信します。ボットが確認するのは、コードがスマートフォンに送られたことだけです。

トラブルシューティング #

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

このチャットはログインしていないか、ログインが失われています。/login <API_KEY>をもう一度送信してください。

Invalid API key

ダッシュボードからキーをもう一度コピーしてください。コマンドは、/login、スペース1つ、キーの順に書き、その後ろには何も付けないでください。

You need to enter authtoken and …

コマンドの部分の数が正しくありません。上の表を確認してください。/sendussdcodeにはトークンとコードの2つだけ、/sendsmsにはトークン、番号、メッセージが必要です。

ボットはコマンドを確認するが、スマートフォンでは何も起きない

コマンドのトークンが、SMSアプリでサインインしたトークンと同じか、アプリにConnectedと表示されているか、SMSと電話の権限があるかを確認してください。

受信したSMSがTelegramに届かなくなった

メッセージは、現在のAPIキーでログインしたチャットに送られます。APIキーを変更した場合は、新しいキーで/loginを送信してください。また、スマートフォンのSMSアプリが接続されたままであることも確認してください。

ダッシュボードに「この機能を利用するには残高の購入が必要です。」と表示される

ダッシュボードからSMSを送信したりUSSDコードを実行したりするには、アカウントに残高が必要です。プランと残高をご覧ください。

サポート