--- title: Какой режим выбрать description: Сравнение двух режимов работы OTP-сервиса — Под ключ (2FA-сервис) и Умный шлюз --- > **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. > **Коротко:** OTP-сервис работает в двух режимах. Выберите тот, который подходит вашей задаче: готовое решение или интеграция со своим генератором кодов. ## Кому подходит - Роль: Клиент, Разработчик - Уровень: Новичок / Опытный ## Что это OTP-сервис можно использовать двумя способами. Оба дают отправку кодов через все 9 каналов, но по-разному работают с генерацией и проверкой кода. Выбор зависит от того, есть ли у вас свой механизм OTP. **Тестовое подключение** — договор не требуется, мы предоставляем баланс для тестирования. Для продолжения работы после теста — запросите договор через поддержку сервиса. [Начните с быстрого старта →](https://iba-platform.jamdesk.app/02-otp/00-start-here/otp-003-quick-start) ## Сравнение режимов | Критерий | Под ключ (2FA) | Умный шлюз | |---|---|---| | **Кто генерирует код** | Платформа | Вы | | **Кто проверяет код** | Платформа | Вы | | **Что вы получаете** | «Код верный / неверный» | Статус доставки сообщения | | **Сложность интеграции** | 2 запроса, логика на платформе | 1 запрос + своя логика генерации и проверки | | **Каскад между каналами** | Настраивается в интерфейсе | Настраивается в запросе | | **Кому подходит** | Компаниям без своего OTP | Компаниям со своим генератором кодов | ## Перед началом - [ ] Вы понимаете, есть ли у вас свой генератор кодов. - [ ] Вы определили, нужен ли контроль над логикой проверки. - [ ] Вы готовы к интеграции с API. ## Режим 1. Под ключ (2FA-сервис) **Когда выбирать:** у вас нет своего механизма генерации и проверки кодов. **Что делает платформа:** 1. Генерирует код. 2. Отправляет его через нужный канал. 3. Принимает код от пользователя. 4. Проверяет — верный или нет. 5. Возвращает вам результат проверки. **Что делаете вы:** 1. Отправляете номер телефона получателя. 2. Получаете `requestId`. 3. Получатель получает код и вводит его на вашем сайте. 4. Отправляете код на проверку. 5. Получаете ответ «верно / неверно». **Что вы НЕ делаете:** - Не пишете логику генерации кода. - Не храните коды. - Не проверяете самостоятельно. **Плюсы:** - Быстрая интеграция — два API-запроса: отправка кода и проверка кода. - Платформа делает всё за вас. - Не нужно думать о безопасности генерации кодов. **Минусы:** - Меньше контроля над процессом. 📖 [Подробнее о режиме «Под ключ» →](https://iba-platform.jamdesk.app/02-otp/01-turnkey/otp-101-how-2fa-works) ## Режим 2. Умный шлюз **Когда выбирать:** у вас уже есть свой генератор кодов, и вам нужна только доставка. **Что делает платформа:** 1. Принимает ваш запрос с кодом и правилами. 2. Отправляет сообщение через указанные каналы. 3. Следит за статусами доставки. 4. Переключает каналы по каскаду, если нужно. 5. Возвращает вам статус доставки — через push (вебхук) или pull (запрос к API). **Что делаете вы:** 1. Генерируете код. 2. Отправляете запрос с кодом и правилами каскада. 3. Получаете статус доставки — через push (вебхук) или pull (`GET /edrs`). **Что вы НЕ делаете:** - Не беспокоитесь о выборе канала. - Не следите за доставкой вручную. - Не обрабатываете ошибки каналов. **Плюсы:** - Полный контроль над генерацией кодов. - Гибкие правила каскада. - Можно интегрировать с любой своей логикой. **Минусы:** - Больше работы на вашей стороне. 📖 [Подробнее о режиме «Умный шлюз» →](https://iba-platform.jamdesk.app/02-otp/02-smart-gateway/otp-201-how-gateway-works) ## Что общего В обоих режимах: - **Каналы** — одинаковый набор: SMS, WhatsApp, RCS, Viber, Email, Telegram Gateway, TTS, FlashCall, Mobile Push. - **Каскад между каналами** — если код не доставлен по одному каналу, система автоматически переключается на другой. Различается только способ настройки: в интерфейсе или в запросе. - **Имя отправителя** — регистрируется один раз. - **API-ключи** — создаются в личном кабинете. Для каждого режима — свой ключ. - **Статистика** — EDR и CDR общие. - **Способы получения статусов** — push (вебхук) или pull (`GET /edrs`) — доступны в обоих режимах. - **Умные сервисы** — HLR, MNP, IMSI работают в обоих режимах. - **Защита от мошенничества (FMS)** — включена всегда. ## Как выбрать Ответьте на два вопроса: | Вопрос | Если «да» | Если «нет» | |---|---|---| | У вас есть свой генератор кодов? | Умный шлюз | Под ключ | | Вы хотите контролировать логику проверки кода? | Умный шлюз | Под ключ | Если не уверены — начните с **«Умного шлюза»**: вы генерируете код сами, а платформа отвечает только за доставку. Это самый распространённый вариант. Если у вас нет своего генератора — используйте **«Под ключ»**. ## Результат Вы определили подходящий режим работы OTP-сервиса и готовы перейти к настройке. ## Частые проблемы ### Не знаю, есть ли у меня свой генератор кодов **Причина:** не уверены, как работает ваша система. **Решение:** если коды генерирует ваша система и хранит их — у вас свой генератор. Если нет — используйте «Под ключ». [Как работает 2FA-сервис →](https://iba-platform.jamdesk.app/02-otp/01-turnkey/otp-101-how-2fa-works) ### Хочу контролировать логику проверки **Причина:** стандартная логика «Под ключ» не подходит. **Решение:** используйте «Умный шлюз» — вы генерируете и проверяете коды на своей стороне. [Отправка через умный шлюз →](https://iba-platform.jamdesk.app/02-otp/02-smart-gateway/otp-202-first-request) ### Хочу быстро запустить **Причина:** нужно минимальное время на интеграцию. **Решение:** зависит от того, что у вас уже есть: - **Если у вас уже есть OTP-модуль** — используйте «Умный шлюз». Один запрос на отправку, каскад делает платформа. - **Если своего OTP нет** — используйте «Под ключ». Два API-запроса + форма ввода кода на вашей стороне. [Как настроить 2FA-интеграцию →](https://iba-platform.jamdesk.app/02-otp/01-turnkey/otp-102-setup-2fa) [Отправка через умный шлюз →](https://iba-platform.jamdesk.app/02-otp/02-smart-gateway/otp-202-first-request) ### Можно ли переключиться между режимами позже? **Причина:** не уверены в выборе сейчас. **Решение:** да. Начните с «Умного шлюза» — если понадобится, можно перейти на «Под ключ» или наоборот. API-ключ и имя отправителя общие для обоих режимов. [Что общего →](#что-общего) ## См. также Что такое OTP-сервис и как начать Отправьте первый код за 10–15 минут Режим «Под ключ» — генерация и проверка Режим «Умный шлюз» — своя логика Пошаговая настройка режима «Под ключ» Первый запрос в режиме «Умный шлюз» HLR, MNP, IMSI — валидация и защита Ответы на частые вопросы ## Нужна помощь? - **OTP-коды:** support@otpcod.ru