---
title: Что такое FlashCall
description: FlashCall — короткий звонок вместо SMS, код в последних цифрах номера
---

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


> **Коротко:** FlashCall — голосовой канал, при котором вместо SMS с кодом совершается короткий звонок. Пользователь вводит последние цифры номера как код.

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

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

## Что это

**FlashCall** — голосовой канал для отправки кодов подтверждения. При FlashCall пользователь не получает SMS. Вместо этого система совершает короткий звонок с номера, последние цифры которого — код. Пользователь видит номер и вводит последние цифры как код подтверждения.

<Warning>
**FlashCall не доступен для работы из личного кабинета.** Канал работает **только через API** — интеграцию с программой клиента.

Отправить код через FlashCall из интерфейса рассылки нельзя.
</Warning>

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

### 1. Программа клиента вызывает API

Ваша программа отправляет запрос на платформу через API — указывает канал `14` (FlashCall) и **цифры кода** (4–6 цифр).

### 2. Платформа звонит с нужного номера

Система совершает короткий звонок с номера, **последние 4–6 цифр которого совпадают с переданным кодом**.

### 3. Получатель видит номер и вводит цифры

Пользователь видит входящий вызов, смотрит на последние 4–6 цифр номера и вводит их как код подтверждения в вашем интерфейсе.

### 4. Проверьте код

Ваша программа сравнивает введённые цифры с тем кодом, который был в запросе.

<Note>
Для этого канала можно подключить **умные сервисы**:

