Блок Телефония

Воспроизведение

Осуществляет воспроизведение аудио-файла абоненту. Может инициировать как синхронное воспроизведение, так и фоновое воспроизведение. Управление фоновым воспроизведением допускает паузы и остановки. Возобновление воспроизведения возможно с указанной миллисекунды конкретного файла.

Каждый компонент Воспроизведение определяет Слой - некий идентификатор звуковой дорожки. Количество одновременных дорожек может быть до 16. При воспроизведении они микшируются. Для каждого слоя настраиваются независимые режимы воспроизведения.

Режимы воспроизведения

Режим	Описание
Файл полностью	Останавливает все воспроизведения в указанном слое и проигрывает конкретный файл для прослушивания. Файл проигрывается полностью от начала до конца и после этого осуществляется переход на следующий компонент.
Предпрослушивание	Останавливает все воспроизведения в указанном слое и проигрывает первые N секунд выбранного файла. По истечению времени проигрывание останавливается и передается управление следующему компоненту
Файл + дополнительное время	Останавливает все воспроизведения в указанном слое и проигрывает конкретный файл для прослушивания. Файл проигрывается полностью от начала до конца и после этого делается пауза перед переходом на следующий компонент (например для ожидания ответа выбора пункта меню)
Список файлов	Останавливает все воспроизведения в указанном слое и проигрывает конкретный список файлов для прослушивания. Файлы проигрывается полностью от начала до конца и после этого осуществляется переход на следующий компонент.
Фоновое воспроизведение	Определение каталога с файлами или конкретного файла который будет воспроизводится в указанном слое. Переход на следующий элемент осуществляется сразу.
Остановка фона	Останавливает проигрывание фонового воспроизведения в указанном слое, если оно было запущено ранее
Изменить громкость фона	Изменение громкости фонового воспроизведения в указанном слое. Прерывание проигрывания не будет

Громкость указывается в целых числах как делитель относительно исходного файла. Допустимые значения - 1,2,3,4,5 и т.д., где 1 = громкость исходного файла, 2 = в 2 раза тише. Если надо планомерно погасить громкость фона, то надо поставить несколько компонент Воспроизведение - Изменить громкость фона с указанием в качестве громкости абсолютные увеличивающиеся значения (между компонентами поставить компонент Пауза в 30-50мс).

Файлы воспроизведения

Воспроизведение осуществляется в PCM 8 Кгц Моно. Если файл другого формата, то перед воспроизведением он перекодируется.

В высоконагруженных IVR сценариях рекомендуется указывать компоненту Воспроизведение только wav файлы в указанном формате. Это сильно снизит загрузку системы на перекодирование.

Поддерживаемые входные форматы файлов:

• WAV файлы в кодировках:

PCM Стерео, Моно, 16 бит, 8000, 11025 16000, 22050, 24000, 32000, 44100, 48000 Гц G.711 alaw, mulaw, 8000 Гц MS GSM, 65 бит, 8000 Гц

• MP3 файлы любой bitrate

• Другие форматы звуковых файлов не поддерживаются.

Общие Свойства компонента

Название	Описание
Слой	указание слоя воспроизведения (текстовый идентификатор в рамках сценария)
Режим	Выбор одного из режимов. Подробно описано в Режимы воспроизведения выше. Специализированные поля каждого из режимов описаны ниже в Дополнительные свойства компонента
Буфер для DTMF	Переменная, куда будут сохраняться полученные DTMF символы.
Очистить буфер	Да-значение переменной Буфер для DTMF будет очищен перед выполнением текущего компонента Нет-полученные DTMF символы будут дописаны в конец переменной Буфер для DTMF
Количество символов	Ограничение количества символов DTMF. По достижению будет остановлено воспроизведение и переход на следующий компонент
Символы прерывания	Символы или их наборы, которые закончат выполнение текущего компонента. Разделение наборов через пробел или запятую.
Вырезать символы прерывания	Выключатель операции удаления символов прерывания из Буфер для DTMF после обнаружения последовательности прерывания.
Переход	Следующий Компонент сценария. Переход по-умолчанию
Переход, ошибка	Следующий Компонент сценария, если возникла ошибка воспроизведения
Описание	Описание компонента

Дополнительные свойства компонента

Режим Файл полностью

Производит воспроизведение аудио-файла с ожиданием его завершения. Если в качестве параметров указан каталог, то производится воспроизведение случайного файла из каталога.

Название	Описание
Файл	Файл для воспроизведения.Может быть выбран в одном из режимов: статический файл, приложенный к сценарию; сформированный аргументами путь к файлу или каталогу.
Громкость	Делитель громкости исходного файла
Начало, мс	Время, с которого необходимо начать проигрывать файл в мс
Конец,мс	Время, на котором необходимо закончить проигрывать файл в мс

