метод REST scope: telephony

voximplant.callback.start

Запустить обратный звонок

Кто может выполнять: пользователь с правом Исходящий звонок — Выполнение

Описание

Метод voximplant.callback.start запускает обратный звонок между сотрудником и клиентом.

Параметры

FROM_LINE string обязательный

Идентификатор исходящей линии, с которой запускается обратный звонок.

Список доступных линий можно получить методом voximplant.line.get

TO_NUMBER string обязательный

Номер клиента, на который нужно позвонить

TEXT_TO_PRONOUNCE string обязательный

Текст, который система произнесет сотруднику перед соединением с клиентом

VOICE string необязательный

Идентификатор голоса для синтеза речи.

Если не передан, используется голос по умолчанию для языка портала.

Список доступных голосов можно получить методом voximplant.tts.voices.get

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"FROM_LINE":"reg151083","TO_NUMBER":"79991234567","TEXT_TO_PRONOUNCE":"Вам поступил запрос на обратный звонок","VOICE":"ruinternalfemale"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/voximplant.callback.start

Ответ

HTTP-статус: 200

{
    "result": {
        "RESULT": true,
        "CALL_ID": "callback.72f42b118e019a4cc47629ff60525f43.1773736077"
    },
    "time": {
        "start": 1773736066,
        "finish": 1773736067.708955,
        "duration": 1.7089550495147705,
        "processing": 1,
        "date_start": "2026-03-17T11:27:46+03:00",
        "date_finish": "2026-03-17T11:27:47+03:00",
        "operating_reset_at": 1773736666,
        "operating": 0.9574570655822754
    }
}

Возвращаемые данные

result object

Объект с результатом запуска обратного звонка

RESULT boolean

Признак успешного запуска.

true — обратный звонок успешно запущен

CALL_ID string

Идентификатор звонка

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "ERROR_CORE",
    "error_description": "Could not find line reg000000"
}
Код Описание Значение
ERROR_CORE Could not find line <LINE_ID> Линия с указанным идентификатором не найдена
ERROR_CORE Could not find config for number <LINE_ID> Не найдена конфигурация для указанной линии
ERROR_CORE Phone number is not correct Некорректный номер в TO_NUMBER
ACCESS_DENIED Access denied Недостаточно прав на выполнение исходящих звонков

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.