- [HLR →](https://docs.mydialogi.ru/07-smart-services/02-hlr/hlr) — проверка номера.
- [MNP →](https://docs.mydialogi.ru/07-smart-services/03-mnp/mnp) — определение оператора.
- [IMSI →](https://docs.mydialogi.ru/07-smart-services/04-imsi/imsi) — защита от подмены SIM.
- [AMD →](https://docs.mydialogi.ru/07-smart-services/01-amd/amd) — определение автоответчиков.

[Как подключить умные сервисы →](https://docs.mydialogi.ru/07-smart-services/00-overview/smart-how-to-connect)
</Note>

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

- [ ] Канал FlashCall подключён к вашему аккаунту — обратитесь в поддержку сервиса.
- [ ] У вас есть **API-ключ** с правами `omni-api` — [API-ключи →](https://docs.mydialogi.ru/06-reference/01-api/api-keys).
- [ ] У вас есть имя отправителя FlashCall со статусом **Активно** — [Имя отправителя для голосовых каналов →](https://docs.mydialogi.ru/05-channels/09-voice/sender-id).
- [ ] Ваша программа готова к интеграции с API.

## Что содержит

| Поле | Обязательность | Что указать |
|---|---|---|
| **code** | Обязательно | Цифры кода — **4–6 цифр**. Платформа подберёт номер с этими последними цифрами |
| **dial_timeout** | Опционально | Время в секундах до остановки звонка, если не ответили |

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

### 1. Обратитесь в поддержку сервиса

Напишите на почту поддержки вашего сервиса с запросом на подключение FlashCall.

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

### 2. Дождитесь подключения канала

Поддержка подключит канал к вашему аккаунту и зарегистрирует имя отправителя FlashCall.

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

В личном кабинете: **API Подключения** → **Создать API подключение**.

- Включите права `omni-api` и `statistics`.
- Выберите имя отправителя FlashCall.

[API-ключи →](https://docs.mydialogi.ru/06-reference/01-api/api-keys)

### 4. Интегрируйте отправку в программу

Используйте API-ключ в запросах — см. пример ниже.

Обзоры API:

- [Обзор API OTP-кодов →](https://docs.mydialogi.ru/02-otp/08-api/otp-api-overview)
- [Обзор API Multi API →](https://docs.mydialogi.ru/03-multiapi/02-api/mapi-101-api-overview)

## Как отправить код

**Эндпоинт:** `POST /api/v1/messages`

**Заголовки:**

- `Content-Type: application/json`
- `X-API-Key: <ваш-ключ>`

**Пример тела запроса:**

```json
{
  "channel": 14,
  "contact": "905063565285",
  "senderId": "flashcallSenderId",
  "payload": {
    "code": "1234",
    "dial_timeout": 5
  }
}
```

**Что здесь что:**

| Поле | Что означает |
|---|---|
| `channel: 14` | Канал FlashCall |
| `contact` | Номер получателя |
| `senderId` | Имя отправителя FlashCall |
| `code` | Цифры кода — платформа подберёт номер с этими последними цифрами |
| `dial_timeout` | Секунды до остановки звонка |

<Note>
**`code` — цифры, которые задаёт клиент.** Платформа звонит с номера, у которого последние 4–6 цифр совпадают с `code`. Получатель видит их и вводит как код.
</Note>

## Как это работает для получателя

### 1. Пользователь инициирует действие

Например, регистрацию или вход в ваш сервис.

### 2. Сервис информирует о звонке и коде

Ваш сервис сообщает пользователю, например в форме ввода нмера для отправки кода, что код придёт **в номере телефона звонящего**, и указывает, **сколько последних цифр нужно ввести** — например, «4 последние цифры номера входящего звонка».

### 3. Система совершает короткий звонок

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

### 4. Пользователь вводит последние цифры

Пользователь вводит последние цифры номера в вашем интерфейсе — столько, сколько было указано.

### 5. Проверка кода

Ваша программа сверяет введённые цифры с тем кодом, что был в запросе. Если совпадает — действие подтверждено.

## Результат

FlashCall-сообщение настроено, программа интегрирована. Коды можно отправлять.

- [Что такое TTS →](https://docs.mydialogi.ru/05-channels/09-voice/tts)
- [Что такое Voice →](https://docs.mydialogi.ru/05-channels/09-voice/voice)
- [Что такое каскад →](https://docs.mydialogi.ru/05-channels/00-overview/cascade)

> **Сколько это стоит?**
> FlashCall тарифицируется за звонок.
> Подробнее: [Обзор тарифов →](https://docs.mydialogi.ru/06-reference/02-pricing/pricing-overview).

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

### Канал не подключён

**Причина:** FlashCall не активирован для вашего аккаунта.

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

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

### Звонок не приходит

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

**Решение:** проверьте номер. В каскаде сообщение уйдёт по следующему каналу.

[Что такое каскад →](https://docs.mydialogi.ru/05-channels/00-overview/cascade)

### Звонок обрывается

**Причина:** слишком маленькое значение `dial_timeout`.

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

### Ошибка 401 Unauthorized

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

**Решение:** проверьте заголовок `X-API-Key` и права ключа.

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

### Пользователь не знает, сколько цифр вводить

**Причина:** сервис не сообщил пользователю, сколько последних цифр номера нужно ввести.

**Решение:** добавьте на вашем сайте подсказку — «введите N последних цифр номера входящего звонка». Например, «введите 4 последние цифры входящего звонка».

### Пользователь не понял

**Причина:** нет инструкции на вашем сайте.

**Решение:** добавьте подсказку — «введите N последних цифр номера входящего звонка».

### Персонализация не подставляется

**Причина:** неверный ключ атрибута.

**Решение:** проверьте формат — например, `{{attribute.name}}`.

[Управление атрибутами →](https://docs.mydialogi.ru/04-mydialogi/03-contacts/md-504-attributes)

## См. также

<Columns cols={2}>
  <Card title="Что такое TTS" icon="volume-high" href="/05-channels/09-voice/tts">
    Текст в голосовой вызов
  </Card>
  <Card title="Что такое Voice" icon="microphone" href="/05-channels/09-voice/voice">
    Полноценные голосовые вызовы
  </Card>
  <Card title="Что такое каскад" icon="arrow-progress" href="/05-channels/00-overview/cascade">
    Автоматическое переключение между каналами
  </Card>
  <Card title="Обзор API OTP-кодов" icon="book" href="/02-otp/08-api/otp-api-overview">
    OMNI API, Broadcasts API, 2FA
  </Card>
</Columns>

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

- **OTP-коды:** support@otpcod.ru
- **Multi API:** support@multiapi.ru
- **Мой диалог:** support@mydialogi.ru