Incoming Call OTP — подтверждение номера входящим звонком

Q: Платит ли пользователь за звонок?

В режиме маяка (missed) — нет: мы сбрасываем звонок без ответа, и оператор его не тарифицирует. В режимах listen, press и say мы отвечаем на звонок — он оплачивается как обычный исходящий по тарифу пользователя. Для маяка (missed) звонок бесплатный в любом случае.

Q: На какой номер звонит пользователь?

На номер из поля call_to в ответе API. Это один из наших номеров Tele2 или Kcell, свободный в этот момент. Номер работает только для этого пользователя и только пока жив код (ttl, по умолчанию 2 минуты).

Q: Как я узнаю, что номер подтверждён?

Для missed, press и say проверяем мы сами — придёт вебхук со статусом verified на ваш callback_url. Для listen код вводит пользователь у вас, а вы проверяете его запросом POST /api/v1/otp/{id}/check.

Q: Можно ли выбрать язык и голос?

Да. language — один язык или несколько по порядку, например ["kk","ru"]: подсказки прозвучат на обоих. voice — любой голос из каталога синтеза (GET /api/v1/sounds/voices). Назвать код вслух можно на русском и казахском.

Как это работает, по шагам

Пользователь сам звонит нам. Мы видим, с какого номера пришёл звонок, и подтверждаем номер

Пользователь вводит номер На вашем сайте или в приложении: +7 701 123 45 67.
Ваш сервер просит номер для звонка Запрос POST /api/v1/otp/incoming-call, в ответе поле call_to.
Приложение показывает кнопку Кнопка сразу открывает набор: tel:+77470000000.
Пользователь звонит сам С того же номера. Мы видим, кто звонит и куда. Что он услышит, зависит от type.
Вам приходит вебхук Статус verified: номер подтверждён. Не позвонил за 2 минуты — expired.
Готово Пользователь вошёл. Код вводить не пришлось.

Способ	Что вам нужно показать пользователю	Что он слышит, когда звонит	Цена
Маяк `missed`	Только кнопку «Позвонить»	Гудки «занято». Мы не берём трубку, поэтому звонок для него бесплатный	от 2 ₸
Прослушать `listen`	Кнопку «Позвонить» и поле для ввода кода	Автоответчик называет вашу компанию и код	от 5 ₸
Набрать `press`	Кнопку «Позвонить» и код, который надо набрать	«Наберите код на клавиатуре телефона»	от 3 ₸
Назвать `say`	Кнопку «Позвонить» и цифры или слово, которое надо сказать	«Назовите код». Пользователь говорит его вслух, на русском или казахском	от 7 ₸

Что важно знать

Звонить нужно с того номера, который вы передали в number. Звонок с другого номера не засчитается.
Со скрытым номером не получится: такой звонок сбрасывается сразу.
Номер call_to работает только для этого пользователя и только ttl секунд: по умолчанию 120, можно от 30 до 300.
Новый запрос на тот же номер отменяет предыдущий: старый call_to перестаёт работать.
В способах listen, press и say мы берём трубку, и пользователь платит за звонок как за обычный исходящий по своему тарифу. Маяк missed для него бесплатный.

Почему входящий звонок

Тот же простой опыт, что у Flash Call, но звонит пользователь

Законная замена Flash Call

С 1 ноября 2026 года Flash Call и голосовые коды в AutoCall.kz прекращают работу. Входящий звонок — не автоматический вызов с кодом: звонит сам пользователь.

Для пользователя бесплатно

В режиме маяка мы сбрасываем звонок без ответа — оператор его не тарифицирует. Пользователь ничего не платит.

Без интернета

Обычный звонок с любого телефона, на всех операторах Казахстана. Подходит там, где не доходят SMS и нет мобильного интернета.

Сложно подделать

Засчитываем только звонок с номера пользователя на номер, выданный именно ему, и только пока жив код. Для самой сильной защиты берите press или say.

Четыре сценария

Сбросить, продиктовать код, принять код с клавиатуры или голосом — под вашу задачу и уровень защиты.

Языки и голоса

Подсказки на русском, казахском, английском — сразу на нескольких. Любой из 30 голосов синтеза.

Кнопка и вебхук

Что показать на экране и что придёт на ваш сервер

HTML

кнопка «Позвонить» на экране

<a href="tel:+77470000000">
Позвоните для подтверждения: +7 747 000 00 00
</a>

POST

вебхук: номер подтверждён

POST https://example.kz/otp-hook
{
"otp": {
"id": 1044,
"channel": "incoming-call",
"type": "missed",
"number": "+77010000000",
"status": "verified",
"verified_at": "2026-11-02 10:00:21"
}
}

Примеры для каждого сценария

Запрос и ответ — переключайте вкладки

POST от 2 ₸

