---
title: Добро пожаловать в OTP-коды
description: Сервис подтверждения действий пользователей — коды через SMS, WhatsApp, голосовое информирование и другие каналы
---

> **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-коды — сервис подтверждения действий пользователей. Отправляйте коды верификации через SMS, WhatsApp, голосовое информирование и другие каналы с гарантированной доставкой.

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

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

## Что это

**OTP** (One-Time Password) — одноразовый код, который пользователь вводит для подтверждения действия: входа в аккаунт, подтверждения платежа, регистрации. 

Сервис OTP-кодов автоматизирует отправку таких кодов через 9 каналов — от классических SMS до голосового информирования и кодов в номере звонящего.

Сервис работает в **разных странах** — России, Казахстане, Узбекистане, Азербайджане, Беларуси, Кыргызстане, Таджикистане, Туркменистане — с местными операторами связи и сервисами.

<Tip>
**Тестовое подключение** — договор не требуется, мы предоставляем баланс для тестирования. Для продолжения работы после теста — запросите договор через поддержку сервиса.

Для старта нужны: рабочий email, номер телефона и 15 минут. К концу быстрого старта у вас будет имя отправителя, API-ключ и первый отправленный код.

[Начните с быстрого старта →](https://iba-platform.jamdesk.app/02-otp/00-start-here/otp-003-quick-start)
</Tip>

## Два режима работы

| Режим | Кто генерирует код | Кто проверяет код |
|---|---|---|
| **Под ключ (2FA)** | Платформа | Платформа |
| **Умный шлюз** | Клиент | Клиент |

[Какой режим выбрать →](https://docs.mydialogi.ru/02-otp/00-start-here/otp-002-choose-mode)

## Ключевые возможности

- **Единый API для отправки кодов.** Один запрос — разные каналы.
- **Один договор и один счёт** — на все каналы сразу, как по местным, так и по зарубежным. Не нужно заключать отдельные договоры с каждым оператором и мессенджером.
- **Валюта счёта** — зависит от страны нахождения клиента. Например, если клиент из России — оплата в рублях, если из другой страны — в валюте этой страны.
- **Нет рассылок из личного кабинета.** Вы отправляете только коды верификации.
- **Гарантированная доставка.** Если код не доставлен по одному каналу, система автоматически переключается на другой (каскад).
- **Zero-Tap для WhatsApp.** Код подставляется автоматически — пользователю не нужно ничего вводить.
- **Умные сервисы.** HLR, MNP, IMSI для валидации номеров и защиты.
- **Статистика.** Полная аналитика по доставке, стоимости и статусам.
- **Защита от мошенничества (FMS).** Автоматическая блокировка подозрительных операций.

## Доступные каналы

В OTP-сервисе доступно **9 каналов**:

| Канал | Что это |
|---|---|
| **SMS** | Классические текстовые сообщения |
| **WhatsApp** | Популярный мессенджер — быстрее и дешевле SMS |
| **RCS** | Современный канал с богатыми возможностями |
| **Viber** | Популярный мессенджер |
| **Email** | Подтверждение по электронной почте |
| **Telegram Gateway** | Telegram для кодов верификации |
| **TTS** | Текст в речь, голосовое информирование |
| **FlashCall** | Код подтверждения в номере звонящего |
| **Mobile Push** | Push-уведомления в приложение |

<Note>
**TTS** — не только «голосовые коды». Это канал голосового информирования с несколькими сценариями: OTP/2FA, транзакционные уведомления, напоминания, интерактивное голосовое меню (IVR), массовые голосовые рассылки.

**FlashCall** — короткий звонок, при котором код передаётся в номере звонящего. Пользователь видит последние цифры номера и вводит их как код.

[Обзор всех каналов →](https://iba-platform.jamdesk.app/05-channels/00-overview/channels-overview)
</Note>

## Что вы получите за первые 15 минут

- ✅ Аккаунт в OTP-сервисе
- ✅ Зарегистрированное имя отправителя
- ✅ API-ключ для интеграции
- ✅ Первый отправленный код со статусом доставки

## Перед началом

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

## Карта пути

### Если вы уже зарегистрированы

Пройдите по шагам, чтобы начать работу с OTP-сервисом.

#### 1. Выберите режим работы

Определите, что вам подходит: готовое решение «Под ключ» или интеграция со своим генератором кодов — «Умный шлюз».

[Какой режим выбрать →](https://docs.mydialogi.ru/02-otp/00-start-here/otp-002-choose-mode)

#### 2. Зарегистрируйте имя отправителя

Без имени отправителя коды не уходят. Это обязательный шаг.

[Как зарегистрировать имя отправителя →](https://docs.mydialogi.ru/02-otp/03-for-developers/otp-301-sender-id)

#### 3. Создайте API-ключ

В разделе «API Подключения».

[Как создать API-ключ →](https://docs.mydialogi.ru/06-reference/01-api/api-keys)

#### 4. Отправьте первый код

В режиме «Под ключ» — настройте 2FA-интеграцию. В «Умном шлюзе» — отправьте запрос с кодом.

[Настроить 2FA-интеграцию →](https://docs.mydialogi.ru/02-otp/01-turnkey/otp-102-setup-2fa)
[Первый запрос через умный шлюз →](https://docs.mydialogi.ru/02-otp/02-smart-gateway/otp-202-first-request)

#### 5. Проверьте статус

В разделе «Статистика» → «Записи сообщений (EDR)».

[Записи сообщений (EDR) по OTP →](https://docs.mydialogi.ru/02-otp/06-statistics/otp-602-edr)

### Если вы ещё не зарегистрированы

#### 1. Зарегистрируйтесь

[Как зарегистрироваться в OTP-сервисе →](https://docs.mydialogi.ru/02-otp/00-start-here/otp-004-register)

#### 2. Войдите в личный кабинет

[Первый вход в OTP-сервис →](https://docs.mydialogi.ru/02-otp/00-start-here/otp-005-login)

#### 3. Вернитесь к шагам

После регистрации вернитесь к блоку **«Если вы уже зарегистрированы»**.

## Для разработчиков

Если вы интегрируете OTP-сервис со своей системой — начните с этих статей.

<Columns cols={2}>
  <Card title="Обзор API OTP-кодов" icon="book" href="/02-otp/08-api/otp-api-overview">
    OMNI API, Broadcasts API, 2FA — обзор
  </Card>
  <Card title="Подключение к API" icon="plug" href="/02-otp/08-api/otp-api-connection">
    Базовый URL, аутентификация, формат запросов
  </Card>
  <Card title="OMNI API — отправка кодов" icon="paper-plane" href="/02-otp/08-api/otp-api-omni">
    Эндпоинты /messages, /omnimessages, 2FA-эндпоинты
  </Card>
  <Card title="Форматы payload по каналам" icon="code" href="/02-otp/08-api/otp-api-omni-payload">
    JSON-примеры для каждого канала
  </Card>
  <Card title="Broadcasts API" icon="bullhorn" href="/02-otp/08-api/otp-api-broadcasts">
    Запуск рассылок, шаблоны рассылок
  </Card>
  <Card title="Статусы сообщений" icon="signal" href="/02-otp/08-api/otp-api-statuses">
    Push и pull — два способа получения статусов
  </Card>
  <Card title="Как настроить 2FA-интеграцию" icon="shield-halved" href="/02-otp/01-turnkey/otp-102-setup-2fa">
    Режим «Под ключ» — настройка в личном кабинете
  </Card>
  <Card title="Обработка ошибок API" icon="triangle-exclamation" href="/06-reference/01-api/api-errors">
    HTTP-коды и форматы ответов
  </Card>
</Columns>

## Тестовый режим

**В тестовом подключении договор не требуется** — мы предоставляем баланс для тестирования. **Весь функционал доступен**, за исключением пополнения баланса.

Для самостоятельной регистрации и бесплатного тестирования — см. [Быстрый старт →](https://iba-platform.jamdesk.app/02-otp/00-start-here/otp-003-quick-start).

После тестирования для продолжения работы нужно **запросить заключение договора через поддержку сервиса**.

## Стоимость

Для полноценной работы: регистрация имени отправителя — **ежемесячная абонентская плата** или **бесплатно** (зависит от канала), отправка кодов — за каждое сообщение. Цена зависит от канала и оператора.

[Обзор тарифов →](https://iba-platform.jamdesk.app/06-reference/02-pricing/pricing-overview)

## Результат

Вы понимаете, что такое OTP-коды, какие есть режимы работы и каналы, и как начать отправлять коды верификации.

- [Быстрый старт →](https://iba-platform.jamdesk.app/02-otp/00-start-here/otp-003-quick-start)
- [Обзор API OTP-кодов →](https://iba-platform.jamdesk.app/02-otp/08-api/otp-api-overview)
- [Обзор всех каналов →](https://iba-platform.jamdesk.app/05-channels/00-overview/channels-overview)

## Частые проблемы

### Не знаю, какой режим выбрать

**Причина:** два режима работы — «Под ключ» и «Умный шлюз» — для разных задач.

**Решение:** если у вас нет своего генератора кодов — «Под ключ». Если есть и нужен контроль — «Умный шлюз».

[Какой режим выбрать →](https://docs.mydialogi.ru/02-otp/00-start-here/otp-002-choose-mode)

### Не приходит код

**Причина:** возможны разные причины — от неверного номера до блокировки оператором.

**Решение:** проверьте номер, статус имени отправителя и записи в EDR. Если не помогает — обратитесь в поддержку.

[OTP: код не приходит →](https://docs.mydialogi.ru/06-reference/03-troubleshooting/ts-otp-code)

### Ошибка 401 при отправке

**Причина:** неверный или отсутствующий API-ключ.

**Решение:** проверьте заголовок `X-API-Key` и ключ. Для 2FA-эндпоинтов используется Basic Auth.

[Ошибка 401 →](https://docs.mydialogi.ru/06-reference/03-troubleshooting/ts-mapi-401)

### Превышен лимит запросов

**Причина:** более 5 одновременных запросов на один канал.

**Решение:** уменьшите частоту, используйте очередь на своей стороне.

[Ошибка 429 →](https://docs.mydialogi.ru/06-reference/03-troubleshooting/ts-rate-limit-429)

### Не приходит письмо подтверждения

**Причина:** письмо попало в спам.

**Решение:** проверьте папку «Спам».

[Контакты поддержки →](https://docs.mydialogi.ru/06-reference/03-troubleshooting/ts-support-contacts)

## См. также

<Columns cols={2}>
  <Card title="Что такое IBA Platform" icon="book" href="/01-start/01-registration/start-001-what-is">
    Три сервиса, 14 каналов, умные сервисы
  </Card>
  <Card title="Как зарегистрироваться" icon="user-plus" href="/01-start/01-registration/start-003-create-account">
    Регистрация в OTP-сервисе
  </Card>
  <Card title="Что такое имя отправителя" icon="id-card" href="/06-reference/05-sender-id-overview">
    Как зарегистрировать и использовать
  </Card>
  <Card title="Как создать API-ключ" icon="key" href="/06-reference/01-api/api-keys">
    Создание и управление ключами доступа
  </Card>
  <Card title="Какой режим выбрать" icon="diagram-project" href="/02-otp/00-start-here/otp-002-choose-mode">
    Сравнение двух режимов работы
  </Card>
  <Card title="Частые вопросы тестировщика" icon="comments" href="/02-otp/00-start-here/otp-009-faq">
    Ответы на частые вопросы
  </Card>
</Columns>

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

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