Документация Webitel

Компонент "Playback"

1. Описание

Предназначен для проигрывания звукового файла в начале разговора.

Данный компонент присутствует в схемах типа:

  • Голосовая.

Блок (Рис.1(1)) используется в поле для построения схемы. При нажатии на блок открывается панель настроек данного компонента (Рис.1(2)).

Playback.png

Рис. 1. Компонент "Playback"

1.1. Блок "Playback"

Блок состоит из таких элементов:

  1. Название компонента;

  2. Ветка "In" - принимающая (соединяющая с предыдущим блоком) ветка;

  3. Ветка "Out" - исходящая (соединяющая со следующим блоком) ветка.

При наведении на поле "Out" появляется переключатель, который позволяет соединить этот компонент с компонентом, уже имеющим соединение.

Наличие иконки  image2024-11-7_15-47-46.png  обозначает, что  переключатель включен, и данный компонент можно соединить с компонентом, уже имеющим соединение.

Смена положения переключателя  удаляет исходящую ветку этого компонента.

Кнопка  image2024-11-7_15-51-56.png  удаляет блок из схемы.

1.2. Панель настроек "Playback"

Состоит из таких элементов:

  1. Элемент "File type";

  2. Элемент  "Get speech";

  3. Элемент  "Get digits";

  4. Переключатель "Break";

  5. Элемент "Limit";

  6. Элемент "Add description".

1.2.1. Элемент "File type"

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

Состоит из поля "File type" и поля, которое зависит от выбора в поле "File type". А также кнопки "Add", которая додает выбранный вариант.

Поле "File type" предназначено для выбора типа звуков. Доступны такие варианты:

  1. media;

  2. silence;

  3. tone;

  4. http_audio.

1.2.1.1. Media

Когда выбран тип "media" второе поле отвечает за выбор файла, который будет проигрываться в начале разговора, и называется "Media" (Рис. 2). При нажатии на поле "Media" открывается список медиафайлов из которого и выбирается файл. Список берется из страницы "Медиафайлы". 

Playback выбор медиа-файла.png

Рис. 2. Выбор медиафайла

1.2.1.2. Silence

При выборе типа "silence" второе поле отвечает за длительность тишины в миллисекундах и называется "Silence (ms)" (Рис. 3). 

Playback выбор тишины.png

Рис. 3. Выбор тишины

1.2.1.3. Tone

В случае, когда выбран тип "tone" второе поле отвечает за код тона гудков и называется "Tone"(Рис. 4)

Гудки в компоненте Playback.png

Рис. 4. Гудки в компоненте Playback

1.2.1.4. Http_audio

В случае, когда выбран тип "http_audio" добавляются следующие элементы (Рис. 5):

  1. Url;

  2. File type;

  3. Add Header.

Http_audio.png

Рис. 5. Выбор сетевого аудио

Используется для проигрывания сетевого аудио.

1.2.1.4.1. Url

В поле "Url" вводится ссылка на аудиофайла. 

1.2.14.2. File type

Здесь выбирается тип файла. Доступны следующие варианты:

  • wav;

  • mp3.

1.2.1.4.3. Add Header

При нажатии кнопки "Add Header" добавляются поля "Кеу" и "Value" в которые вводится значения заголовка для запросов. Можно добавить несколько заголовков. После введения данных в поля необходимо нажать кнопку "Add header".


Можно добавить несколько вариантов, которые будут проигрываться по порядку сверху вниз. Также есть возможность перемещать добавленные варианты методом перетаскивания зажав клавишу мышки.

Для удаления одного из вариантов необходимо нажать на кнопку image2024-1-31_15-13-11.png для этого варианта.

Во включенном положение одновременно может находиться только один из переключателей, "Get speech" или  "Get digits".

1.2.2. Элемент "Get speech"

Предназначен для получения информации о том, что произнес абонент во время прослушивания звуков, которые настроены в этом компоненте. 

Состоит из переключателя  "Get speech".

1.2.2.1. Переключатель  "Get speech"

Предназначен для включения/отключения возможности распознавания, что говорит абонент во время прослушивания звуков, которые настроены в этом компоненте. 

1.2.3. Элемент "Get digits"

Предназначен для получения информации о том, что нажимает абонент во время прослушивания звуков, которые настроены в этом компоненте.

Состоит из:

  1. Переключатель  "Get digits";

  2. Поле "Min";

  3. Поле "Max";

  4. Поле "Set result to variable";

  5. Поле "Timeout";

  6. Поле "Digit timeout (ms)";

  7. Поле "Tries";

  8. Поле "Terminators";

  9. Переключатель "Flush DTMF".

1.2.3.1. Переключатель  "Get digits"

Предназначен для включения/отключения возможности получать информацию о том, что нажимает абонент во время прослушивания звуков, которые настроены в этом компоненте.

1.2.3.2. Поле "Min"

Здесь указывается минимальное количество цифр, которые мы ожидаем получить от абонента. 

1.2.3.3. Поле "Max"

Здесь указывается максимальное количество цифр, которые мы ожидаем получить от абонента. 

1.2.3.4. Поле "Set result to variable"

Указывает имя переменной, в которую будут записываться значения, выбранные абонентом при прослушивании звуков, настроенных в этом компоненте.

При включенном переключателе "Get speech" в переменную записывается распознанная речь абонента в виде текста.

При включенном переключателе "Get digits" в переменную записывается цифра(ы) которые нажал абонент.

1.2.3.5. Поле "Timeout"

Здесь указывается время ожидания на ввод абонентом необходимого количества цифр.

Время указывается в миллисекундах.

1.2.3.6. Поле "Digit timeout (ms)"

Здесь указывается время ожидания между набором цифр — сколько миллисекунд ожидать набор следующей цифры. Если это поле не заполнено, то ограничения берутся из поля "Timeout".

1.2.3.7. Поле "Tries"

Здесь указывается количество попыток для абонента ввести необходимое количество цифр.

1.2.3.8. Поле "Terminators"

Обязательное поле.

Если в поле указан символ "-", то нажатие в телефоне кнопки "#" записывается в переменную. Применяется для возможности использовать кнопку "#" в голосовом меню.

Если в поле указан "#", то при нажатии в телефоне кнопки "#" выполняется выход из проигрывания звукового файла.

1.2.3.9. Переключатель "Flush DTMF"

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

image2024-1-26_13-47-47.png  - аннулирует набранные абонентом цифры;

image2024-1-26_13-47-15.png  - не аннулирует  набранные абонентом цифры.

1.2.4. Переключатель "Break"

Отвечает за окончание выполнения схемы.

  • image-20250704-085952.png - инициирует окончание выполнения схемы после данного компонента;

  • image-20250704-085922.png - переключатель отключен.

1.2.5. Элемент "Limit"

Предназначен для определения максимального количества прохождений через этот компонент. 

Если через компонент прохождений будет больше, чем указано в поле "Max", то будет использоваться ветка "failover"- image2024-1-26_12-1-12.png , которая появляется в блоке компонента при установке лимита.

Нажатие на кнопку "Add limit" добавляет поле "Max" и кнопку "Delete limit".

В поле "Max" указывается количество возможных прохождений.

Нажатие на кнопку "Delete limit" убирает лимит, возвращая кнопку "Add limit".

Limit.png


Рис. 6. Установление лимита

1.2.6. Элемент "Add description"

Нажатие на кнопку "Add description" добавляет поле "Description" и кнопку "Delete description".

В поле "Description" указывается описание — комментарии к компоненту.

Нажатие на кнопку "Delete description" убирает описание, возвращая кнопку "Add description".

Description.png

Рис. 7. Элемент "Add description"