Компонент Перевод с контролируемым вызовом

Содержание

Описание
Свойства
См. также

Описание

Производит контролируемый перевод на номер. Осуществляет самостоятельный вызов номера посредством нового экземпляра обработчика сценариев IVR, откладывая непосредственно перевод до момента, когда абонент уже ответил и ожидает. После ответа абонента, ему может быть предварительно воспроизведен IVR сценарий. Непосредственно перевод осуществляется отправкой абоненту SIP-запроса REFER с атрибутом Replaces.
Вызов абонента может быть осуществлен с любыми параметрами, в том числе и без последующего выполнения IVR-сценария. После успешного завершения операции выполнение основной ветки сценария прерывается. На любом шаге процесса может произойти плановый отказ, тогда управление передается следующему компоненту по соответствующей ветке перехода.

Автоматически производит подписку на получение событий о состоянии перевода. Общее время работы компонента складывается из времени набора указанного номера, ожидания ответа, активности IVR-сценария предварительного воспроизведения.
Некоторые абонентские устройства и приложения осуществляют запрос к пользователю с ожиданием его подтверждения при подмене звонка. Это может неограниченно увеличить время операции. Однако спустя 60 секунд управление в любом случае будет передано следующему компоненту по ветке "Время подписки".

При вызове абонента по номеру используется стандартный процесс маршрутизации от имени текущего сценария IVR.

При необходимости следует заполнять интервал ожидания соединения мелодией фонового воспроизведения (предварительно установленный компонент воспроизведения). Медиа-режим sendonly с автоматически подключаемой мелодией ожидания активируется только непосредственно перед отправкой запроса REFER, и в случае компонента контролируемого перевода является кратковременным и не обеспечивает функциональности воспроизведения в полной мере.

Table 1. Системные характеристики

Индекс	`217`
Краткое название	`refer_attended`
Типы сценариев	`IVR`
Стартовый модуль	`r_sip_ivr_script_component_refer_attended`
Режим	Асинхронный
Иконка
Характер разветвления	Разветвляющий, прерывающий

Свойства

