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