---
title: Правила доставки в умном шлюзе
description: Правила доставки — successOn, timeout, cooldown
---

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

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

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

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

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

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

### 1. successOn

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

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

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

### 2. timeout

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

| Единица | Значение |
|---|---|
| Секунды | От 60 до 259 200 |
| Типичное значение | 600–900 секунд |

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

### 3. cooldown

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

| Единица | Значение |
|---|---|
| Секунды | До 86 400 (24 часа) |
| Типичное значение | 3600 (1 час) |

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

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

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

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

**Для OTP-кода:**

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

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

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

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

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

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

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

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

## Что важно

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

## Что дальше

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

## См. также

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

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

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