SMS Gateway (Android)

Возможности приложения

Кратко

Функции Android-приложения SMS Gateway: отправка SMS по push-команде со статусами доставки, приём входящих с защитой от дублей и фильтрами по номеру, выбор SIM-карты, история сообщений.

  • Отправка: push (FCM) от сервера, длинный текст делится по 160–170 символов, статусы: В очереди, Отправлено, Доставлено, Ошибка. Повтор push до 3 раз.
  • Приём включается переключателем «Приём SMS» в приложении.
  • Дедупликация: MD5 из текста, отправителя и времени, окно 5 секунд.
  • Фильтры входящих по номеру: точное совпадение, начинается с, заканчивается на, содержит. Без фильтров передаются все SMS.
  • Выбор SIM: слот из задания сервера, затем настройка приложения, затем SIM по умолчанию в Android.
  • История в приложении: тип, номер, текст, время, статус; фильтры Все, Исходящие, Входящие; записи старше 30 дней удаляются.
На этой странице

Что приложение делает с SMS помимо отправки: принимает входящие, работает с двумя SIM-картами, фильтрует номера, отсекает дубли и хранит историю.

#Отправка SMS

Когда оператор или AI-ассистент отправляет SMS через tuk-tuk.online:

  1. Сервер отправляет push-уведомление (FCM) на телефон.
  2. Приложение получает push и формирует SMS.
  3. Длинный текст делится на части по 160–170 символов.
  4. Телефон отправляет SMS через SIM-карту как обычное сообщение.
  5. Приложение возвращает серверу статус: отправлено, доставлено или ошибка.
СтатусЗначение
В очередиСообщение ждёт отправки на телефоне
ОтправленоТелефон отправил SMS
ДоставленоОператор связи подтвердил доставку
ОшибкаОтправка не удалась: баланс SIM, номер, оператор

#Приём входящих SMS

Приложение перехватывает входящие SMS и передаёт их на сервер. Оттуда они попадают в диалог с клиентом.

#Включить приём

  1. Откройте приложение tuk-tuk на телефоне.
  2. Включите переключатель «Приём SMS».

Результат: следующее входящее SMS появится в диалогах.

#Защита от дублей

Android иногда отдаёт одно SMS дважды. Приложение считает MD5-отпечаток из текста, отправителя и времени; если SMS с таким отпечатком уже было в последние 5 секунд, оно игнорируется.

#Фильтры входящих

Фильтры проверяют номер отправителя. Если фильтров нет, на сервер уходят все входящие SMS.

ТипКак работаетПример
Точное совпадениеНомер совпадает целиком+79001234567
Начинается сНомер начинается с указанной строки+7900
Заканчивается наНомер заканчивается указанной строкой4567
СодержитНомер содержит подстроку123

#Две SIM-карты

Если в телефоне две SIM-карты, приложение выбирает слот для отправки в таком порядке:

ПриоритетИсточник
1Задание с сервера, если в нём указан SIM-слот
2SIM, выбранная в настройках приложения
3SIM по умолчанию в Android

Выбрать SIM в приложении: раздел «SIM-карта». Закрепить конкретную SIM за каналом: в настройках SMS-канала в кабинете, см. SMS-шлюз.

О каждой SIM приложение передаёт на сервер оператора (МТС, Билайн, Мегафон), страну (RU, BY, KZ), код MCC/MNC (например, 250/01) и слот (SIM 1 или SIM 2).

#История SMS

Экран истории в приложении показывает все SMS, прошедшие через шлюз.

КолонкаСодержимое
ТипИсходящее или входящее
НомерТелефон получателя или отправителя
ТекстСодержание сообщения
ВремяКогда отправлено или получено
СтатусВ очереди, Отправлено, Доставлено, Ошибка

Фильтры: Все, Исходящие, Входящие. Сверху экрана счётчики: Всего, Отправлено, Доставлено, Ошибки, В очереди.