Правила доставки в умном шлюзе

Коротко: правила доставки определяют, когда сообщение считается успешно доставленным и что делать при неудаче.

Кому подходит

• Роль: Разработчик
• Уровень: Опытный

Три ключевых правила

1. successOn

Что считается успехом:

Рекомендация: для OTP используйте delivered — это гарантирует, что код дошёл.

2. timeout

Сколько ждать статус успеха. Если истёк — переход на следующий канал.

Рекомендация: для WhatsApp 600 секунд, для SMS 900 секунд.

3. cooldown

Время блокировки контакта при неудаче. Если все каналы не сработали — контакт блокируется на указанное время.

Рекомендация: для OTP используйте cooldown 3600 секунд.

Как правила работают вместе

1. Платформа отправляет сообщение по первому каналу.
2. Ждёт статус successOn в течение timeout.
3. Если статус получен — успех.
4. Если не получен — переход на следующий канал.
5. Если все каналы исчерпаны — контакт блокируется на cooldown.

Пример настройки

Для OTP-кода:

• successOn: delivered
• timeout: 600 секунд
• cooldown: 3600 секунд

Что это значит:

• Ждём доставку 10 минут.
• Если не доставлено — переход на следующий канал.
• Если все каналы исчерпаны — блокируем контакт на 1 час.

Специальные случаи

Немедленный переход

Если статус — «абонент недоступен», «номер не существует», «отклонено» — платформа не ждёт таймаут, а сразу переключается на следующий канал.

Успех по первому каналу

Если первый канал дал статус delivered сразу — платформа не отправляет по остальным каналам.

Что важно

• Все правила — в запросе. Не в интерфейсе.
• Правила применяются ко всей цепочке.
• Можно задать разные правила для разных каналов.

Что дальше

• Получение статусов через вебхуки
• Обработка ошибок умного шлюза
• Настройка каскада

См. также

• Первый запрос через умный шлюз
• Как работает умный шлюз

Нужна помощь?

• OTP-коды: support@otpcod.ru