---
title: Как работает 2FA-сервис
description: Как работает 2FA-сервис в OTP-кодах — режим Под ключ, где платформа сама генерирует, отправляет и проверяет коды верификации по 9 каналам
---

> **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.

> **Коротко:** 2FA-сервис автоматизирует отправку и проверку кодов верификации. Платформа сама генерирует код, отправляет его и проверяет ответ пользователя.

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

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

## Что это

2FA-сервис — режим «Под ключ». Платформа берёт на себя всю работу с кодом:

1. **Генерирует** код.
2. **Отправляет** код через нужный канал.
3. **Принимает** код от пользователя.
4. **Проверяет** код.
5. **Возвращает** результат: верно или неверно.

Вам не нужно писать логику генерации и проверки кодов.

<Note>
**Это один из двух режимов работы OTP-сервиса.** Второй режим — **Умный шлюз** — когда клиент сам генерирует код, а платформа только доставляет его.

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

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

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

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

- [ ] Вы зарегистрированы в OTP-кодах.
- [ ] Вы зарегистрировали имя отправителя.
- [ ] Вы готовы настроить 2FA-интеграцию.

## Чем отличается от «Умный шлюз»

| Критерий | Под ключ (2FA) | Умный шлюз |
|---|---|---|
| **Кто генерирует код** | Платформа | Вы |
| **Кто проверяет код** | Платформа | Вы |
| **Что вы получаете** | «Код верный / неверный» | Статус доставки сообщения |
| **Сложность интеграции** | 2 запроса | 1 запрос + своя логика |
| **Кому подходит** | Без своего OTP-модуля | Со своим генератором кодов |

[Как работает умный шлюз →](https://docs.mydialogi.ru/02-otp/02-smart-gateway/otp-201-how-gateway-works)

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

<Note>
**Доступные каналы.** В 2FA-сервисе доступно **9 каналов** OTP. Номера для поля `channel` и особенности каждого — в таблице [Какие каналы использовать для OTP](https://docs.mydialogi.ru/02-otp/04-channels/otp-401-which-channels).
</Note>

## Как это работает

### 1. Вы отправляете номер получателя

Отправляете номер телефона получателя на URL интеграции.

### 2. Платформа генерирует код

Платформа сама создаёт код — вы не пишете логику генерации.

### 3. Платформа отправляет код

Код уходит получателю через выбранный канал.

### 4. Получатель вводит код

Пользователь вводит полученный код на вашем сайте.

### 5. Вы отправляете код на проверку

Отправляете `requestId` и `code` на проверку.

### 6. Платформа возвращает результат

«Код верный» или «Код неверный».

## Что вы получаете

- В ответе на первый запрос — **requestId**. По нему можно проверить статус.
- В ответе на проверку — **результат**: код верный или неверный.

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

<Columns cols={2}>
  <Card title="Быстрая интеграция" icon="bolt">
    Два API-запроса — отправка и проверка. Без своей логики.
  </Card>
  <Card title="Безопасность" icon="shield-halved">
    Платформа отвечает за генерацию кодов.
  </Card>
  <Card title="Простота" icon="circle-check">
    Не нужно писать и хранить коды.
  </Card>
  <Card title="Гибкость" icon="share-nodes">
    Любой канал из 9 доступных в OTP.
  </Card>
</Columns>

## Как подключить

### 1. Зарегистрируйтесь в OTP-кодах

Создайте аккаунт и получите доступ в личный кабинет.

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

Имя отправителя нужно для отправки кодов по любому каналу.

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

### 3. Настройте 2FA-интеграцию

В разделе **2FA Service** → **2FA SMS** создайте интеграцию. Она выдаст **ключ интеграции** и **URL интеграции**.

[Как настроить 2FA-интеграцию →](https://docs.mydialogi.ru/02-otp/01-turnkey/otp-102-setup-2fa)

### 4. Протестируйте отправку и проверку

Отправьте тестовый код и проверьте его через API.

[Принцип работы 2FA на стороне платформы →](https://docs.mydialogi.ru/02-otp/01-turnkey/otp-106-platform-side)

## Результат

Вы понимаете, как работает режим «Под ключ», и готовы настроить 2FA-интеграцию.

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

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

**Причина:** канал недоступен или номер получателя неактивен.

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

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

### Код неверный

**Причина:** истёк срок действия кода.

**Решение:** запросите новый код.

[API 2FA Service →](https://docs.mydialogi.ru/02-otp/01-turnkey/otp-104-2fa-api)

### Ошибка API

**Причина:** неверный ключ или неверная схема аутентификации.

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

[API 2FA Service →](https://docs.mydialogi.ru/02-otp/01-turnkey/otp-104-2fa-api)

## См. также

<Columns cols={2}>
  <Card title="Какой режим выбрать" icon="diagram-project" href="/02-otp/00-start-here/otp-002-choose-mode">
    Сравнение двух режимов работы
  </Card>
  <Card title="Как настроить 2FA-интеграцию" icon="gear" href="/02-otp/01-turnkey/otp-102-setup-2fa">
    Пошаговая настройка режима «Под ключ»
  </Card>
  <Card title="Как редактировать 2FA-интеграцию" icon="pen-to-square" href="/02-otp/01-turnkey/otp-103-edit-2fa">
    Изменение параметров интеграции
  </Card>
  <Card title="API 2FA Service" icon="code" href="/02-otp/01-turnkey/otp-104-2fa-api">
    Обзор API 2FA — методы и эндпоинты
  </Card>
  <Card title="Принцип работы 2FA: на стороне платформы" icon="server" href="/02-otp/01-turnkey/otp-106-platform-side">
    Curl-примеры отправки и проверки кода
  </Card>
  <Card title="Получение обратных вызовов при 2FA" icon="webhook" href="/02-otp/01-turnkey/otp-108-callbacks">
    Push-уведомления о статусах
  </Card>
  <Card title="Как работает умный шлюз" icon="plug" href="/02-otp/02-smart-gateway/otp-201-how-gateway-works">
    Второй режим работы OTP-кодов
  </Card>
  <Card title="Какие каналы использовать для OTP" icon="share-nodes" href="/02-otp/04-channels/otp-401-which-channels">
    9 каналов OTP и их номера в API
  </Card>
</Columns>

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

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