Три действия: установить APK, выдать разрешения, отсканировать QR-код из кабинета. После этого создаётся SMS-канал, и телефон начинает работать как шлюз.
#Установить приложение
- Откройте раздел SMS в кабинете.
- Нажмите «Скачать APK».
- Перенесите файл на телефон (или скачайте прямо с телефона) и откройте его.
Результат: приложение tuk-tuk установлено.
#Разрешить установку из неизвестных источников
- Откройте Настройки → Безопасность (на части телефонов: Приложения).
- Найдите пункт «Неизвестные источники» или «Установка из неизвестных приложений».
- Разрешите установку для браузера или файлового менеджера, из которого открываете APK.
#Выдать разрешения
При первом запуске приложение запросит разрешения. Без них шлюз не работает.
| Разрешение | Зачем |
|---|---|
| Отправка SMS | Отправлять SMS клиентам |
| Чтение SMS | Перехватывать входящие SMS |
| Приём SMS | Получать уведомления о новых SMS |
| Состояние телефона | Определять SIM-карты и оператора |
| Уведомления | Показывать статус работы (Android 13 и новее) |
#Привязать телефон по QR-коду
Привязка соединяет телефон с аккаунтом tuk-tuk.online. Делается один раз.
- На компьютере откройте SMS и нажмите «Привязать устройство». На экране появится QR-код.
- На телефоне откройте приложение tuk-tuk и нажмите «Сканировать QR-код».
- Наведите камеру на QR-код на экране компьютера.
- Дождитесь подтверждения: на экране телефона появится Device ID.
#Что в QR-коде
| Параметр | Значение |
|---|---|
| Токен привязки | Уникальный код из 64 символов |
| Срок действия | 10 минут |
| Использование | Одноразовое |
| Адрес сервера | URL API для подключения |
#Что происходит при привязке
- Телефон отправляет на сервер токен из QR-кода, модель устройства, версию ОС и push-токен.
- Сервер проверяет токен и привязывает устройство к аккаунту.
- Телефон получает Device ID и API-ключ и сохраняет их.
- Шлюз включается автоматически.
#Проверить, что работает
После привязки на главном экране приложения:
| Элемент | Что показывает |
|---|---|
| Device ID | Идентификатор устройства, можно скопировать |
| API Key | Ключ авторизации, можно скопировать |
| Статус шлюза | Главный переключатель Вкл./Выкл. |
| Имя устройства | Произвольное название |
#Создать SMS-канал
- Откройте Каналы связи.
- Нажмите «Подключить» на карточке SMS.
- Выберите привязанное устройство из списка.
- Нажмите «Сохранить».
Результат: SMS проходят через канал и появляются в диалогах. Настройки канала описаны на странице SMS-шлюз.
