Каналы связи

SMS-шлюз

Кратко

SMS-шлюз отправляет и принимает SMS через Android-телефон с SIM-картой и приложением tuk-tuk. SMS-провайдер не нужен, оплата по тарифу оператора; статусы доставки видны в диалогах.

  • Путь в кабинете: Каналы связи → Подключить → SMS → выбрать привязанное устройство → Сохранить.
  • Предусловия: Android-телефон с SIM-картой, приложение tuk-tuk (APK из раздела «SMS» кабинета) с разрешениями на SMS и уведомления, привязка по QR-коду.
  • QR-код привязки действует 10 минут и одноразовый.
  • Статусы SMS: Pending, Sent, Delivered, Failed, Received.
  • Лимиты в настройках устройства: в день, в месяц, разрешённые страны, заблокированные номера, максимальная длина.
  • Оплата SMS по тарифу оператора; операторы обычно ограничивают 100–200 SMS в день. Телефон должен быть постоянно в сети.
На этой странице

SMS-шлюз отправляет и принимает SMS через обычный Android-телефон с SIM-картой. Платный SMS-провайдер не нужен: вы платите только оператору по своему тарифу. Телефон с приложением tuk-tuk лежит на столе и отправляет SMS, когда оператор, цепочка или AI нажимает «Отправить» в кабинете.

SMS через свой телефон: шлюз на Android

#Когда это нужно

  • Отправлять клиентам SMS-уведомления без SMS-провайдера.
  • Принимать входящие SMS и обрабатывать их в общем разделе «Диалоги».
  • Автоматизировать SMS-рассылки через цепочки.

#Как это работает

text
Вы нажимаете                                      Клиент
«Отправить»                                       получает
в tuk-tuk.online                                  SMS
      │                                             ▲
      ▼                                             │
  ┌────────┐    push-уведомление    ┌──────────┐    │
  │ Сервер │ ───────────────────→  │ Android  │ ───┘
  │        │ ← отчёт о доставке ── │ телефон  │
  └────────┘                        └──────────┘
  1. Оператор или цепочка отправляет SMS из tuk-tuk.online.
  2. Сервер шлёт push-уведомление на Android-телефон.
  3. Телефон отправляет SMS через SIM-карту, как обычное сообщение.
  4. Телефон возвращает серверу отчёт: «Доставлено» или «Ошибка».

Входящие SMS идут тем же путём в обратную сторону.

#Как подключить

#Установить приложение

  1. Откройте раздел SMS в кабинете.
  2. Скачайте Android-приложение tuk-tuk (APK-файл).
  3. Установите его на телефон.
  4. Разрешите приложению отправлять SMS и получать уведомления.

#Привязать телефон

  1. На экране SMS в кабинете найдите QR-код.
  2. Откройте приложение на телефоне и нажмите «Сканировать QR-код».
  3. Наведите камеру на QR-код на экране компьютера: телефон появится в списке устройств кабинета.

#Создать SMS-канал

Создание SMS-канала и привязка телефона
  1. Название канала.

  2. Кнопка «Подключить»: после создания у канала появится QR-код для приложения Тук-Тук на Android.

  3. Откройте Каналы связи.

  4. Нажмите «Подключить» на карточке SMS.

  5. Выберите привязанное устройство из списка.

  6. Нажмите «Сохранить»: канал появится в списке со статусом «Активен».

#Что умеет

#Статусы SMS

Статус каждого сообщения обновляется в реальном времени.

СтатусЧто это значит
В очереди (Pending)Сообщение ждёт отправки
Отправлено (Sent)Телефон отправил SMS
Доставлено (Delivered)Оператор связи подтвердил доставку
Ошибка (Failed)Отправить не удалось
Получено (Received)Входящее SMS

#Лимиты и защита от случайных рассылок

Задаются в настройках устройства.

ПараметрЧто это
Лимит в деньМаксимум SMS в сутки (например, 100)
Лимит в месяцМаксимум SMS в месяц
Разрешённые страныОтправка только в выбранные страны
Заблокированные номераНа эти номера SMS не уходят никогда
Максимальная длина сообщенияОграничение длины текста SMS

#Информация об устройстве

В кабинете видно состояние телефона:

  • модель и производитель;
  • уровень заряда батареи;
  • тип подключения: Wi-Fi или мобильный интернет;
  • данные SIM-карты;
  • время последнего «пульса» (heartbeat);
  • счётчики отправленных и полученных SMS.

Подробнее о приложении: SMS Gateway (Android).

#Ограничения

  • Телефон должен быть постоянно в сети: Wi-Fi или мобильный интернет.
  • SMS оплачиваются по тарифу вашего оператора.
  • Операторы ограничивают число SMS в день, обычно 100–200.
  • Если телефон уснул или потерял связь, сервер попробует его разбудить.

#Частые проблемы

ПроблемаЧто делать
Телефон офлайнПроверьте интернет на телефоне и что приложение tuk-tuk открыто
SMS не отправляетсяПроверьте баланс SIM-карты и лимиты оператора
Входящие SMS не приходятУбедитесь, что приложению разрешён доступ к SMS
QR-код не сканируетсяОбновите страницу: QR-код мог истечь (10 минут)