SMSボット
このページの内容 7セクション
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アプリをセットアップする #
-
ダウンロードしてインストールする #
Android用のSMSアプリをlocaltonet.com/download/localtonet-smsapp.zipからダウンロードします。プロキシマネージャーのデバイスのSMSタブにあるSMSアプリをダウンロードも、同じリンクです。アーカイブを展開し、スマートフォンにアプリをインストールします。Androidは、先にこの提供元からのアプリのインストールを許可するよう求めます。
-
権限を許可する #
Localtonet Smsを開きます。アプリは、動作に必要な権限を要求します。
権限 用途 SMSの送信 スマートフォンのSIMカードからメッセージを送信します。 SMSの読み取り、SMSの受信 受信トレイを読み取り、受信したメッセージを通知します。 電話の発信 USSDコードを実行します。アプリがダイヤルします。 カメラ トークンのQRコードをスキャンします。 通知 アプリの動作中に、アプリの通知を表示します。 -
トークンでサインインする #
Enter Authtokenにトークンを入力または貼り付けるか、マイトークンのトークンのQRコードをスキャンして、Saveを選びます。アプリには、トークン名、プラン、接続状態が表示されます。ConnectedとListening Smsが表示されれば準備完了です。Wrong Tokenは、トークンが無効であることを示します。Logoutで、アプリからサインアウトします。
アプリは起動したままにしてください。コマンドがスマートフォンに届くのは、SMSアプリが接続されている間だけです。
Telegramボットにログインする #
-
ボットを開く #
Telegramでt.me/localtonet_sms_botを開き、チャットを開始します。
-
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を送信します。 | スマートフォンのトークン、国番号付きでスペースなしの宛先番号、そしてメッセージ。メッセージにはスペースを含められます。 |
例 #
/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コードを実行したりするには、アカウントに残高が必要です。プランと残高をご覧ください。