Режим Предпрослушивание

Производит воспроизведение с ожиданием его завершения и ограничением по времени воспроизведения.

Название	Описание
Файл	Файл для воспроизведения.Может быть выбран в одном из режимов: статический файл, приложенный к сценарию; сформированный аргументами путь к файлу или каталогу.
Время,с	Ограничение на время воспроизведения, в сек.
Начало, мс	Время, с которого необходимо начать проигрывать файл
Конец,мс	Время, на котором необходимо закончить проигрывать файл

Режим Файл + дополнительное время

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

Название	Описание
Доп.время,с	Таймаут дополнительной паузы после завершения воспроизведения, в сек.
Файл	Файл для воспроизведения.Может быть выбран в одном из режимов: статический файл, приложенный к сценарию; сформированный аргументами путь к файлу или каталогу.
Начало, мс	Время, с которого необходимо начать проигрывать файл
Конец,мс	Время, на котором необходимо закончить проигрывать файл
Громкость	Делитель уменьшения громкости первоначального файла

Режим Список файлов

Производит воспроизведение последовательного списка файлов.

Название	Описание
Файлы (JSON-список)	Аргумент, содержащий JSON-структуру в виде массива строк, каждая из которых представляет путь к файлу. Файлы воспроизводятся в порядке указания в списке.
Громкость	Делитель уменьшения громкости

Пример Проиграть три файла подряд. Файлы находятся в директории syn_media(). С помощью Выражения значение аргумента может задаваться так:

"[\""+escape(makepath(syn_media(), "expressions/двести.wav"))+"\", \""+escape(makepath(syn_media(), "expressions/тысяч.wav"))+"\", \""+escape(makepath(syn_media(), "expressions/рублей.wav"))+"\"]"

Режим Фоновое воспроизведение

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

Название	Описание
Каталог	Указать каталог, в котором будут проигрываться все файлы для режима Фоновое воспроизведение.
Файл	Файл для воспроизведения.Может быть выбран в одном из режимов: статический файл, приложенный к сценарию; сформированный аргументами путь к файлу или каталогу.
Зацикливать	Управление режимом непрерывного зацикленного воспроизведения. При воспроизведении через выбор каталога, каждый новый файл выбирается случайно.

Режим Остановка фона

Производит остановку воспроизведения в указанном слое.

Не имеет специальных настроек

Режим Изменить громкость фона

Производит изменение громкости воспроизводимого в фоне файла на указанном слое.

Название	Описание
Громкость	Делитель уменьшения громкости

Чтобы уменьшить громкость, а потом ее восстановить надо

* Громкость = 4 (уменьшим в 4 раза) * Громкость = 1 (восстановим громкость файла)

Воспроизведение числительных

Осуществляется проигрывание числа, определяемого аргументом. Для проигрывания существуют несколько предустановленных голосов и можно добавлять свои. Файлы числительных для воспроизведения в локальном автоматически синхронизирующемся каталоге :SYNC в подкаталоге /common/standardexpressions/<VOICE>

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

Воспроизведение числительных

Название	Описание
Число	Аргумент, содержащий воспроизводимое числительное либо наборную фразу.
Языковой алгоритм	Выбор языкового алгоритма. Возможные варианты: RUS - Русский язык. (123 звучит как "Сто Двадцать Три") ENG – Английский язык. (123 звучит как "One Hundred and Twenty Three")
Формат	Формат проигрываемого значения. Описан ниже в Формат воспроизведения числительных
Тип проигрывания	Используется, если формат задан «По формату». Подробнее в Формат воспроизведения числительных
Род	(формат = «По формату», «Количество», «Порядковое числительное») Мужской (один, сто пятый) Женский (одна, сто шестая) Средний (одно, сто седьмое)
Понижать тон	Осуществляет понижение тона в конце. Для этого в качестве последнего файла подставляется аналогичный с символом "_" в конце, озвученный как окончание речи. При его отсутствии берется обычный файл.
Голос	Выбор голоса для воспроизведения. Каждый голос представляет собой папку с набором файлов, озвучивающих достаточно большой набор числительных и используемых дополнительных слов.
Символы прерывания	Строка, содержащая последовательности символов прерывания через запятую.
Переход	Компонент, которому передается управление в случае успешного завершения операции. Переход по-умолчанию.
Переход,ошибка	Компонент, которому передается управление в случае ошибки.
Описание	Описание компонента

Формат воспроизведения числительных

