---
title: Настройка каскада в умном шлюзе
description: Каскад в умном шлюзе — правила, таймауты, статусы успеха
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

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

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

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

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

## Что это

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

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

| Параметр | Что означает |
|---|---|
| channel | Номер канала (1 = SMS, 2 = RCS, 4 = WhatsApp) |
| senderId | Имя отправителя |
| successOn | Статус успеха (sent, delivered, seen) |
| timeout | Время ожидания статуса в секундах |
| payload | Содержимое сообщения |

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

| Статус | Что означает |
|---|---|
| sent | Сообщение отправлено провайдеру |
| delivered | Сообщение доставлено на устройство |
| seen | Сообщение просмотрено |

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

## Таймауты

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

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

| Канал | Таймаут |
|---|---|
| WhatsApp | 10–20 минут |
| SMS | 5–15 минут |
| RCS | 10–20 минут |
| Viber | 10–20 минут |

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

**Цепочка:** 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** — оптимизируйте по данным.

## Что дальше

- [Правила доставки](/02-otp/02-smart-gateway/otp-204-delivery-rules)
- [Получение статусов через вебхуки](/02-otp/02-smart-gateway/otp-205-status-webhooks)
- [Обработка ошибок умного шлюза](/02-otp/02-smart-gateway/otp-206-errors)

## См. также

- [Как работает умный шлюз](/02-otp/02-smart-gateway/otp-201-how-gateway-works)
- [Первый запрос через умный шлюз](/02-otp/02-smart-gateway/otp-202-first-request)
- [Что такое каскад](/05-channels/00-overview/cascade)

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

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