/api/v1/otp/incoming-call — flash

POST /api/v1/otp/incoming-call
Authorization: Bearer {ваш_токен}
Content-Type: application/json
{
"number": "+77010000000",
"type": "missed",
"callback_url": "https://example.kz/otp-hook"
}

201 Created

response

← 201 Created
{
"id": 1044,
"channel": "incoming-call",
"type": "missed",
"number": "+77010000000",
"code": null, // кода нет — подтверждает сам звонок
"call_to": "+77470940670", // покажите: «Позвоните на этот номер»
"status": "pending",
"expires_at": "2026-11-02 10:02:00"
}

POST от 5 ₸

/api/v1/otp/incoming-call — listen

POST /api/v1/otp/incoming-call
Authorization: Bearer {ваш_токен}
Content-Type: application/json
{
"number": "+77010000000",
"type": "listen",
"brand": "Clinic Plus",
"language": ["kk", "ru"],
"voice": "Kore"
}

201 Created

response

← 201 Created
{
"id": 1046,
"channel": "incoming-call",
"type": "listen",
"number": "+77010000000",
"code": "4821", // не показывайте — его продиктуем
"call_to": "+77470940670",
"status": "pending",
"expires_at": "2026-11-02 10:02:00"
}

POST от 3 ₸

/api/v1/otp/incoming-call — press

POST /api/v1/otp/incoming-call
Authorization: Bearer {ваш_токен}
Content-Type: application/json
{
"number": "+77010000000",
"type": "press",
"language": ["kk", "ru"],
"callback_url": "https://example.kz/otp-hook"
}

201 Created

response

← 201 Created
{
"id": 1045,
"channel": "incoming-call",
"type": "press",
"number": "+77010000000",
"code": "4821", // покажите на экране
"call_to": "+77470940670", // куда звонить
"status": "pending",
"expires_at": "2026-11-02 10:02:00"
}

POST от 7 ₸

/api/v1/otp/incoming-call — say

POST /api/v1/otp/incoming-call
Authorization: Bearer {ваш_токен}
Content-Type: application/json
{
"number": "+77010000000",
"type": "say",
"code": "Домино",
"callback_url": "https://example.kz/otp-hook"
}

201 Created

response

← 201 Created
{
"id": 1047,
"channel": "incoming-call",
"type": "say",
"number": "+77010000000",
"code": "Домино", // цифры или слово
"call_to": "+77470940670",
"status": "pending",
"expires_at": "2026-11-02 10:02:00"
}

Переход с Flash Call

Пользователь по-прежнему видит номер на экране — меняется только направление звонка

Параметр	Flash Call	Входящий звонок
Кто звонит	Мы — пользователю	Пользователь — нам
С 1 ноября 2026	✗ прекращает работу	✓ работает
Что видит пользователь	Входящий звонок, код в номере	Номер и кнопку «Позвонить»
Для пользователя	бесплатно	бесплатно (маяк)
Нужен интернет	нет	нет
Код в приложении вводить	да	нет (маяк, набрать, назвать)
Абонентская плата	Нет	Нет

В API меняется адрес и одно поле: POST /api/v1/flash-calls → POST /api/v1/otp/incoming-call с "type": "missed".

Попробуйте прямо сейчас

Подтвердите свой номер так, как это сделают ваши пользователи — без регистрации, бесплатно

Способ

Входящий звонок Flash Call Голосовой код

Как

Маяк — сбросим сами Прослушать код Набрать код Назвать код

Ваш номер

Демонстрация ограничена: два кода в сутки на номер. В аккаунте таких ограничений нет.

Тарифы на коды подтверждения

Без абонентской платы и договора — тариф определяется суммой пополнения

Направление

BRONZE

5 ₸—

за код входящим звонкомв этой стране недоступно

любой платёж

Коды подтверждения (OTP)

WhatsApp 19.5 ₸/шт
Telegram 12 ₸/шт
SMS 37.3 ₸/штнедоступно
Входящий звонок: маяк 5 ₸/штнедоступно
Входящий: прослушать код 12 ₸/штнедоступно
Входящий: набрать код 6 ₸/штнедоступно
Входящий: назвать код 14 ₸/штнедоступно

SILVER

3 ₸—

за код входящим звонкомв этой стране недоступно

платёж от 30 000 ₸

Коды подтверждения (OTP)

WhatsApp 13.5 ₸/шт
Telegram 9 ₸/шт
SMS 23.25 ₸/штнедоступно
Входящий звонок: маяк 3 ₸/штнедоступно
Входящий: прослушать код 8 ₸/штнедоступно
Входящий: набрать код 4 ₸/штнедоступно
Входящий: назвать код 10 ₸/штнедоступно

GOLD

2 ₸—

за код входящим звонкомв этой стране недоступно

