SMS-бот
На этой странице 7 разделов
SMS-приложение Localtonet превращает телефон Android в конечную точку SMS: оно сообщает о входящих SMS, отправляет SMS и набирает USSD-коды. Управлять им можно из Telegram с помощью SMS-бота Localtonet или из панели управления.
Как это работает #
- SMS-приложение Localtonet работает на телефоне Android и входит в систему с помощью AuthToken.
- SMS-бот Localtonet — это бот Telegram. После входа с вашим ключом API он присылает вам SMS, приходящие на ваши телефоны, и принимает команды для них.
- Из панели управления тоже можно отправлять SMS и выполнять USSD-коды: на вкладке SMS устройства в Менеджере прокси и в разделе Настройки SMS токена в Мои токены.
Перед началом #
- Телефон Android с SIM-картой. SMS-приложение рассчитано на Android 5.0 и новее.
- AuthToken для этого телефона. Если приложение Localtonet уже работает на телефоне, используйте тот же токен: панель управления связывает SMS-приложение с устройством по его токену.
- Ваш ключ API. Он показан на Панели управления в карточке Ключ API.
- Аккаунт Telegram, чтобы пользоваться ботом.
Настройка SMS-приложения #
-
Скачайте и установите #
Скачайте SMS-приложение для Android по ссылке 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 #
-
Откройте бот #
Откройте t.me/localtonet_sms_bot в Telegram и начните чат.
-
Отправьте /login с вашим ключом API #
Telegram/login <API_KEY>Бот отвечает You are now authorized as и адресом электронной почты вашего аккаунта. На неверный ключ он отвечает Invalid API key.
С этого момента бот присылает в этот чат каждое SMS, которое приходит на телефон вашего аккаунта. В каждом сообщении указаны имя токена телефона, номер отправителя и текст.
Ключ API управляет всем вашим аккаунтом, а не только SMS. Отправляйте /login только в личном чате с ботом, никогда в группе. Если ключ утёк, смените его на Панели управления кнопкой Сменить в карточке Ключ API и снова войдите в бот с новым ключом.
Команды #
/login принимает ваш ключ API. Остальные команды принимают AuthToken телефона, для которого они предназначены. Разделяйте части одиночными пробелами.
| Команда | Что делает | Аргументы |
|---|---|---|
/login <API_KEY> | Связывает этот чат Telegram с вашим аккаунтом. | Ваш ключ API. |
/help | Показывает список команд. | Нет. |
/readallsms <AUTH_TOKEN> <HOURS> | Читает входящие SMS телефона и присылает вам сообщения, полученные за последние часы. | Токен телефона и целое число часов. Если число не указано, читается последний час. |
/sendussdcode <AUTH_TOKEN> <USSD_CODE> | Набирает USSD-код на телефоне. | Токен телефона и код, например *123#. Код не должен содержать пробелов. |
/sendsms <AUTH_TOKEN> <PHONE_NUMBER> <MESSAGE> | Отправляет SMS с SIM-карты телефона. | Токен телефона, номер получателя с кодом страны и без пробелов, затем сообщение. Сообщение может содержать пробелы. |
Примеры #
/readallsms <AUTH_TOKEN> 1
/sendussdcode <AUTH_TOKEN> *123#
/sendsms <AUTH_TOKEN> +15615557689 Hello- После
/readallsmsбот отвечает Reading all Sms и затем присылает сообщения по одному. - После
/sendsmsбот отвечает Sending Sms с номером. Когда телефон сообщает, что сообщение отправлено и доставлено, бот пересылает эти отчёты. - После
/sendussdcodeбот отвечает Sending ussd code с кодом. Бот лишь подтверждает, что код отправлен на телефон.
Устранение неполадок #
You need to authorize first. Use /login <apikey>
Этот чат не авторизован, либо вход был потерян. Отправьте /login <API_KEY> ещё раз.
Invalid API key
Скопируйте ключ с Панели управления ещё раз. Пишите команду как /login, один пробел, затем ключ, без ничего после него.
You need to enter authtoken and …
В команде неверное число частей. Сверьтесь с таблицей выше: /sendussdcode требует ровно токен и код, /sendsms требует токен, номер и сообщение.
Бот подтверждает команду, но на телефоне ничего не происходит
Проверьте, что токен в команде совпадает с тем, с которым вошло SMS-приложение, что приложение показывает Connected и что у него есть разрешения на SMS и телефонные звонки.
Входящие SMS перестали приходить в Telegram
Сообщения отправляются в чат, который вошёл с вашим текущим ключом API. Если вы меняли ключ API, отправьте /login с новым ключом. Также проверьте, что SMS-приложение на телефоне по-прежнему подключено.
Панель управления пишет: «Чтобы пользоваться этой функцией, пополните баланс.»
Для отправки SMS и выполнения USSD-кодов из панели управления на вашем аккаунте нужен Баланс. См. Тарифы и баланс.