IBA Platform
docs

Как работает умный шлюз

Умный шлюз — вы генерируете код, платформа доставляет его по каскаду

Как работает умный шлюз

Коротко: умный шлюз — это режим, при котором вы сами генерируете код, а платформа только доставляет его по каналам с каскадом.

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

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

Что это

Умный шлюз — второй режим работы OTP-сервиса. В отличие от «Под ключ», здесь вы контролируете генерацию и проверку кода, а платформа берёт на себя доставку.

Что делает платформа

  1. Принимает ваш запрос с кодом и правилами.
  2. Отправляет сообщение через указанные каналы.
  3. Следит за статусами доставки.
  4. Переключает каналы по каскаду, если нужно.
  5. Возвращает вам статус доставки через вебхуки.

Что делаете вы

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

Что вы НЕ делаете

  • Не беспокоитесь о выборе канала.
  • Не следите за доставкой вручную.
  • Не обрабатываете ошибки каналов.

Преимущества

  • Полный контроль над генерацией кодов.
  • Гибкие правила каскада — настраиваются в запросе.
  • Автоматическая доставка — платформа сама переключает каналы.
  • Интеграция с любой логикой — работает с вашими системами.

Когда использовать

  • У вас уже есть свой OTP-механизм.
  • Нужны специфические правила доставки.
  • Нужен полный контроль над логикой.

Когда не использовать

  • Нет своего OTP-механизма. Используйте режим «Под ключ».
  • Нужна простая интеграция за 2 запроса.

Как настроить

  1. Зарегистрируйтесь в OTP-сервисе.
  2. Зарегистрируйте имя отправителя.
  3. Создайте API-ключ.
  4. Отправьте первый запрос. Подробнее: Первый запрос через умный шлюз.
  5. Настройте вебхуки для статусов.

Что дальше

См. также

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