Перейти до вмісту
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. Застосунок запитує дозволи, з якими працює:

    ДозвілНавіщо потрібен
    Send SMSНадсилати повідомлення з SIM-картки телефона.
    Read SMS, receive SMSЧитати вхідні й повідомляти про вхідні повідомлення.
    Phone callsВиконувати USSD-коди. Застосунок набирає їх.
    CameraСканувати QR-код токена.
    NotificationsПоказувати сповіщення застосунку, поки він працює.
  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-кодів із панелі керування потрібен баланс на вашому обліковому записі. Дивіться Тарифи та баланс.

Підтримка