платёж от 2 000 000 ₸

Коды подтверждения (OTP)

WhatsApp 11 ₸/шт
Telegram 7 ₸/шт
SMS 18.95 ₸/штнедоступно
Входящий звонок: маяк 2 ₸/штнедоступно
Входящий: прослушать код 5 ₸/штнедоступно
Входящий: набрать код 3 ₸/штнедоступно
Входящий: назвать код 7 ₸/штнедоступно

Страны и каналы

Казахстан — все каналы. Другие страны — коды в WhatsApp и Telegram на мобильные номера.

Страна	WhatsApp	Telegram	SMS	Входящий звонок
Казахстан	13.5 ₸	9 ₸	23.25 ₸	от 3 ₸
Азербайджан	16 ₸	9 ₸	недоступно	недоступно
Армения	16 ₸	9 ₸	недоступно	недоступно
Беларусь	16 ₸	9 ₸	недоступно	недоступно
Грузия	16 ₸	9 ₸	недоступно	недоступно
Кыргызстан	6 ₸	9 ₸	недоступно	недоступно
Молдова	16 ₸	9 ₸	недоступно	недоступно
Россия	30 ₸	9 ₸	недоступно	недоступно
Таджикистан	8.5 ₸	9 ₸	недоступно	недоступно
Туркменистан	8.5 ₸	9 ₸	недоступно	недоступно
Узбекистан	8.5 ₸	9 ₸	недоступно	недоступно
Украина	16 ₸	9 ₸	недоступно	недоступно

Цена за доставленный код. В WhatsApp она зависит от страны, в Telegram одна для всех. Входящий звонок — цена маяка, с диктовкой или набором кода дороже. Номер передавайте в формате E.164, например +998901234567.

Все тарифы — звонки, SMS, ИИ-агенты →

Частые вопросы

Чем входящий звонок отличается от Flash Call?

При Flash Call звонили мы, и кодом были последние цифры нашего номера. При входящем звонке звонит сам пользователь — на номер, который вы показываете на экране. Для пользователя всё так же просто: увидел номер, нажал «Позвонить».

Законно ли подтверждение входящим звонком?

Пункт 3-1 статьи 21 Закона РК «О связи» запрещает операторам пропускать автоматические вызовы, которые передают коды. При входящем звонке мы никому не звоним — звонит сам пользователь, обычным исходящим вызовом со своего телефона.

Платит ли пользователь за звонок?

В режиме маяка (missed) — нет: мы сбрасываем звонок без ответа, и оператор его не тарифицирует. В режимах listen, press и say мы отвечаем на звонок — он оплачивается как обычный исходящий по тарифу пользователя.

На какой номер звонит пользователь?

На номер из поля call_to в ответе API. Это один из наших номеров Tele2 или Kcell, свободный в этот момент. Номер работает только для этого пользователя и только пока жив код (ttl, по умолчанию 2 минуты).

Как я узнаю, что номер подтверждён?

Для missed, press и say проверяем мы сами — придёт вебхук со статусом verified на ваш callback_url. Для listen код вводит пользователь у вас, а вы проверяете его запросом POST /api/v1/otp/{id}/check.

Что если пользователь позвонит с другого номера?

Номер не подтвердится: мы сверяем пару «номер пользователя + номер из call_to». Звонок с чужого телефона пойдёт обычным путём, а заявка дождётся звонка с правильного номера или истечёт.

Сколько стоит?

Маяк — от 2 ₸, набрать код — от 3 ₸, прослушать код — от 5 ₸, назвать код — от 7 ₸, в зависимости от тарифа. Без абонентской платы.

Можно ли выбрать язык и голос?

Да. language — один язык или несколько по порядку, например ["kk","ru"]: подсказки прозвучат на обоих. voice — любой голос из каталога синтеза (GET /api/v1/sounds/voices). Назвать код вслух можно на русском и казахском.

Подтверждение номера входящим звонком

Как это работает, по шагам

Что важно знать

Почему входящий звонок

Законная замена Flash Call

Для пользователя бесплатно

Без интернета

Сложно подделать

Четыре сценария

Языки и голоса

Кнопка и вебхук

Примеры для каждого сценария

Переход с Flash Call

Попробуйте прямо сейчас

Тарифы на коды подтверждения

Страны и каналы

Частые вопросы

Чем входящий звонок отличается от Flash Call?

Законно ли подтверждение входящим звонком?

Платит ли пользователь за звонок?

На какой номер звонит пользователь?

Как я узнаю, что номер подтверждён?

Что если пользователь позвонит с другого номера?

Сколько стоит?

Можно ли выбрать язык и голос?

Другие способы подтверждения

WhatsApp OTP

Telegram OTP

Все способы и SMS

Переходите с Flash Call до 1 ноября