IBA Platform logo

Что такое FlashCall

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

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

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

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

Что это

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

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

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

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

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

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

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

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

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

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

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

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

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

  • HLR → — проверка номера.
  • MNP → — определение оператора.
  • IMSI → — защита от подмены SIM.
  • AMD → — определение автоответчиков.

Как подключить умные сервисы →

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

  • Канал FlashCall подключён к вашему аккаунту — обратитесь в поддержку сервиса.
  • У вас есть API-ключ с правами omni-api — API-ключи →.
  • У вас есть имя отправителя FlashCall со статусом Активно — Имя отправителя для голосовых каналов →.
  • Ваша программа готова к интеграции с API.

Что содержит

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

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

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

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

Контакты поддержки →

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

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

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

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

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

API-ключи →

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

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

Обзоры API:

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

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

Заголовки:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Результат

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

Сколько это стоит? FlashCall тарифицируется за звонок. Подробнее: Обзор тарифов →.

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

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

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

Контакты поддержки →

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

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

Что такое каскад →

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

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

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

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

Ошибка 401 →

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

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

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

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

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

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

Управление атрибутами →

См. также

Что такое TTS

Текст в голосовой вызов

Что такое Voice

Полноценные голосовые вызовы

Что такое каскад

Автоматическое переключение между каналами

Обзор API OTP-кодов

OMNI API, Broadcasts API, 2FA

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