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

Коротко: каскад настраивается в запросе. Вы указываете каналы, таймауты и статусы успеха — платформа сама переключает.

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

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

Что это

Каскад — последовательность каналов, по которым отправляется сообщение. Если один канал не дал результата — платформа переключается на следующий.

Что настраивается для каждого канала

Статусы успеха

Важно: статус seen применим не для всех каналов. Например, для SMS его нет.

Таймауты

Таймаут — время, в течение которого платформа ждёт статус успеха. Если статус не получен — переход на следующий канал.

Рекомендуемые значения:

Пример каскада

Цепочка: WhatsApp → SMS → TTS

Правила:

1. WhatsApp:
   • successOn: delivered
   • timeout: 600 секунд (10 минут)
2. SMS:
   • successOn: delivered
   • timeout: 900 секунд (15 минут)
3. TTS:
   • successOn: delivered
   • timeout: 1800 секунд

Мгновенный переход

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

Что важно

• Таймауты задаются в секундах.
• Максимальный таймаут — 259 200 секунд (72 часа).
• Минимальный таймаут — обычно 60 секунд.
• Порядок каналов — важен. Дешёвый канал первым.

Оптимизация

1. Начните с дешёвого канала.
2. Ставьте реалистичные таймауты.
3. Не делайте цепочку слишком длинной. 3–4 канала достаточно.
4. Следите за статусами в EDR — оптимизируйте по данным.

Что дальше

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

См. также

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

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

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