---
title: Что такое каскад
description: Каскад — автоматическое переключение между каналами при недоставке сообщения
---
> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.mydialogi.ru/llms.txt). Append `.md` to any page URL for its markdown version.
> **Коротко:** каскад — способ рассылки, при котором сообщение перенаправляется на альтернативный канал, если не доставлено по исходному.
## Кому подходит
- Роль: Клиент, Менеджер рассылок
- Уровень: Новичок
## Что это
Когда вы отправляете сообщение, оно может не дойти до получателя — например, номер неактивен или оператор вернул ошибку. Каскад автоматически перенаправляет сообщение на следующий канал в цепочке.
**Пример:** сначала WhatsApp → если не доставлено за 10 минут → TTS → если не доставлено → SMS.
## Как работает
1. **Настройте цепочку каналов.** Добавьте каналы по порядку — от основного к резервным.
2. **Задайте статус ожидания и таймаут для каждого канала.** Статус — при каком статусе сообщение считается доставленным. Таймаут — сколько ждать статус до переключения.
3. **Система отправляет сообщение по первому каналу.**
4. **Ожидает статус.** Если нужный статус не получен за таймаут — переключается на следующий канал.
5. **Продолжает до доставки или конца цепочки.**
Если получен статус, что абонент недоступен, не существует или отклонил сообщение, fallback на следующий канал происходит **немедленно** — не дожидаясь таймаута.
## Что настраивается для каждого канала
| Параметр | Что означает | Возможные значения |
|---|---|---|
| **Статус ожидания** | При каком статусе сообщение считается доставленным | Отправлено, Доставлено, Просмотрено |
| **Таймаут** | Сколько ждать статус до переключения на следующий канал | По умолчанию **1200 сек** (20 мин), максимум **259200 сек** (3 дня) |
| **Cooldown** | Время блокировки контакта при неудаче | Максимум **86400 сек** (1 день) |
| **Send next after fail** | Отправлять ли следующее сообщение, если после успеха получен статус `failed` | Да / Нет |
## Что даёт каскад
Если один канал не сработал — сообщение уйдёт по следующему. Больше сообщений доходит.
Сначала идёт дешёвый канал, дорогой — только как резерв.
Платформа переключает каналы без вашего участия.
Списывается только за фактически доставленный канал.
## Как тарифицируется каскад
**SMS тарифицируется за отправку** — за каждый сегмент.
**Остальные каналы тарифицируются за доставку.** Если сообщение не доставлено — например, у получателя не установлено приложение или его нет в нужной соцсети или мессенджере — **за это сообщение деньги не списываются**.
В каскаде **списание происходит только один раз** — по тому каналу, через который сообщение фактически доставлено.
Это значит: каскад не увеличивает расходы. Даже если сообщение прошло по нескольким каналам, вы платите только за доставленный.
## Как настроить каскад
### Мой диалог
#### 1. Выберите тип «Каскад»
При создании рассылки выберите тип **Каскад**.
#### 2. Добавьте каналы в цепочку
Нажмите **+ Добавить шаг** и выберите канал.
#### 3. Настройте каждый канал
Настройте сообщение, выберите статус ожидания и укажите таймаут.
#### 4. Сохраните рассылку
Нажмите **Сохранить**.
[Как создать рассылку в Мой диалог →](https://docs.mydialogi.ru/04-mydialogi/02-broadcasts/md-401-create-broadcast)
### Multi API
Каскад настраивается через API — в запросе передаётся массив `messages` с каналами.
#### 1. Сформируйте запрос
Используйте эндпоинт `/omnimessages` — для одного получателя, или `POST /broadcast/broadcasts` с `payload.contentSettings.flowSteps` — для массовой рассылки.
#### 2. Укажите каналы и условия
Для каждого шага задайте `channel`, `senderId`, `successOn`, `timeout`.
#### 3. Отправьте запрос
Платформа начнёт каскадную отправку и будет переключать каналы по правилам.
[Настройка каскада в Multi API →](https://docs.mydialogi.ru/03-multiapi/03-channels/mapi-203-cascade)
[Broadcasts API — рассылки →](https://docs.mydialogi.ru/03-multiapi/02-api/mapi-105-broadcasts-api)
### OTP-коды
Каскад настраивается в режиме **Умный шлюз** — вы передаёте правила в запросе.
[Настройка каскада в умном шлюзе →](https://docs.mydialogi.ru/02-otp/02-smart-gateway/otp-203-cascade-rules)
## Рекомендуемые цепочки
| Задача | Цепочка |
|---|---|
| **OTP-код** | Telegram Gateway → Viber → WhatsApp → TTS → SMS |
| **Маркетинг** | RCS → Viber → WhatsApp → Mobile Push → SMS |
| **Транзакция** | RCS → Viber → WhatsApp → Mobile Push → SMS |
| **Сервисные** | RCS → Viber → WhatsApp → Mobile Push → TTS → SMS |
Рекомендуемые цепочки зависят от страны получателя: доступность каналов, скорость доставки и стоимость различаются по регионам. Для конкретной страны подбирайте цепочку с учётом этих особенностей.
## Частые проблемы
### Каскад не переключается
**Причина:** не задан таймаут.
**Решение:** проверьте настройки каждого шага — таймаут должен быть указан.
[Как настроить каскад →](#как-настроить-каскад)
### Переключается слишком рано
**Причина:** слишком маленький таймаут.
**Решение:** увеличьте значение таймаута.
[Как настроить каскад →](#как-настроить-каскад)
### Сообщение дублируется
**Причина:** неверно выбран статус ожидания.
**Решение:** проверьте статус — например, для SMS обычно используется **Доставлено**.
### Каскад не работает
**Причина:** нет доступа к каналу.
**Решение:** проверьте имя отправителя для каждого канала в цепочке.
[Что такое имя отправителя →](https://docs.mydialogi.ru/06-reference/05-sender-id-overview)
## См. также
14 каналов и доступность по сервисам
Какой канал подходит для вашей задачи
Рассылка с каскадом в личном кабинете
Через `/omnimessages` и Broadcasts API
Настройка в OTP-кодах
## Нужна помощь?
- **OTP-коды:** support@otpcod.ru
- **Multi API:** support@multiapi.ru
- **Мой диалог:** support@mydialogi.ru