Название	Описание
По формату	Выбор формата построения фразы по значению. Возможные способы разбиения (значение поля Тип проигрывания Посимвольно – Каждая цифра числа проговаривается отдельно.(один ноль два три семь…) По 2 символа – Цифры объединяются парами(двадцать два сорок четыре…) По 3 символа – Цифры объединяются в группы по три (триста пять двести тридцать четыре…) Целиком – Число проговаривается целиком. (Двести тридцать четыре триллиона пятьсот двадцать…) Буквы и числа посимвольно – Значение проговаривается в виде отдельных букв (аббревиатур) и чисел.(один а б в тире слэш.. ) Слова и фразы – Проговариваются отдельные слова, разделенные пробелами, заранее озвученные и представленные в каталоге озвучки.
Количество	Числительное, например сто двадцать три.
Порядковое числительное	Например сто двадцать третий. Применяет род.
Телефонный номер	Допустимые формат Числа и разделить в виде - sp. Например 120-40 10 будет озвучен как сто двадцать сорок десять
Дата	01.01.2020 = первое января две тысячи двадцатого года.
Время	15:30 = пятнадцать часов тридцать минут
Дата/время	01.01.2020 15:30 = первое января две тысячи двадцатого года пятнадцать часов тридцать минут
День недели	Например, понедельник.
Время без нулей в начале	Время, где нули в начале не воспроизводятся, например: 00:20:00 = двадцать минут ноль секунд вместо ноль часов двадцать минут ноль секунд.
Время без нулей в конце	Время, где нули в конце не воспроизводятся, например: 00:20:00 ноль часов двадцать минут вместо ноль часов двадцать минут ноль секунд.
Время в секундах	600 = шестьсот секунд.
Деньги, USD	XXX долларов или XXX долларов XX центов.
Деньги, EUR	XXX евро или XXX долларов XX евроцентов.
Деньги, RUR	XXX рублей или XXX рублей XX копеек.
Процент	XX процентов.

Ввод DTMF

Осуществляет ожидание ввода абонентом символов DTMF с клавиатуры телефона. Поддерживает поставку символов по RFC-2833 и через SIP-INFO. Если необходимо получать DTMF во время проигрывания файла, то необходимо воспользоваться компонентом Воспроизведение.

Название	Описание
Таймаут,с	Общий таймаут в секундах ожидания ввода полного значения. Если таймер сработал, то Переход,время
Межсимвольный таймаут, с	Таймаут в секундах ожидания ввода следующего символа. Запускается после первого полученного символа. Каждый введенный символ сбрасывает счетчик. Если таймер сработал, то Переход,время
Буфер для DTMF	Переменная для сохранения получаемых DTMF-символов.
Очистить буфер	Да - значение переменной Буфер для DTMF будет очищен перед выполнением текущего компонента Нет - полученные DTMF символы будут дописаны в конец переменной Буфер для DTMF
Количество символов	Аргумент, содержащий ограничение на количество вводимых символов.
Символы прерывания	Строка, содержащая последовательности символов прерывания через запятую. После обнаружения на конце буфера DTMF последовательности символов, компонент завершает работу по Переход. Пример значения *, 7, 123, 9395
Вырезать символы прерывания	Да - удалит символы прерывания из переменной Буфер для DTMF Нет- не удалит символы прерывания из переменной Буфер для DTMF
Переход	Компонент, которому передается управление при завершении компонента. Переход по-умолчанию
Переход, время	Компонент, которому передается управление при завершении по таймауту.
Описание	Описание компонента

Запись

Осуществляет запись звука, поступающего от абонента, в локальный файл. Запись файла сохраняется в директорию temp текущего экземпляра сценария. Для дальнейшей работы с файлом необходимо использовать компонент Файловая операция.

Запись

Название	Описание
Режим	Выбор режима записи. Доступен единственный вариант Синхронная запись
Путь в переменную	Да - путь к записанному файлу необходимо сохранить в переменную Нет - путь сохранять не надо
Путь к файлу в переменную	Переменная для сохранения пути к файлу с записанным голосом. Файл размещается во временном каталоге сценария и будет удален после завершения работы сценария. Для длительного сохранения файла требуется дальнейшее перемещение файла сценарием в место стационарного хранения. Запись осуществляется на сервере с ролью MG, обслуживающим текущий звонок, а затем переносится на сервер с ролью IVR, обслуживающей текущий сценарий.
Кодек	Формат записываемого файла. PCM PCMa PCMu GSM MP3 8-bit MP3 16-bit MP3 24-bit
Таймаут, с	Время в течении которого будет записываться голос от абонента
Буфер для DTMF	Переменная для сохранения получаемых DTMF-символов.
Очистить буфер	Да - значение переменной Буфер для DTMF будет очищен перед выполнением текущего компонента Нет - полученные DTMF символы будут дописаны в конец переменной Буфер для DTMF
Количество символов	Аргумент, содержащий ограничение на количество вводимых символов.
Символы прерывания	Строка, содержащая последовательности символов прерывания через запятую. После обнаружения на конце буфера DTMF последовательности символов, компонент завершает работу по Переход. Пример значения *, 7, 123, 9395
Вырезать символы прерывания	Да - удалит символы прерывания из переменной Буфер для DTMF Нет- не удалит символы прерывания из переменной Буфер для DTMF
Переход	Компонент, которому передается управление при завершении операции по набору нужного числа символов. Переход по-умолчанию.
Переход, время	Компонент, которому передается управление при завершении по таймауту.
Описание	Описание компонента

SIP-ответ

Отправляет SIP-ответ на входящий INVITE, инициировавший запуск IVR сценария. Это может быть:

• предварительный ответ 1xx,

• окончательный успешный ответ 2xx,

• окончательный ответ о переадресации 3xx,

• окончательный ответ о неудаче 4xx – 6xx.

После неудачных окончательных ответов выполнение основной ветки сценария автоматически прекращается. В соответствии с протоколом SIP последовательно в течение ограниченного интервала времени (~30 секунд) может быть отправлено произвольное количество предварительных ответов, и только один окончательный.

Sip-ответ

Название	Описание
Код ответа SIP	Аргумент, содержащий код SIP-ответа. Число 1xx – 6xx. По-умолчанию 200
Текст ответа SIP	Аргумент, содержащий фразу SIP-ответа. Например Not Found для 404.
Причина	Аргумент, содержащий причину. Отправляется в SIP-ответе в заголовке Reason. По умолчанию заголовок не добавляется.
Отображаемое имя	Аргумент, содержащий имя абонента. Отправляется в SIP-ответе в качестве displayname в заголовке Remote-Party-Id и P-asserted-Identity. По умолчанию заголовок не добавляется.
Переход	Компонент, которому передается управление.
Описание	Описание компонента

Отбой (Отправка SIP-Bye пакета)

Разрывает текущий диалог отправкой SIP-запроса BYE. Если диалог еще не установлен (не был предварительно отправлен SIP-ответ 2xx), то компонент завершается ошибкой и прерывает работу основной ветки сценария.

Отбой (SIP Bye)

Название	Тип
Описание	Описание
Текст	Описание компонента

Перевод без сопровождения

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

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

Компонент выполняется до момента получения Notify сообщения об установке соединения или ошибки (например, вызываемый абонент не снял трубку). Общее время процесса перевода складывается из времени ответа на REFER, набора указанного номера и ожидания ответа. Суммарно ограничено 60 секунд (при наступлении сработает Переход, время подписки

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

Перевод

Название	Описание
Номер	Номер, на который перевести вызов
Режим re-INVITE	Выбор режима предварительного преобразования медиа-сессии текущего диалога перед отправкой SIP-запроса REFER. Возможные варианты: Не использовать – Не производит преобразования. Авто – По текущим настройкам системы аналогично режиму inactive. sendonly – Переводит медиа-сессию в режим удержания путем отправки re-INVITE с SDP, где у медиа-стримов выставлен атрибут a=sendonly. inactive – Переводит медиа-сессию в режим удержания путем отправки re-INVITE с SDP, где у медиа-стримов выставлен атрибут a=inactive (не соответствует RFC-6337 п.5.3.).
Переход, время подписки	Компонент, которому передается управление, если истекло время подписки, а подтверждения получения окончательного ответа не последовало.
Переход, отказ	Компонент, которому передается управление в случае, если при вызове получен неудачный окончательный ответ: 4xx-6xx (на REFER или INVITE).
Переход, время	Компонент, которому передается управление в случае, если за ограниченное время не получен окончательный ответ на отправленный SIP-запрос re-INVITE или REFER.
Описание	Описание компонента

Перевод с сопровождением

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

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

Компонент выполняется до момента получения Notify сообщения об установке соединения или ошибки (например, вызываемый абонент не снял трубку). Общее время процесса перевода складывается из времени ответа на REFER, набора указанного номера и ожидания ответа. Суммарно ограничено 60 секунд (при наступлении сработает Переход, время подписки

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

Перевод с сопровождением

Название	Описание
Номер	Номер назначения
Исходящий номер	Аргумент, содержащий CallerId – значение username для подстановки в URI заголовка From отправляемого SIP-запроса INVITE.
Исходящее имя	Аргумент, содержащий CallerName – значение displayname для подстановки в URI заголовка From отправляемого SIP-запроса INVITE.
Время набора, сек	Максимальное время от начала набора до получения SIP 200 OK
Источник сценария	Способ выбора IVR-сценария. Возможные значения: Не использовать – Не использовать сценарий, только осуществить дозвон, проконтролировать ответ и переключить. Из списка – Выбор сценария в поле Сценарий. Применяет значение свойства Сценарий. По коду – Указание кода сценария с помощью аргумента в поле Код сценария. Применяет значение свойства Код сценария.
Параметры сценария	Аргумент, содержащий значение первого параметра для IVR сценария, который доступен через функцию startparam1() или в компоненте Старт. Если значение содержит JSON-структуру, то она рассматривается как объект, содержащий начальные значения для переменных. Ключи и значения объекта соответствуют именам переменных и их начальным значениям. Установленные таким образом значения приоритетны перед значениями по умолчанию внутри сценария IVR.
Время IVR, сек	Максимальное время обработки в IVR сценарии сопровождения
Режим re-INVITE	Выбор режима предварительного преобразования медиасессии текущего диалога перед отправкой SIP-запроса REFER. Не использовать – Не производит преобразования. Авто – По текущим настройкам системы аналогично режиму inactive. sendonly – Переводит медиа-сессию в режим удержания путем отправки re-INVITE с SDP, где у медиастримов выставлен атрибут a=sendonly. inactive – Переводит медиа-сессию в режим удержания путем отправки re-INVITE с SDP, где у медиастримов выставлен атрибут a=inactive (не соответствует RFC-6337 п.5.3.).
Код результата в переменную	Переменная для сохранения кода внутренней ошибки. Возможные варианты: "001" – Ошибка инициации вызова. "002" – Неудача вызова.
Описание результата в переменную	Переменная для сохранения текстового описания внутренней ошибки.
SIP-код ответа в переменную	Переменная для сохранения кода SIP-ответа на исходящий запрос INVITE.
Причина SIP ответа в переменную	Переменная для сохранения фразы SIP-ответа на исходящий запрос INVITE.
Заголовки SIP ответа в переменную	Переменная для сохранения совокупности заголовков SIP ответа на исходящий запрос INVITE
Переход, время подписки	Компонент, которому передается управление, если истекло время подписки, а подтверждения получения окончательного ответа не последовало.
Переход, отказ	Компонент, которому передается управление в случае, если при вызове получен неудачный окончательный ответ: 3xx-6xx (на REFER или INVITE)
Переход, время	Компонент, которому передается управление в случае, если за ограниченное время не получен окончательный ответ на отправленный SIP-запрос re-INVITE или REFER.
Переход, неудача	Компонент, которому передается управление в случае, если вызываемый абонент не ответил, либо ответил неудачным окончательным кодом 3xx-6xx.
Переход, ошибка	Компонент, которому передается управление в случае, если истекло время ожидания окончательного ответа на отправленный SIP-запрос INVITE, либо завершения IVR сценария предварительного воспроизведения.
Описание	Описание компонента

Синтез речи (Yandex Cloud SpeechKit)

Осуществляет синтез речи по тексту и воспроизведение текущему абоненту. Сервис предоставляется облаком Yandex Cloud SpeechKit по протоколу HTTP. Не имеет технических ограничений по производительности. Порядок регистрации учетной записи Yandex-облака и стоимость сервиса см. на Яндексе.

Для корректной настройки должен быть введен API-ключ в Общих настройках текущего домена в Web-интерфейсе Администрирования.

Синтез речи

Название	Описание
Режим	Режим работы компонента после получения ответа от сервиса TTS Yandex Cloud SpeechKit. • Воспроизведение – Воспроизведение синтезированной речи абоненту с последующим удалением файла. • Генерация файла – Сохранение аудио-файла в локальный временный каталог и возврат пути к файлу в переменную.
Текст	Текст, подлежащий синтезу и последующему воспроизведению.
Язык	Параметр сервиса TTS Yandex Cloud SpeechKit: язык синтеза. ru-RU – Русский язык en-US – Английский язык
Голос	Параметр сервиса TTS Yandex Cloud SpeechKit: голос синтезируемой речи. Alyss (ж) Jane (ж) Oksana (ж) Omazh (ж) Zahar (м) Ermil (м) Другой – Указание произвольного голоса через аргумент в поле Другой голос.
Эмоция	Параметр сервиса TTS Yandex Cloud SpeechKit: эмоциональный эффект синтезируемой речи. Good Evil Neutral
Темп речи (0.1 - 3.0)	Параметр сервиса TTS Yandex Cloud SpeechKit: темп синтезируемой речи. Дробное значение от 0.1 до 3.0 с размерностью 0.1
Прерывать по DTMF	Выключатель детектора DTMF. Открывает настройки режимов сохранения символов и прерывания операции.
Буфер для DTMF	Переменная для сохранения получаемых DTMF-символов.
Очистить буфер	Да - значение переменной Буфер для DTMF будет очищен перед выполнением текущего компонента Нет - полученные DTMF символы будут дописаны в конец переменной Буфер для DTMF
Количество символов	Аргумент, содержащий ограничение на количество вводимых символов.
Символы прерывания	Строка, содержащая последовательности символов прерывания через запятую. После обнаружения на конце буфера DTMF последовательности символов, компонент завершает работу по Переход. Пример значения *, 7, 123, 9395
Таймаут ожидания	Таймаут ожидания ответа от сервиса TTS Yandex Cloud SpeechKit после отправки ему запроса. По истечении таймаута управление передается следующему компоненту по ветке Переход, время
Код ответа в переменную	Переменная для сохранения кода HTTP-ответа сервиса распознавания.
Путь к файлу в переменную	(режим = генерация файла) Переменная для сохранения пути к аудио-файлу с синтезированной речью в локальном временном каталоге. Для длительного сохранения файла требуется дальнейшее перемещение файла сценарием в место стационарного хранения
Переход	Компонент, которому передается управление в случае успешного завершения операции. Переход по-умолчанию
Переход, время	Компонент, которому передается управление в случае истечения времени ожидания HTTP-ответа от сервиса. Переход, ошибка
Компонент, которому передается управление в случае возникновения ошибки.	Описание

Распознавание речи (Yandex Cloud SpeechKit)

Осуществляет распознавание речи абонента в текстовый вид. Сервис предоставляется облаком Yandex Cloud SpeechKit по протоколу HTTP. Не имеет технических ограничений по производительности. Порядок регистрации учетной записи Yandex-облака и стоимость сервиса см. на Яндексе.

Для корректной настройки должен быть введен API-ключ в Общих настройках текущего домена в Web-интерфейсе Администрирования.

Распознавание речи

Название	Описание
Тема	Параметр сервиса распознавания Yandex Cloud SpeechKit: тема распознавания. Возможные варианты: general - общая тема maps - адреса dates - даты names - имена и названия numbers - числа Другая – Указание произвольной темы через аргумент в поле Пользовательская тема.
Язык	Параметр сервиса распознавания Yandex Cloud SpeechKit: язык распознавания. Возможные варианты: ru-RU – Русский язык en-US – Английский язык
Фильтр ненормативной лексики	Параметр сервиса распознавания Yandex Cloud SpeechKit: выключатель фильтра ненормативной лексики.
Таймаут записи, с	Максимально допустимое время записи с момента завершения предварительного воспроизведения, в секундах.
Прерывать по DTMF	Выключатель детектора DTMF. Открывает настройки режимов сохранения символов и прерывания операции.
Буфер для DTMF	Переменная для сохранения получаемых DTMF-символов.
Очистить буфер	Да - значение переменной Буфер для DTMF будет очищен перед выполнением текущего компонента Нет - полученные DTMF символы будут дописаны в конец переменной Буфер для DTMF
Количество символов	Аргумент, содержащий ограничение на количество вводимых символов.
Символы прерывания	Строка, содержащая последовательности символов прерывания через запятую. После обнаружения на конце буфера DTMF последовательности символов, компонент завершает работу по Переход. Пример значения *, 7, 123, 9395
Прерывать при обнаружении тишины	Выключатель детектора голоса (VAD) для автоматического завершения записи и отправки последней порции голосовых данных сервису распознавания. Критерием для остановки является наличие голоса в течение не менее чем 300 мс и последующее его отсутствие в течение указанного интервала.
Интервал тишины, с	Интервал для детектора голоса (VAD), по истечении которого производится автоматическая остановка записи и отправка последней порции голосовых данных сервису распознавания.
Порог VAD, дБ	Аргумент, содержащий порог VAD, при пересечении которого в большую сторону фиксируется наличие голоса, в децибеллах. Любой шум с уровнем ниже порога рассматривается как тишина.
Таймаут ожидания ответа, с	Таймаут ожидания ответа от сервиса распознавания Yandex Cloud SpeechKit после отправки ему последней порции голосовых данных. По истечении таймаута управление передается следующему компоненту по ветке Переход, время.
Результат в переменную	Переменная для сохранения текстового результата распознавания.
Код ответа в переменную	Переменная для сохранения кода HTTP-ответа сервиса распознавания.
Тело ответа в переменную	Переменная для сохранения полного содержания HTTP-ответа сервиса распознавания.
Сохранить файл записи	Выключатель сохранения файла записи, отправленного сервису распознавания. Если включен, то путь возвращается в переменную в поле Путь к файлу в переменную
Предварительное воспроизведение	Звуковой файл предварительного воспроизведения абоненту, во время которого также активирован голосовой детектор. При отсутствии голоса от абонента (с учетом шумового порога VAD-детектора), отправка данных на сервис распознавания не производится. Может быть выбран в одном из режимов: * статический файл, приложенный к сценарию * сформированный аргументами путь, который должен включать одну из файловых категорий. При обнаружении голосоа со стороны абонента воспроизведение останавливается
Переход	Компонент, которому передается упраление в случае успешного завершения операции. Переход по-умолчанию
Переход, время	Компонент, которому передается управление в случае истечения времени ожидания HTTP-ответа от сервиса распознавания.
Переход, ошибка	Компонент, которому передается управление в случае возникновения ошибки.
Описание	Описание компонента

Управление голосовой почтой

Компонент позволяет работать с голосовой почтой для приема сообщения и управления содержимым своего ящика.

Каждый ящик имеет свой номер. Если происходит размещение файла в новом ящике, то он автоматически создается. В каждом ящике есть две папки:

• Новые. Все размещенные файлы записи попадают в эту папку. Пока в этой папке есть хоть один файл, на телефоне горит MWI.

• Прослушанные. В этой папке хранятся прослушанные записи, к которым абонент всегда может обратиться.

Файлы автоматически удаляются из папки Новые, если они не были прослушаны в течении 3-х месяцев.

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

• Положить сообщение. Размещает новое записанное сообщение в указанный почтовый ящик

• Получить количество сообщений. Результат - количество новых и прослушанных сообщений

• Достать сообщение по индексу. Получение пути до файла записи и ID сообщения по его индексу. Индекс - порядковый номер сообщения в папке ящика, где 1 - самое старое.

• Достать новое сообщение. Получение ссылка на запись и ID самого нового сообщения в папке Новые или Прослушанные.

• Достать старое сообщение. Получение ссылка на запись и ID самого старого сообщения в папке Новые или Прослушанные.

• Достать следующее сообщение. Позволяет получить более новое или более старое сообщение относительно текущего индекса. Также возвращает ссылку на него.

• Переместить в прослушанные. Переместить текущее сообщение в папку Прослушанные.

• Удалить сообщение. Удалить текущее сообщение из голосовой почты.

• Очистить ящик. Очищает все сообщения в папке Новые или Прослушанные.

Общие свойства:

Название	Описание
Операция	Положить сообщение. Получить количество сообщений. Достать сообщение по индексу. Достать новое сообщение. Достать старое сообщение. Достать следующее сообщение. Переместить в прослушанные. Удалить сообщение. Очистить ящик
Номер ящика	Номер ящика, с которым необходимо работать. Уникальный номер с темже значением, что и постфикс телефонного номера, следующий за Кодом абонентских функций с типом Голосовая посчта
Причина ошибки	Переменная для сохранения кода ошибки.
Переход	Компонент, которому передается управление в случае успешного завершения операции. Переход по-умолчанию
Переход, не найдено	Следующий Компонент, если не найдено сообщение для обработки.
Описание	Описание компонента

Специализированные свойства разных операций

Операция Положить сообщение.

Сообщение размещается в ящике с указанным Номером

Название	Описание
Путь к файлу	Передается полный путь к записи, которую необходимо разместить в голосовой почте абонента (в папке Новые). Запись делается ранее компонентом Запись
Отправитель	Номер абонента, кто будет считаться отправителем этого сообщения.

Операция Получить количество сообщений.

Получает количество сообщений в ящике с указанным Номером

Название	Описание
Новых сообщений	Переменная для сохранения количества голосовых сообщений в папке Новые.
Старых сообщений	Переменная для сохранения количества голосовых сообщений в папке Прослушанные.

Операция Достать сообщение по индексу.

Получает определнное сообщение из ящика с указанным Номером

Название	Описание
Папка ящика	Выбор папки, с которой необходимо работать. Две папки в каждом ящике Новые. Прослушанные.
Индекс	Индекс - последовательный номер сообщения в папке текущего почтового ящика. Индекс самого старого сообщения 1.
ID сообщения	Переменная для сохранения идентификатора возвращаемого голосового сообщения (ID сообщения по указанному индексу)
Отправитель	Переменная для сохранения отправителя возвращаемого голосового сообщения.
Дата отправки	Переменная для сохранения даты отправки возвращаемого голосового сообщения.
Путь к файлу	Переменная для сохранения локального пути к файлу записи возвращаемого голосового сообщения.

Операция Достать новое сообщение.

Получение самого нового сообщения из выбранной папке ящика с указанным Номером

Название	Описание
Папка ящика	Выбор папки, с которой необходимо работать. Две папки в каждом ящике Новые. Прослушанные.
ID сообщения	Переменная для сохранения идентификатора возвращаемого голосового сообщения. (ID самого нового сообщения в папке)
Отправитель	Переменная для сохранения отправителя возвращаемого голосового сообщения.
Дата отправки	Переменная для сохранения даты отправки возвращаемого голосового сообщения.
Путь к файлу	Переменная для сохранения локального пути к файлу записи возвращаемого голосового сообщения.

Операция Достать старое сообщение.

Получение самого старого сообщения из выбранной папке ящика с указанным Номером

Название	Описание
Папка ящика	Выбор папки, с которой необходимо работать. Две папки в каждом ящике Новые. Прослушанные.
ID сообщения	Переменная для сохранения идентификатора возвращаемого голосового сообщения. (ID самого старого сообщения в папке)
Отправитель	Переменная для сохранения отправителя возвращаемого голосового сообщения.
Дата отправки	Переменная для сохранения даты отправки возвращаемого голосового сообщения.
Путь к файлу	Переменная для сохранения локального пути к файлу записи возвращаемого голосового сообщения.

Операция Достать следующее сообщение.

Получение более нового или более старого сообщения из ящика с указанным Номером

Название	Описание
ID текущего сообщения	ID сообщения, к которому необходимо получить доступ. ID является уникальной ссылкой на сообщение в системе.
Папка ящика	Выбор папки, с которой необходимо работать. Две папки в каждом ящике Новые. Прослушанные.
Метод	Новее. Получаем данные по более новому сообщению относительно текущего ID Старее. Получаем данные по предыдущему сообщению относительно текущего ID
ID сообщения	Переменная для сохранения идентификатора возвращаемого голосового сообщения. (ID следующего сообщения)
Отправитель	Переменная для сохранения отправителя возвращаемого голосового сообщения.
Дата отправки	Переменная для сохранения даты отправки возвращаемого голосового сообщения.
Путь к файлу	Переменная для сохранения локального пути к файлу записи возвращаемого голосового сообщения.

Операция Переместить в прослушанные.

Перемещает указанное сообщение из папки Новое в папку Прослушанные. Действие в ящике с указанным Номером

Название	Описание
ID текущего сообщения	ID сообщения, к которому необходимо получить доступ. ID является уникальной ссылкой на сообщение в системе.

Операция Удалить сообщение.

Удаляет указанное сообщение из выбранной папке ящика с указанным Номером

Название	Описание
ID текущего сообщения	ID сообщения, к которому необходимо получить доступ. ID является уникальной ссылкой на сообщение в системе.
Папка ящика	Выбор папки, с которой необходимо работать. Две папки в каждом ящике Новые. Прослушанные.

Операция Очистить ящик

Очищает (удаляет все сообщения) из выбранной папке ящика с указанным Номером

Название	Описание
Папка ящика	Выбор папки, с которой необходимо работать. Две папки в каждом ящике Новые. Прослушанные.

Поставновка и взятие с парковки

Осуществляет постановку текущего звонка на паркову и взятие абонента с парковки.

Постановка на парковку - соединение одного из участников с парковочным местом. Взятие с парковки - соединение позвонившего чтобы взять с парковки и ранее размещенного на парковке абонента.

Компонент используется в сценариях постановки и взятия с парковки, применяемым в ходе вызова featurecode с типом parking. Может использоваться и в других сценариях.

Постановка и взятие с парковки

Название	Описание
Действие	Разместить на парковке – Осуществляет размещение на указанный номер парковки и дальнейший переход (ветка Переход при успешном размещении или ветка Переход, занято если место не свободно). Взять с парковки – Осуществляет взятие абонента с указанного парковочного места. Если место было занято, то происходит соединение звонящего в парковку и припаркованного абонента и прерывание текущего сценария. Если место свободно, то переход по ошибке (Переход, не найдено).
Номер парковки	Аргумент, содержащий номер парковки, с которым связана текущая операция. Операция размещения может быть успешно проведена только если парковочное место свободно.
Код ошибки в переменную	Переменная для сохранения кода ошибки.
Переход	Компонент, которому передается управление при успешном завершении операции размещения на парковку. Переход по-умолчанию.
Переход, занято	Компонент, которому передается управление в случае, если при размещении на парковку указанное парковочное место занято.
Переход, не найдено	Компонент, которому передается управление если при попытке взять абонента с парковки указанное парковочное место пусто.
Переход, ошибка	Компонент, которому передается управление при возникновении ошибки.
Описание	Описание компонента