Какой режим выбрать
Сравнение двух режимов работы OTP-сервиса — Под ключ (2FA-сервис) и Умный шлюз
Коротко: OTP-сервис работает в двух режимах. Выберите тот, который подходит вашей задаче: готовое решение или интеграция со своим генератором кодов.
Кому подходит
- Роль: Клиент, Разработчик
- Уровень: Новичок / Опытный
Что это
OTP-сервис можно использовать двумя способами. Оба дают отправку кодов через все 9 каналов, но по-разному работают с генерацией и проверкой кода. Выбор зависит от того, есть ли у вас свой механизм OTP.
Тестовое подключение — договор не требуется, мы предоставляем баланс для тестирования. Для продолжения работы после теста — запросите договор через поддержку сервиса.
Сравнение режимов
| Критерий | Под ключ (2FA) | Умный шлюз |
|---|---|---|
| Кто генерирует код | Платформа | Вы |
| Кто проверяет код | Платформа | Вы |
| Что вы получаете | «Код верный / неверный» | Статус доставки сообщения |
| Сложность интеграции | 2 запроса, логика на платформе | 1 запрос + своя логика генерации и проверки |
| Каскад между каналами | Настраивается в интерфейсе | Настраивается в запросе |
| Кому подходит | Компаниям без своего OTP | Компаниям со своим генератором кодов |
Перед началом
- Вы понимаете, есть ли у вас свой генератор кодов.
- Вы определили, нужен ли контроль над логикой проверки.
- Вы готовы к интеграции с API.
Режим 1. Под ключ (2FA-сервис)
Когда выбирать: у вас нет своего механизма генерации и проверки кодов.
Что делает платформа:
- Генерирует код.
- Отправляет его через нужный канал.
- Принимает код от пользователя.
- Проверяет — верный или нет.
- Возвращает вам результат проверки.
Что делаете вы:
- Отправляете номер телефона получателя.
- Получаете
requestId. - Получатель получает код и вводит его на вашем сайте.
- Отправляете код на проверку.
- Получаете ответ «верно / неверно».
Что вы НЕ делаете:
- Не пишете логику генерации кода.
- Не храните коды.
- Не проверяете самостоятельно.
Плюсы:
- Быстрая интеграция — два API-запроса: отправка кода и проверка кода.
- Платформа делает всё за вас.
- Не нужно думать о безопасности генерации кодов.
Минусы:
- Меньше контроля над процессом.
📖 Подробнее о режиме «Под ключ» →
Режим 2. Умный шлюз
Когда выбирать: у вас уже есть свой генератор кодов, и вам нужна только доставка.
Что делает платформа:
- Принимает ваш запрос с кодом и правилами.
- Отправляет сообщение через указанные каналы.
- Следит за статусами доставки.
- Переключает каналы по каскаду, если нужно.
- Возвращает вам статус доставки — через push (вебхук) или pull (запрос к API).
Что делаете вы:
- Генерируете код.
- Отправляете запрос с кодом и правилами каскада.
- Получаете статус доставки — через push (вебхук) или pull (
GET /edrs).
Что вы НЕ делаете:
- Не беспокоитесь о выборе канала.
- Не следите за доставкой вручную.
- Не обрабатываете ошибки каналов.
Плюсы:
- Полный контроль над генерацией кодов.
- Гибкие правила каскада.
- Можно интегрировать с любой своей логикой.
Минусы:
- Больше работы на вашей стороне.
📖 Подробнее о режиме «Умный шлюз» →
Что общего
В обоих режимах:
- Каналы — одинаковый набор: SMS, WhatsApp, RCS, Viber, Email, Telegram Gateway, TTS, FlashCall, Mobile Push.
- Каскад между каналами — если код не доставлен по одному каналу, система автоматически переключается на другой. Различается только способ настройки: в интерфейсе или в запросе.
- Имя отправителя — регистрируется один раз.
- API-ключи — создаются в личном кабинете. Для каждого режима — свой ключ.
- Статистика — EDR и CDR общие.
- Способы получения статусов — push (вебхук) или pull (
GET /edrs) — доступны в обоих режимах. - Умные сервисы — HLR, MNP, IMSI работают в обоих режимах.
- Защита от мошенничества (FMS) — включена всегда.
Как выбрать
Ответьте на два вопроса:
| Вопрос | Если «да» | Если «нет» |
|---|---|---|
| У вас есть свой генератор кодов? | Умный шлюз | Под ключ |
| Вы хотите контролировать логику проверки кода? | Умный шлюз | Под ключ |
Если не уверены — начните с «Умного шлюза»: вы генерируете код сами, а платформа отвечает только за доставку. Это самый распространённый вариант. Если у вас нет своего генератора — используйте «Под ключ».
Результат
Вы определили подходящий режим работы OTP-сервиса и готовы перейти к настройке.
Частые проблемы
Причина: не уверены, как работает ваша система.
Решение: если коды генерирует ваша система и хранит их — у вас свой генератор. Если нет — используйте «Под ключ».
Причина: стандартная логика «Под ключ» не подходит.
Решение: используйте «Умный шлюз» — вы генерируете и проверяете коды на своей стороне.
Причина: нужно минимальное время на интеграцию.
Решение: зависит от того, что у вас уже есть:
- Если у вас уже есть OTP-модуль — используйте «Умный шлюз». Один запрос на отправку, каскад делает платформа.
- Если своего OTP нет — используйте «Под ключ». Два API-запроса + форма ввода кода на вашей стороне.
Причина: не уверены в выборе сейчас.
Решение: да. Начните с «Умного шлюза» — если понадобится, можно перейти на «Под ключ» или наоборот. API-ключ и имя отправителя общие для обоих режимов.
См. также
Нужна помощь?
- OTP-коды: support@otpcod.ru