---
title: Как настроить 2FA-интеграцию
description: Настройка 2FA-интеграции — сторона генерации, канал, параметры кода
---

> **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 Service». Вы выбираете сторону генерации, канал отправки и параметры кода.

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

- Роль: Клиент, Администратор
- Уровень: Опытный

## Что это

2FA-интеграция — это подключение OTP-кодов к вашему сайту или сервису через раздел **2FA Service**. В одной интеграции можно:

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

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

- [ ] Вы в личном кабинете OTP-кодов.
- [ ] У вас есть имя отправителя со статусом **Активно**.
- [ ] У вас есть API-ключ.

<Note>
**Раздел 2FA Service — для режима «На стороне платформы».**

Платформа сама генерирует код, отправляет его и проверяет. Вам не нужно писать свою логику генерации и хранения кодов.

**Если вам нужна генерация и проверка кода на своей стороне** — используйте режим **Умный шлюз**.

[Как работает умный шлюз →](https://iba-platform.jamdesk.app/02-otp/02-smart-gateway/otp-201-how-gateway-works)
</Note>

## Шаги

### 1. Откройте раздел «2FA Service»

В левом меню: **2FA Service** → **2FA SMS**.

### 2. Нажмите «Добавить интеграцию»

Кнопка в правом верхнем углу.

### 3. Выберите сторону генерации и проверки

В поле **Генерация и проверка кода** выберите значение **На стороне платформы**.

| Значение | Когда использовать |
|---|---|
| **На стороне платформы** | Платформа генерирует и проверяет код. Этот вариант используется в разделе 2FA Service |
| **На стороне клиента** | Вы генерируете и проверяете код на своей стороне. Настраивается через режим **Умный шлюз** |

<Note>
**В разделе 2FA Service используется только вариант «На стороне платформы».**

Если вам нужна генерация кода на своей стороне — перейдите в режим **Умный шлюз**.

[Как работает умный шлюз →](https://iba-platform.jamdesk.app/02-otp/02-smart-gateway/otp-201-how-gateway-works)
</Note>

### 4. Укажите название

Понятное имя записи. Например, «2FA для сайта».

### 5. Выберите SMS-отправителя

Имя отправителя, от которого будут отправляться коды.

### 6. Настройте параметры кода

| Поле | Что указать |
|---|---|
| **Количество цифр в коде** | 4, 5, 6 или больше |
| **Период валидности кода** | В секундах, максимум 600 |
| **URL для результата верификации** | Куда отправлять результат (необязательно) |

### 7. Настройте текст сообщения

Введите текст с плейсхолдером `{{code}}`. Например: «Ваш код: {{code}}».

### 8. Сгенерируйте API-ключ для интеграции

В разделе **Данные для интеграции** нажмите кнопку генерации. Ключ появится в поле **API key**.

Скопируйте:

- **API key**.
- **URL для интеграции**.

### 9. Сохраните

| Кнопка | Что делает |
|---|---|
| **Сохранить как черновик** | Сохраняет со статусом Черновик |
| **Сохранить и запустить сервис** | Активирует интеграцию |

## Результат

2FA-интеграция настроена. Статус — **Активный**.

## Тестирование

Возможность тестирования становится доступна после создания интеграции:

1. Откройте карточку интеграции.
2. Введите номер телефона для теста.
3. Нажмите **Отправить тестовый код**.
4. Проверьте, что код пришёл.

<Note>
**URL-адрес статуса обработки обратного вызова** — задайте, если хотите получать статусы доставки через вебхук.

[Как редактировать 2FA-интеграцию →](https://iba-platform.jamdesk.app/02-otp/01-turnkey/otp-103-edit-2fa)
</Note>

## Статусы интеграции

| Статус | Что означает |
|---|---|
| **Активный** | Работает |
| **Черновик** | Не активирована |
| **Заблокированный** | Отключена |

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

### Кнопка «Сохранить и запустить» неактивна

**Причина:** не заполнено обязательное поле.

**Решение:** проверьте форму — все обязательные поля должны быть заполнены.

### Тестовый код не приходит

**Причина:** неверный номер телефона или проблема у оператора.

**Решение:** проверьте номер — он должен быть в международном формате, без знака `+`. Например, для России: `79991234567`.

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

### Ошибка API

**Причина:** неверный API-ключ интеграции.

**Решение:** сверьте ключ в разделе **Данные для интеграции**.

[Как редактировать 2FA-интеграцию →](https://iba-platform.jamdesk.app/02-otp/01-turnkey/otp-103-edit-2fa)

### Нужна генерация кода на своей стороне

**Причина:** раздел 2FA Service работает только с генерацией на стороне платформы.

**Решение:** используйте режим **Умный шлюз**.

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

## См. также

<Columns cols={2}>
  <Card title="Как работает 2FA-сервис" icon="shield-halved" href="/02-otp/01-turnkey/otp-101-how-2fa-works">
    Режим «Под ключ» — генерация и проверка
  </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">
    Подключение 2FA к вашему сайту через API
  </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="Проверка 2FA-запроса" icon="circle-check" href="/02-otp/01-turnkey/otp-109-check-request">
    Статус запроса по requestId
  </Card>
  <Card title="Как создать API-ключ" icon="key" href="/06-reference/01-api/api-keys">
    Ключи для OMNI API и 2FA
  </Card>
  <Card title="Как зарегистрировать имя отправителя" icon="id-card" href="/02-otp/03-for-developers/otp-301-sender-id">
    Имена для всех каналов
  </Card>
</Columns>

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

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