---
title: Быстрый старт для тестировщика
description: Первый код верификации через OTP-сервис — имя отправителя, ключ, отправка
---

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

> **Коротко:** за 10–15 минут вы получите API-ключ и отправите первый код верификации через OTP-сервис.

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

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

## Что это

Пошаговая инструкция для быстрого запуска OTP-сервиса. К концу страницы у вас будет:

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

<Note>
**Если вы уже зарегистрированы** — переходите к шагам ниже.

**Если вы ещё не зарегистрированы** — сначала:

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)
</Note>

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

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

- [ ] Вы зарегистрированы в OTP-сервисе.
- [ ] Вы вошли в личный кабинет.
- [ ] У вас есть номер телефона получателя.

## Шаги

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

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

1. В левом меню: **Активы** → **Имена отправителей**.
2. Нажмите **«Добавить имя отправителя»**.
3. Выберите канал (например, SMS).
4. Укажите отображаемое название.
5. Нажмите **«Отправить заявку»**.

**В тестовом режиме** документы не нужны — регистрация занимает до 1 дня. Дождитесь статуса **«Активно»** — без одобрения имени отправка невозможна.

[Что такое имя отправителя →](https://docs.mydialogi.ru/06-reference/05-sender-id-overview)

### 2. Получите API-ключ

1. В левом меню: **API Подключения**.
2. Нажмите **«Создать API подключение»**.
3. Укажите название (например, «Тестовый ключ»).
4. В блоке **«Права доступа»** выберите: `omni-api`, `statistics`.
5. В блоке **«Имена отправителей»** выберите нужное имя — для канала, по которому будете отправлять.
6. Нажмите **«Получить API ключ»**.
7. **Скопируйте ключ и сохраните его** — он показывается только один раз.

<Note>
**Какие каналы будут доступны ключу — зависит от выбранных имён отправителей.**

У каждого имени отправителя есть свой канал. Чтобы ключ мог отправлять по SMS — выберите имя для SMS. Чтобы по SMS и WhatsApp — выберите два имени. Каналы не выбираются напрямую — они определяются именами отправителей.

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

### 3. Выберите режим и отправьте код

У OTP-сервиса **два режима работы**. Выберите тот, который подходит вашей задаче. Если не уверены — [Какой режим выбрать →](https://docs.mydialogi.ru/02-otp/00-start-here/otp-002-choose-mode).

### Если вы работаете в режиме «Под ключ (2FA)»

Платформа сама генерирует и проверяет код. Полный цикл:

1. Вы отправляете запрос с номером получателя.
2. Платформа генерирует код.
3. Платформа отправляет код получателю.
4. Получатель вводит код на вашем сайте.
5. Вы отправляете код на проверку.
6. Платформа сравнивает и возвращает результат.

**Перед первым запуском** нужно настроить 2FA-интеграцию — это делается один раз.

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

### Если вы работаете в режиме «Умный шлюз»

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

1. Сгенерируйте код на своей стороне.
2. Отправьте запрос с кодом и правилами каскада:
   - Какие каналы использовать.
   - Какие статусы ждать.
   - Таймауты между каналами.
3. Платформа отправит сообщение через указанные каналы.
4. Получите статус доставки — через push (вебхук) или pull (`GET /edrs`).

[Отправка через умный шлюз →](https://docs.mydialogi.ru/02-otp/02-smart-gateway/otp-202-first-request)
[Настройка каскада →](https://docs.mydialogi.ru/02-otp/02-smart-gateway/otp-203-cascade-rules)
[Статусы сообщений →](https://docs.mydialogi.ru/02-otp/08-api/otp-api-statuses)

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

1. В личном кабинете: **Статистика** → **Записи сообщений (EDR)**.
2. Найдите ваше сообщение по номеру получателя.
3. Проверьте статус: **Доставлено** или **Отправлено**.

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

## Результат

Вы отправили первый код верификации через OTP-сервис и увидели статус доставки.

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

### Имя отправителя не одобрено

**Причина:** имя ещё в обработке.

**Решение:** дождитесь статуса **«Активно»** — обычно до 1 дня.

[Что такое имя отправителя →](https://docs.mydialogi.ru/06-reference/05-sender-id-overview)

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

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

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

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

### Код не доставляется

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

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

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

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

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

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

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

## Что дальше

- [Как работает 2FA-сервис](https://docs.mydialogi.ru/02-otp/01-turnkey/otp-101-how-2fa-works) — если работаете в режиме «Под ключ»
- [Как работает умный шлюз](https://docs.mydialogi.ru/02-otp/02-smart-gateway/otp-201-how-gateway-works) — если генерируете код сами
- [Настройка каскада](https://docs.mydialogi.ru/02-otp/02-smart-gateway/otp-203-cascade-rules) — если нужна повышенная доставляемость
- [Статусы сообщений](https://docs.mydialogi.ru/02-otp/08-api/otp-api-statuses) — как получать статусы (push и pull)
- [Записи сообщений (EDR)](https://docs.mydialogi.ru/02-otp/06-statistics/otp-602-edr) — как проверить доставку
- [Умные сервисы](https://docs.mydialogi.ru/02-otp/07-smart-services) — HLR, MNP, IMSI, AMD

## См. также

<Columns cols={2}>
  <Card title="Добро пожаловать в OTP-коды" icon="shield" href="/02-otp/00-start-here/otp-001-welcome">
    Что такое OTP-сервис и как начать
  </Card>
  <Card title="Какой режим выбрать" icon="diagram-project" href="/02-otp/00-start-here/otp-002-choose-mode">
    Сравнение двух режимов работы
  </Card>
  <Card title="Как зарегистрироваться" icon="user-plus" href="/02-otp/00-start-here/otp-004-register">
    Регистрация в OTP-сервисе
  </Card>
  <Card title="Первый вход" icon="right-to-bracket" href="/02-otp/00-start-here/otp-005-login">
    Логин, пароль, 2FA
  </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="Как работает 2FA-сервис" icon="shield-halved" href="/02-otp/01-turnkey/otp-101-how-2fa-works">
    Режим «Под ключ» — генерация и проверка
  </Card>
  <Card title="Как работает умный шлюз" icon="plug" href="/02-otp/02-smart-gateway/otp-201-how-gateway-works">
    Режим «Умный шлюз» — своя логика
  </Card>
  <Card title="Частые вопросы тестировщика" icon="comments" href="/02-otp/00-start-here/otp-009-faq">
    Ответы на частые вопросы
  </Card>
</Columns>

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

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