Ограничения MVP¶
Страница для интегратора: чего хаб пока не умеет и что ещё уточняется у оператора связи. Список честный: лучше прочитать его сейчас, чем упереться в ограничение на выкате.
Дата последнего обновления — 2026-09-25.
Не поддерживается¶
| Что | Как проявляется | Почему |
|---|---|---|
Отложенная отправка (send_at) |
422 send_at_not_supported на любое значение — и в одиночной отправке, и в элементе пакета |
параметры планирования у оператора документацией не подтверждены, а гадать в вопросе «когда именно уйдёт сообщение» нельзя |
Рекламный класс (marketing) и свободный текст |
422 class_not_enabled: с param: class — на class: marketing, с param: text — на поле text в сообщении класса otp или service (им нужен шаблон; свободный текст есть только у marketing) |
объявлен в контракте, включается в третьей фазе — вместе с проверкой согласия и окном тишины |
| Входящие сообщения абонента | публичного API нет | принимаются и складываются с первого дня; наружу пока не отдаются |
Коды объявлены в контракте заранее намеренно: их появление позже было бы
ломающим изменением, а так интегратор пишет обработку один раз. Это касается и
кодов, которые сейчас не выдаются вовсе: send_at_in_past, send_at_too_far
(отложенная отправка), consent_required, marketing_window_violation
(рекламный класс).
Уточняется у оператора¶
Каждый пункт — открытый вопрос, а не забытая функция.
| Вопрос | Состояние |
|---|---|
| Гарантии по отчётам о доставке (SLA) | оператор их не обещает; хаб сам добирает статусы сверкой и закрывает молчащие по сроку жизни |
| Предел скорости отправки (TPS) | известен по факту: превышение приходит кодом 408, хаб на него снижает темп рассылок вдвое на минуту; одноразовые коды не замедляются никогда |
| Короткий номер для входящих и слово отписки | принимаем «СТОП», «STOP», «ОТПИСКА», «ОТПИСАТЬСЯ»; номер согласуется |
| Тарифная сетка | одна ставка на группу; расхождения со счётом оператора сверяются вручную |
| Песочница оператора | своей у оператора нет; тестовый режим полностью на нашей стороне |
| Предел опроса статусов | не документирован; сверка идёт с ограничением по темпу с нашей стороны |
Что это значит для интеграции¶
- Не рассчитывайте на мгновенный
delivered. Отчёт приходит асинхронно и может не прийти вовсе: тогда сообщение закроется по сроку жизни с причиной, говорящей, что доставка не подтверждена и не опровергнута. - Не переотправляйте одноразовые коды автоматически. Абонент, получивший два кода подряд, вводит первый.
- Планируйте рассылку с запасом. Темп ограничен и оператором, и нашим суточным пределом; тысяча сообщений уходит не мгновенно.