Состояние телефона, статистика доставки и ограничения на отправку видны в кабинете, история сообщений: в приложении. Здесь же собрано, что проверять, когда шлюз не работает.
#Данные устройства
В разделе SMS для каждого привязанного устройства:
| Поле | Что показывает |
|---|---|
| Модель | Производитель и модель телефона |
| Версия Android | Например, Android 14 |
| Версия приложения | Текущая версия SMS Gateway |
| Батарея | Уровень заряда |
| Сеть | Wi-Fi или мобильные данные |
| Память | Свободная оперативная память |
| Хранилище | Свободное место |
| SIM-карты | Оператор, страна, слот |
| Последний heartbeat | Когда устройство отчиталось в последний раз |
| Отправлено SMS | Счётчик исходящих |
| Получено SMS | Счётчик входящих |
Как обновляются эти данные: Надёжность: heartbeat.
#Статистика доставки
Для каждого SMS-канала:
| Метрика | Значение |
|---|---|
| Процент доставки | Доля доставленных SMS от отправленных |
| Среднее время доставки | От отправки до подтверждения оператором |
| Разбивка по дням | График отправленных SMS за период |
#Ограничения на отправку
Ограничения задаются на устройство и защищают от случайной массовой рассылки. Они проверяются перед каждой отправкой: если лимит исчерпан, SMS не уйдёт, а в логах появится ошибка.
#Лимиты
| Ограничение | Что задаёт | Пример |
|---|---|---|
| Дневной лимит | Максимум SMS в сутки | 100 |
| Месячный лимит | Максимум SMS в месяц | 2 000 |
| Лимит на получателя | Максимум SMS одному номеру за период | 3 за 60 минут |
| Длина сообщения | Максимум символов в тексте | 480 |
#Страны и номера
| Ограничение | Что задаёт | Пример |
|---|---|---|
| Разрешённые страны | Отправка только на номера с указанными префиксами | +7 (Россия), +375 (Беларусь) |
| Заблокированные номера | На эти номера SMS не отправляются никогда | +79001234567 |
#Настроить
- Откройте SMS в кабинете.
- Выберите устройство.
- Нажмите «Настройки».
- Задайте ограничения.
- Нажмите «Сохранить».
#События для вебхуков
Шлюз генерирует события, которые можно получать через Event Webhooks:
| Событие | Когда |
|---|---|
SMS_DEVICE_CONNECTED | Устройство привязано к аккаунту |
SMS_DEVICE_DISCONNECTED | Устройство отвязано или потерян push-токен |
SMS_STATUS_CHANGED | Статус SMS изменился, например с «отправлено» на «доставлено» |
SMS_SENT | Новое SMS поставлено в очередь на отправку |
#Частые проблемы
#Устройство офлайн
Проверьте по порядку:
- интернет на телефоне включён и работает;
- приложение tuk-tuk запущено;
- телефон заряжен;
- sticky-уведомление включено в настройках приложения;
- приложение исключено из оптимизации батареи, см. Надёжность.
#SMS не отправляются
- на SIM-карте есть средства на SMS;
- дневной и месячный лимиты не исчерпаны;
- номер получателя входит в разрешённые страны;
- номер не в списке заблокированных;
- оператор не ограничивает массовую отправку SMS.
#Входящие не приходят
- переключатель «Приём SMS» в приложении включён;
- приложению разрешено читать и получать SMS;
- фильтры входящих не отсекают нужный номер, см. Возможности: фильтры.
#QR-код не сканируется
- код действует 10 минут, обновите страницу в кабинете;
- приложению разрешён доступ к камере;
- на экран падает достаточно света.
#Обновление приложения
Приложение само проверяет наличие новой версии и предлагает обновиться.