Confirmation: звонки для авторизации, API

📋 Назначение метода

Для запуска звонка подтверждения используется метод POST /api/protected/api/auth/confirmationCall, расположенный в разделе «Интеграции» → «Методы API» → «Платные методы».

Метод позволяет выполнить идентификационный звонок клиенту.

Как работает звонок

1. Система совершает вызов на указанный номер клиента.
2. Звонок выполняется с номеров MCN Telecom — подключать собственные номера не требуется.
3. После ответа клиента воспроизводится голосовое сообщение с просьбой нажать цифру 9.
4. Для абонента звонок бесплатный.
5. Вызов метода API является платным и стоит от 50 копеек.

Для связи API-запроса с конкретным звонком используется специальный верификационный код (verification_call_uuid), который возвращается в ответе метода.

---

🚀 Пример запроса

curl -X 'POST' \
'https://paidmethods.mcn.ru/api/protected/api/auth/confirmationCall' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Sec-Fetch-Mode: cors' \
-H 'Authorization: Bearer <ТОКЕН>' \
-d '{
  "phone_number": "79777777777"
}'

---

⚙️ Параметры запроса

Параметр	Описание
phone_number	Номер телефона клиента, на который будет выполнен звонок.

---

✅ Успешный ответ

{
  "status": "success",
  "code": 200,
  "object": {
    "login_did": "7777777777",
    "code": "2463",
    "account_id": "117793",
    "verification_call_uuid": "119214e015ed_117793"
  }
}

Расшифровка параметров ответа

Параметр	Описание
status	Статус выполнения запроса. Значение success означает успешное выполнение.
code	HTTP-код ответа.
login_did	Номер, с которого был выполнен звонок.
verification_call_uuid	Уникальный верификационный идентификатор звонка.

---

🔗 Параметр verification_call_uuid

Пример значения:

fa278be48dc2_117793

Где:

• fa278be48dc2 — идентификатор звонка;
• 117793 — лицевой счёт клиента.

Этот идентификатор используется для связи:

• вызова API;
• информации о звонке (CDR);
• данных, получаемых через веб-хук.

Чтобы получать сведения о звонке, необходимо подключить веб-хук Flash call в разделе «Интеграции». После этого на указанный URL будут отправляться данные о вызове, включая параметр:

"verification_call_uuid": "fa278be48dc2_117793"

По этому значению можно однозначно определить, какому вызову API соответствует полученный CDR.

---

📡 Callback: статусы верификационного звонка

✅ Звонок успешно принят

"q931_status": 16,
"final_status": "ANSWER"

---

☎️ Абонент занят

"q931_status": 17,
"final_status": "CANCEL"

---

⏳ Звонок не был принят

"q931_status": 16,
"final_status": "CANCEL"

---

❌ Вызов не прошёл через сеть ОКС-7

Встречный оператор отклонил вызов.

"q931_status": 31

---

💳 Ошибка биллинга

Звонок не выполнен из-за проблем биллинговой системы.

"q931_status": 41

---

🚫 Номер недоступен

Все остальные значения q931_status, кроме:

• 16
• 17
• 31

означают, что номер недоступен.

---

🔔 Создание веб-хука для получения CDR

Для получения информации о звонке в привязке к вызову API необходимо:

1. Перейти в раздел «Интеграции» → «Веб-хуки».
2. Создать подписку на событие «Password call».
3. Указать URL, на который будут отправляться данные о звонке.

Тело запроса

В поле «Тело запроса» необходимо указать JSON-массив переменных, которые будут передаваться на указанный URL.

Просмотр событий

Историю отправки событий можно просматривать в разделе «Мониторинг».

---

🆘 Поддержка и помощь
❓ Заявки в техническую поддержку | 📚 База знаний MCN Telecom | ☎️ +7 (495) 105-99-99 | 📧 info@mcn.ru

Была ли эта статья полезной

Да, полезнаНет, не полезна