Функция Call Interactive позволяет в качестве действия опции контекста IVR инициировать HTTP-запрос на заданный URL и обработать ответ на него. С запросом передается постоянный набор параметров, содержащий информацию о вызове в IVR, эти параметры располагаются в строке запроса (при методе GET) или в теле запроса (при методе POST). URL и метод запросы может быть задан при настройке действия опции контекста IVR.

Конфигурации Call Interactive

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

Имя	Тип	Описание
CallID	`string`	Уникальный идентификатор вызова.
CallerIDNum	`string`	Номер вызывающего абонента.
CallerIDName	`string`	Имя вызывающего абонента.
CalledDID	`string`	Внешний вызываемый номер. Присутствует, если доступен.
CalledExtension	`string`	Номер IVR в расширенном формате (например: `yyyy*zzz`).
CalledExtensionID	`integer`	Идентификатор добавочного IVR в системе
CallStatus	`string`	Статус вызова, всегда имеет значение ANSWER
CallFlow	`string`	Поток вызовов, всегда имеет значение IN
CallerExtension	`string`	Имя добавочного номера, осуществляющий вызов IVR. Присутствует только при внутреннем вызове.
CallerExtensionID	`integer`	Идентификатор добавочного номера, осуществляющего вызов IVR. Присутствует только при внутреннем вызове.
CalledNumber	`string`	Номер, который набирала вызывающая сторона (может быть внешним номером: `003258422544`, номером IVR в расширенном формате: `0003*001` или коротким номером IVR: `001`).
CallAPIID	`string`	Идентификатор звонка. Автоматически генерируется и сохраняется на протяжении всего звонка вне зависимости от того, переводится ли он.

Переменные в строке запроса

Структура ответа

Ответ на запрос Call Interactive не является обязательным и нужен, если требуется совершить какое-либо действие.

Ответ на запрос должен быть сформирован в формате XML и иметь следующую структуру:

<?xml version="1.0" encoding="UTF-8"?>
<Response>
     Action
</Response>

где Action может быть одним из ниже перечисленных действий.

Варианты действий

Hangup

Немедленно завершает звонок.

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Hangup/>
</Response>

Pause

Приостанавливает звонок на заданное атрибутом length тега Pause число секунд. Если значение не задано, то по умолчанию принимается 10.

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Pause length="15" />
</Response>

SetVar

Задает значение переменной для IVR. Имя переменной должно содержатся в атрибуте name тега SetVar, а значение – содержимым это тега.

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <SetVar name="transferDestination">09897987</SetVar>
</Response>
Jump

Осуществляет переход к заданной опции заданного контекста IVR. Идентификатор контекста и опция задаются атрибутами context и option тега Jump.

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Jump context="3" option="start"/>
</Response>

SetCallerId

Задает номер вызывающего абонента и имя вызывающего абонента в среде IVR. Номер и имя задаются атрибутами name и number тега SetCaller.

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <SetCaller name="callerName" number="92992"/>
</Response>

#Call Interactive