Быстрый старт для тестировщика
Первый код верификации через OTP-сервис — имя отправителя, ключ, отправка
Коротко: за 10–15 минут вы получите API-ключ и отправите первый код верификации через OTP-сервис.
Кому подходит
- Роль: Клиент, Разработчик
- Уровень: Новичок / Опытный
Что это
Пошаговая инструкция для быстрого запуска OTP-сервиса. К концу страницы у вас будет:
- ✅ Зарегистрированное имя отправителя
- ✅ API-ключ для интеграции
- ✅ Первый отправленный код со статусом доставки
Если вы уже зарегистрированы — переходите к шагам ниже.
Если вы ещё не зарегистрированы — сначала:
Тестовое подключение — договор не требуется, мы предоставляем баланс для тестирования. Для продолжения работы после теста — запросите договор через поддержку сервиса.
Перед началом
- Вы зарегистрированы в OTP-сервисе.
- Вы вошли в личный кабинет.
- У вас есть номер телефона получателя.
Шаги
Без имени отправителя отправить код нельзя. Это обязательный шаг.
- В левом меню: Активы → Имена отправителей.
- Нажмите «Добавить имя отправителя».
- Выберите канал (например, SMS).
- Укажите отображаемое название.
- Нажмите «Отправить заявку».
В тестовом режиме документы не нужны — регистрация занимает до 1 дня. Дождитесь статуса «Активно» — без одобрения имени отправка невозможна.
- В левом меню: API Подключения.
- Нажмите «Создать API подключение».
- Укажите название (например, «Тестовый ключ»).
- В блоке «Права доступа» выберите:
omni-api,statistics. - В блоке «Имена отправителей» выберите нужное имя — для канала, по которому будете отправлять.
- Нажмите «Получить API ключ».
- Скопируйте ключ и сохраните его — он показывается только один раз.
Какие каналы будут доступны ключу — зависит от выбранных имён отправителей.
У каждого имени отправителя есть свой канал. Чтобы ключ мог отправлять по SMS — выберите имя для SMS. Чтобы по SMS и WhatsApp — выберите два имени. Каналы не выбираются напрямую — они определяются именами отправителей.
У OTP-сервиса два режима работы. Выберите тот, который подходит вашей задаче. Если не уверены — Какой режим выбрать →.
Если вы работаете в режиме «Под ключ (2FA)»
Платформа сама генерирует и проверяет код. Полный цикл:
- Вы отправляете запрос с номером получателя.
- Платформа генерирует код.
- Платформа отправляет код получателю.
- Получатель вводит код на вашем сайте.
- Вы отправляете код на проверку.
- Платформа сравнивает и возвращает результат.
Перед первым запуском нужно настроить 2FA-интеграцию — это делается один раз.
Как настроить 2FA-интеграцию → Проверка 2FA-запроса →
Если вы работаете в режиме «Умный шлюз»
Вы сами генерируете код, а платформа только доставляет его по нужным каналам с каскадом.
- Сгенерируйте код на своей стороне.
- Отправьте запрос с кодом и правилами каскада:
- Какие каналы использовать.
- Какие статусы ждать.
- Таймауты между каналами.
- Платформа отправит сообщение через указанные каналы.
- Получите статус доставки — через push (вебхук) или pull (
GET /edrs).
Отправка через умный шлюз → Настройка каскада → Статусы сообщений →
- В личном кабинете: Статистика → Записи сообщений (EDR).
- Найдите ваше сообщение по номеру получателя.
- Проверьте статус: Доставлено или Отправлено.
Результат
Вы отправили первый код верификации через OTP-сервис и увидели статус доставки.
Частые проблемы
Причина: имя ещё в обработке.
Решение: дождитесь статуса «Активно» — обычно до 1 дня.
Причина: неверный или отсутствующий API-ключ.
Решение: проверьте заголовок X-API-Key и ключ. Для 2FA-эндпоинтов используется Basic Auth.
Причина: номер недоступен, имя отправителя неактивно или проблема у оператора.
Решение: проверьте номер телефона, статус отправителя и записи в EDR. Если не помогает — обратитесь в поддержку.
Что дальше
- Как работает 2FA-сервис — если работаете в режиме «Под ключ»
- Как работает умный шлюз — если генерируете код сами
- Настройка каскада — если нужна повышенная доставляемость
- Статусы сообщений — как получать статусы (push и pull)
- Записи сообщений (EDR) — как проверить доставку
- Умные сервисы — HLR, MNP, IMSI, AMD
См. также
Нужна помощь?
- OTP-коды: support@otpcod.ru