Вызов исходящего звонка с внутреннего номера ВАТС через API

14 просмотра

Создано 27.01.2026

Обновлено 14.07.2026

📌 Краткое описание

Метод outbound VPBX используется для выполнения исходящего звонка через API VPBX.

Для запроса используется метод POST и заголовок авторизации Authorization Bearer с токеном доступа.

🔐 Требования

Для выполнения запроса нужен токен доступа.

Токен доступен в разделе «Интеграции» → «Токены».

Важно: токен есть только у администратора и относится только к тому лицевому счету, который установлен по умолчанию. Подробнее см. статью «Как получить токен».

➡️ Переход в раздел

Откройте раздел «Интеграции».
Перейдите на вкладку «Методы API».
В меню слева выберите «Виртуальная АТС».
В блоке методов calls выберите POST /api/protected/calls/vpbx/outbound — Create outbound call.

⚙️ URL метода

Используйте URL:

https://vpbx.mcn.ru/api/protected/calls/vpbx/outbound

При отправке HTTP-запроса методом POST на этот URL API инициирует исходящий звонок через VPBX.

📝 Порядок действий

1. Укажите заголовки запроса

Передайте токен доступа в заголовке Authorization Bearer:

Authorization: Bearer ВАШ_ТОКЕН

Также укажите тип передаваемых данных:

Content-Type: application/json

2. Сформируйте тело запроса

Укажите параметры звонка в теле запроса:

{
  "timeoutFrom": "ВРЕМЯ_ВЫПОЛНЕНИЯ_ЗВОНКА_АБОНЕНТУ",
  "vpbxId": "ИДЕНТИФИКАЦИОННЫЙ_НОМЕР_ВАШЕЙ_ВИРТУАЛЬНОЙ_АТС",
  "fromNumber": "ВНУТРЕННИЙ_НОМЕР_ВИРТУАЛЬНОЙ_АТС",
  "toNumber": "ВНЕШНИЙ_НОМЕР_КУДА_ПОСТУПИТ_ЗВОНОК"
}

Где:

timeoutFrom — время выполнения звонка абоненту. Значение 0 означает, что ограничения на дозвон нет, но со стороны АТС действует лимит дозвона 60 секунд.
vpbxId — идентификационный номер вашей виртуальной АТС.
fromNumber — внутренний номер виртуальной АТС.
toNumber — внешний номер, на который поступит звонок.

📎 Пример запроса на PHP

Замените значения ВРЕМЯ_ВЫПОЛНЕНИЯ, ИДЕНТИФИКАЦИОННЫЙ_НОМЕР_ВАШЕЙ_ВИРТУАЛЬНОЙ_АТС, ВНУТРЕННИЙ_НОМЕР_ВИРТУАЛЬНОЙ_АТС, ВНЕШНИЙ_НОМЕР_КУДА_ПОСТУПИТ_ЗВОНОК и ВАШ_ТОКЕН на реальные данные.

$data = '{
  "timeoutFrom": ВРЕМЯ_ВЫПОЛНЕНИЯ,
  "vpbxId": ИДЕНТИФИКАЦИОННЫЙ_НОМЕР_ВАШЕЙ_ВИРТУАЛЬНОЙ_АТС,
  "fromNumber": "ВНУТРЕННИЙ_НОМЕР_ВИРТУАЛЬНОЙ_АТС",
  "toNumber": "ВНЕШНИЙ_НОМЕР_КУДА_ПОСТУПИТ_ЗВОНОК"
}';

$headers = array(
  'accept: */*',
  'Content-Type: application/json',
  'Authorization: Bearer ВАШ_ТОКЕН'
);

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://vpbx.mcn.ru/api/protected/calls/vpbx/outbound',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => $data,
  CURLOPT_HTTPHEADER => $headers
));

$response = curl_exec($curl);

curl_close($curl);

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

На главную