Перейти к содержимому
Localtonet Localtonet Панель управления

SMS-бот

Помощь по этой странице
На этой странице 7 разделов
  1. Как это работает
  2. Перед началом
  3. Настройка SMS-приложения
  4. Скачайте и установите
  5. Выдайте разрешения
  6. Войдите с помощью токена
  7. Вход в бот Telegram
  8. Откройте бот
  9. Отправьте /login с вашим ключом API
  10. Команды
  11. Примеры
  12. Устранение неполадок
  13. Связанные страницы

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-приложения #

  1. Скачайте и установите #

    Скачайте SMS-приложение для Android по ссылке 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. Откройте бот #

    Откройте t.me/localtonet_sms_bot в Telegram и начните чат.

  2. Отправьте /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-карты телефона.Токен телефона, номер получателя с кодом страны и без пробелов, затем сообщение. Сообщение может содержать пробелы.

Примеры #

Telegram
/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-кодов из панели управления на вашем аккаунте нужен Баланс. См. Тарифы и баланс.

Поддержка