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

Описание

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

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

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

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

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

Индекс

217

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

refer_attended

Типы сценариев

IVR

Стартовый модуль

r_sip_ivr_script_component_refer_attended

Режим

Асинхронный

Иконка

217

Характер разветвления

Разветвляющий, прерывающий

Свойства

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 сценарии, содержащиеся в текущем домене.

Название: Значения переменных
Код: ivrScriptVarValuesT
Усл. видимости: да
По умолчанию: — 

Таблица начальных значений для локальных переменных IVR сценария, запускаемого для предварительного воспроизведения вызываемому абоненту.

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

Ключи - названия переменных сценария IVR.
Сопоставление происходит по именам переменных, значения присваиваются только тем переменным, которые определены в сценарии.

Если запускаемый сценарий IVR передает управление вложенному, то присвоение значений каждой из указанных переменных производится не более одного раза, но может откладываться вплоть до загрузки вложенного сценария, имеющего переменную с соответствующим именем.

Установленные таким образом значения приоритетны перед значениями по умолчанию внутри сценария IVR.

Название: Параметр 1
Код: param1
Усл. видимости: да
По умолчанию: — 

Первый параметр для инициируемого IVR-сценария. Доступ к значению осуществляется через функцию выражений startparam(1) или через сохранение значения в компоненте Старт.

Название: Параметр 2
Код: param2
Усл. видимости: да
По умолчанию: — 

Второй параметр для инициируемого IVR-сценария. Доступ к значению осуществляется через функцию выражений startparam(2).

Название: Параметр 3
Код: param3
Усл. видимости: да
По умолчанию: — 

Третий параметр для инициируемого IVR-сценария Доступ к значению осуществляется через функцию выражений startparam(3).

Название: Параметр 4
Код: param4
Усл. видимости: да
По умолчанию: — 

Четвертый параметр для инициируемого IVR-сценария. Доступ к значению осуществляется через функцию выражений startparam(4).

Название: Параметр 5
Код: param5
Усл. видимости: да
По умолчанию: — 

Пятый параметр для инициируемого IVR-сценария. Доступ к значению осуществляется через функцию выражений startparam(5).

Название: Прочие параметры
Код: paramsOther
Усл. видимости: да
По умолчанию: — 

JSON-массив, содержащий параметры 6, 7, 8 и т.д. для инициируемого IVR-сценария. Доступ к значению осуществляется через функцию выражений startparam(N), где N > 6.

Название: Время 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 сценария предварительного воспроизведения.

См. также