---
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.

# Обработка ошибок умного шлюза

> **Коротко:** умный шлюз возвращает HTTP-коды и текстовые ошибки. Большинство решается проверкой параметров.

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

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

## Основные ошибки

### 400 Bad Request

**Причина:** неверные параметры запроса.

**Решения:**

1. Проверьте формат JSON.
2. Проверьте обязательные поля: contact, messages.
3. Проверьте типы значений.
4. Проверьте формат номера.

### 401 Unauthorized

**Причина:** неверный API-ключ.

**Решения:**

1. Проверьте заголовок X-API-Key.
2. Проверьте, что ключ активен.
3. Проверьте, что ключ от OTP-сервиса.

### 404 Not Found

**Причина:** неверный URL.

**Решения:**

1. Проверьте базовый URL: web.otpcod.ru/api/v1.
2. Проверьте эндпоинт: /omnimessages.

### 500 Internal Server Error

**Причина:** ошибка на стороне сервера.

**Решения:**

1. Повторите запрос через 30 секунд.
2. Сохраните requestId.
3. Обратитесь в поддержку.

## Ошибки в каскаде

### Invalid senderId

**Причина:** имя отправителя не найдено или неактивно.

**Решения:**

1. Проверьте статус имени отправителя.
2. Проверьте, что имя указано в ключе.
3. Дождитесь одобрения, если статус не «Активно».

### Invalid channel

**Причина:** указан неподдерживаемый номер канала.

**Решения:**

1. Проверьте список каналов.
2. Используйте номера: 1 = SMS, 2 = RCS, 4 = WhatsApp, 11 = TTS.

### Invalid payload

**Причина:** неверное содержимое сообщения.

**Решения:**

1. Проверьте формат payload для канала.
2. Проверьте наличие обязательных полей.
3. Проверьте длину текста.

### Timeout expired

**Причина:** таймаут слишком маленький.

**Решения:**

1. Увеличьте timeout до 600–900 секунд.
2. Проверьте, что указано разумное значение.

## Ошибки доставки

### All channels failed

**Причина:** все каналы в каскаде не сработали.

**Решения:**

1. Проверьте EDR — какие ошибки по каналам.
2. Проверьте номера получателей.
3. Подключите HLR-проверку.
4. Обратитесь в поддержку.

### Contact cooldown

**Причина:** контакт в блокировке после предыдущей неудачи.

**Решения:**

1. Дождитесь окончания cooldown.
2. Уменьшите cooldown, если нужно.

## Что приложить к обращению

- requestId.
- Метод и URL.
- Тело запроса (без ключа).
- Код ответа.
- Время запроса.

## См. также

- [HTTP-коды ошибок](/06-reference/03-troubleshooting/ts-api-http-codes)
- [Ошибка 401 и 403](/06-reference/03-troubleshooting/ts-auth-401-403)
- [Сообщение не доставляется](/06-reference/03-troubleshooting/ts-not-delivered)
- [Первый запрос через умный шлюз](/02-otp/02-smart-gateway/otp-202-first-request)

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

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