Table 2. Свойства
Спецификация	Описание
Название: `Номер` Код: `number` Усл. видимости: `нет` По умолчанию: —	Аргумент, содержащий телефонный номер абонента для осущствления на перевода.
Название: `Исходящий номер` Код: `callerId` Усл. видимости: `нет` По умолчанию: —	Аргумент, содержащий CallerId – значение username для подстановки в URI заголовка `From` отправляемого SIP-запроса INVITE.
Название: `Исходящее имя` Код: `callerName` Усл. видимости: `нет` По умолчанию: —	Аргумент, содержащий CallerName – значение displayname для подстановки в URI заголовка `From` отправляемого SIP-запроса INVITE.
Название: `Время набора, с` Код: `dialingTimeout` Усл. видимости: `нет` По умолчанию: —	Нижнее ограничение на время вызова абонента. По умолчанию время вызова внутренних абонентов 30 секунд, и может быть изменено в свойствах учетной записи SIP-пользователя.
Название: `Источник сценария IVR` Код: `setScrMode` Усл. видимости: `нет` По умолчанию: ``	Способ выбора IVR-сценария. Возможные значения: `Не использовать` (`none`,`3`) – Не использовать сценарий, только осуществить дозвон, проконтролировать ответ и переключить. `Из списка` (`code_sel`,`2`) – Указание кода сценария с помощью аргумента. Применяет значение свойства `Сценарий`. `По коду` (`code`,`0`) – Указание кода сценария с помощью аргумента. Применяет значение свойства `Код сценария`. `JSON` (`body`,`1`) – Указание кода сценария с помощью аргумента. Применяет значение свойства `Тело сценария`
Название: `Код сценария` Код: `ivrScriptCode` Усл. видимости: `да` По умолчанию: —	Аргумент с кодом IVR-сценария в текущем домене.
Название: `Тело сценария` Код: `ivrScriptJson` Усл. видимости: `да` По умолчанию: —	Аргумент, содержащий JSON-структуру с телом IVR-сценария (упакованный в строку JSON-массив). Формат структуры аналогичен разделу `scriptdata.objects`" в сущности IVR сценария.
Название: `Сценарий` Код: `ivrScriptCodeSel` Усл. видимости: `нет` По умолчанию: —	Выпадающий список с кодами сценариев. Содержит все доступные (нескрытые) IVR сценарии, содержащиеся в текущем домене.
Название: `Параметры сценария` Код: `ivrScrParams` Усл. видимости: `нет` По умолчанию: —	Аргумент, содержащий значение первого параметра для IVR-сценария, который доступен через функцию `startparam1()` или в компоненте Старт. Если значение содержит JSON-структуру, то она рассматривается как объект, содержащий начальные значения для переменных. Ключи и значения объекта соответствуют именам переменных и их начальным значениям. Таким образом, сопоставление происходит по именам переменных, значения присваиваются только тем переменным, которые определены в сценарии. Если сценарий передает управление вложенному, то присвоение значений каждой из указанных переменных производится не более одного раза, но может откладываться вплоть до загрузки вложенного сценария, имеющего переменную с соответствующим именем. Установленные таким образом значения приоритетны перед значениями по умолчанию внутри сценария IVR.
Название: `Время IVR, c` Код: `ivrTimeout` Усл. видимости: `нет` По умолчанию: —	Таймаут ожидания выполнения IVR сценария.
Название: `Режим re-INVITE` Код: `reinviteMode` Усл. видимости: `нет` По умолчанию: `Не использовать`	Выбор режима предварительного преобразования медиа-сессии текущего диалога перед отправкой SIP-запроса REFER. Возможные варианты: `Не использовать` (`not_used`, `0`) – Не производит преобразования. `Авто` (`auto`, `1`) – По текущим настройкам системы аналогично режиму `inactive`. `sendonly` (`2`) – Переводит медиа-сессию в режим удержания путем отправки re-INVITE с SDP, где у медиа-стримов выставлен атрибут `a=sendonly`. `inactive` (`3`) – Переводит медиа-сессию в режим удержания путем отправки re-INVITE с SDP, где у медиа-стримов выставлен атрибут `a=inactive` (не соответствует RFC-6337 п.5.3.).
Название: `Код результата в переменную` Код: `resultCode` Усл. видимости: `нет` По умолчанию: —	Переменная для сохранения кода внутренней ошибки. Возможные варианты: `"001"` – Ошибка инициации вызова. `"002"` – Неудача вызова.
Название: `Описание результата в переменную` Код: `resultDescription` Усл. видимости: `нет` По умолчанию: —	Переменная для сохранения текстового описания внутренней ошибки.
Название: `SIP-код ответа в переменную` Код: `resultSipCode` Усл. видимости: `нет` По умолчанию: —	Переменная для сохранения кода SIP-ответа на исходящий запрос INVITE.
Название: `Причина SIP ответа в переменную` Код: `resultSipReason` Усл. видимости: `нет` По умолчанию: —	Переменная для сохранения фразы SIP-ответа на исходящий запрос INVITE.
Название: `Заголовки SIP ответа в переменную` Код: `resultSipHeaders` Усл. видимости: `нет` По умолчанию: —	Переменная для сохранения совокупности заголовков SIP-ответа на исходящий запрос INVITE.
Название: `Переход, время подписки` Код: `transferSubTerminated` Усл. видимости: `нет` По умолчанию: —	Компонент, которому передается управление, если истекло время подписки, а подтверждения получения окончательного ответа не последовало.
Название: `Переход, отказ` Код: `transferRejected` Усл. видимости: `нет` По умолчанию: —	Компонент, которому передается управление в случае, если при вызове получен неудачный окончательный ответ: `3xx-6xx` (на REFER или INVITE).
Название: `Переход, время` Код: `transferTimeout` Усл. видимости: `нет` По умолчанию: —	Компонент, которому передается управление в случае, если за ограниченное время не получен окончательный ответ на отправленный SIP-запрос re-INVITE или REFER.
Название: `Переход, неудача` Код: `transferFailed` Усл. видимости: `нет` По умолчанию: —	Компонент, которому передается управление в случае, если вызываемый абонент не ответил, либо ответил неудачным окончательным кодом 3xx-6xx.
Название: `Переход, ошибка` Код: `transferError` Усл. видимости: `нет` По умолчанию: —	Компонент, которому передается управление в случае, если истекло время ожидания окончательного ответа на отправленный SIP-запрос INVITE, либо завершения IVR сценария предварительного воспроизведения.

См. также

Роль ivr
Роль b2b