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

Абоненты (Очереди)

1. Описание

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

Доступна для всех очередей, но для входящей очереди, входящей очереди задач и входной очереди чатов должна быть пустой.

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

  1. Инструмент создания (Рис.1(1));

  2. Блок фильтрации (Рис.1(2));

  3. Поле поиска (Рис.1(3));

  4. Инструмент перезапуска абонентов (Рис.1(4));

  5. Инструмент удаления (Рис.1(5));

  6. Инструмент обновления реестра записей (Рис.1(6));

  7. Реестр записей (Рис.1(7));

  8. Пагинация (Рис.1(8)).

Страница Абоненты.png

Рис. 1. Страница "Абоненты"

1.1. Инструмент создания

Для создания нового объекта служит кнопка "Добавить" (Рис.1 (1)), после нажатия на которую открывается доступ к деталям. Открыть доступ к деталям к уже существующему абоненту можно через инструмент редактирования записи.

Детали:

Внимание!

Максимально допустимое количество номеров для одного абонента - 20.

Для загрузки абонентов из файла CSV, воспользуйтесь кнопкой image2024-2-21_16-7-12.png возле кнопки "Добавить" и выбрать "Импорт данных из CSV файлов".

При нажатии на "Импорт данных из CSV файлов" открывается окно выбора файла.

Важно!

При создании файла убедитесь, что установлено "CSV-файл", как тип файла. 

Выберите нужный файл на вашем устройстве и нажмите кнопку "Открыть" (в зависимости от ОС окно выбора файла может отличаться) (Рис.2). 

Название загружаемого файла должно содержать не более 120 символов.

Импортный документ должен иметь заголовки!

Окно выбора файла (Абоненты).png

Рис. 2. Окно выбора файла

Открывается модальное окно "Импортировать CSV" (Рис.3).

1.1.1. Модальное окно Import CVS.

Предназначено для настройки импорта данных.

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

  1. Блок настройки (Рис.3(1));

  2. Блок предпросмотра (Рис.3(2));

  3. Блок выбора (Рис.3(3));

Модальное окно Импортировать CSV.png

Рис. 3. Модальное окно "Импортировать CSV" 

1.1.1.1. Блок настройки

Чекбокс "Свернуть заголовки" дает возможность пропустить заголовки. На данный момент параметр недоступен для изменений. 

Поле "Char set" служит для выбора кодирования. На данный момент параметр недоступен для изменений. По умолчанию, используется "UTF-8".

В поле "Разделитель" вводится тот знак препинания, который используется в импортируем файле. По умолчанию, используется ",".

1.1.1.2. Блок предпросмотра

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

1.1.1.3. Блок выбора

В выпадающих списках выберете названия колонок (использованные в файле CSV), данные из которых должны соответствовать выбираемому параметру. К примеру, в выпадающем списке "name" выбрать "Имя" (Рис.4). 

Настройка импорта  файла CSV.png

Рис. 4. Настройка импорта  файла CSV

1.1.1.3.1. Поле "name"

В этом поле выбирается название колонки, которое указано в файле импорта. Данные в этой колонке соответствуют именам абонентов.

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

1.1.1.3.2. Поле "timezoneId"

В этом поле выбирается название колонки, которое указано в файле импорта. Данные в этой колонке соответствуют часовым зонам абонентов.

1.1.1.3.3. Поле "priority"

В этом поле выбирается название колонки, которое указано в файле импорта. Данные в этой колонке соответствуют приоритету абонентов. Чем больше число, тем высший приоритет обзвона абонента.

1.1.1.3.4. Поле "expireAt"

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

1.1.1.3.5. Поле "bucketId"

В этом поле выбирается название колонки, которое указано в файле импорта. Данные в этой колонке соответствуют идентификатору корзины в которую должны быть добавлены абонентов.  

Идентификатор можно узнать в адресной строке корзины (Рис.5). Для этого необходимо зайти на страницу детали корзины, идентификатор которого интересует, и взять в адресной строке цифры.

Ожидается обновления данной опции.

Идентификатор корзины.png

Рис. 5. Идентификатор корзины

1.1.1.3.6. Поле "agentId"

В этом поле выбирается название колонки, которое указано в файле импорта, с данными соответствующими идентификатору оператора.

Примечание!

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


Идентификатор можно узнать в адресной строке оператора. Для этого необходимо зайти в любую деталь оператора, идентификатор которого интересует, и взять в адресной строке цифры.

1.1.1.3.7. Поле "variables"

В этом поле выбирается название колонки, которое указано в файле импорта. Данные в этой колонке соответствуют переменной, которая будет подтягиваться при дозвоне к абонентам. 

1.1.1.3.8. Поле "destination"

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

В этом поле выбирается название колонки, которое указано в файле импорта. Данные в этой колонке соответствуют данным для соединения с абонентов. К примеру, номер телефона.

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

1.1.1.3.9. Поле "commPriority"

В этом поле выбирается название колонки, которое указано в файле импорта. Данные в этой колонке соответствуют данным по приоритету, когда у одного абонента есть несколько вариантов для соединения с абонентом. Используется, когда в одного абонента есть, к примеру, два номера телефона.

Пример таблицы для загрузки абонентов с двумя номерами телефона.png

Рис. 6. Пример таблицы для загрузки абонентов с двумя номерами телефона

Важно!

Порядок выбранных полей из файла в поле "destination" должно сопоставляться с выбранными полями в полях  "commPriority" и "code" (Рис.7). 

Чем больше число, тем высший приоритет.

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

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

1.1.1.3.10. Поле "code"

В этом поле выбирается название колонки, которое указано в файле импорта. Данные в этой колонке соответствуют коду типу связи с абонентом. 

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

Идентификатор можно узнать на странице "Типа связи" в колонке "Код". 

1.1.1.3.11. Поле "description"

В этом поле выбирается название колонки, которое указано в файле импорта. Данные в которой соответствуют данным по описанию. Указанная здесь информация отображается при звонке во вкладке "Информация" в Workspace.

1.1.1.3.12. Поле "dtmf"

В этом поле выбирается название колонки, которое указано в файле импорта. Данные в которой соответствуют данным по dtmf.

Разрешен ввод цифр и букв "w" и "W",
где:
W – пауза в 1 сек;
w – пауза в 0,5 сек.

К примеру, 

WW3w5 – пришел звонок, подняли трубку и через две секунды произошел до набора 3, а потом еще через 0,5 секунды – 5.

После настройки обязательных полей кнопка "Сохранить" становится активной. Обязательные поля обозначаются "*". После нажатия на кнопку "Сохранить" модальное окно закрывается, в реестре записей добавляются записи из CSV-файла.

При необходимости создать копию абонента необходимо зайти на страницу детали этого абонента и нажать на кнопку image2024-2-21_17-12-47.png возле кнопки "Сохранить" и выбрать вариант "Сохранить как нового" (Рис.8).

image2024-2-21_17-12-32.png

Рис. 8. Сохранить как нового

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

1.2. Блок фильтрации

Предназначен для фильтрации данных, которые отображаются в реестре записей.

Содержит:

  1. Поля фильтрации (Рис.9(1));

  2. Инструмент сброса фильтра (Рис.9(2));

  3. Инструмент расширения фильтров (Рис.9(3)).

Блок фильтрации (Абоненты).png

Рис. 9. Блок фильтрации

1.2.1. Поля фильтрации

Доступны поля для фильтрации:

  • От — дата и время создания абонента;

  • До —  дата и время создания абонента;

  • Причина прекращения;

  • Корзина;

  • Приоритет (поля "От" и "До").

По умолчанию, фильтр даты и времени "От" установлен на первый день прошлого месяца.

К примеру, при открытии страницы 21.09.2022 в поле фильтра "От"  будет отображаться значение 01.08.2022,00:00:00, а в поле фильтра "До" - 21.09.2022,23:59:59. 

Диапазон отфильтрованных записей, по умолчанию, будет варьироваться от 28 до 62 дней, в зависимости от дня открытия страницы.

1.2.2. Инструмент сброса фильтра

Представлен в виде кнопки image-20251223-211815.png , при нажатии на которую сбрасываются все выбранные ранее фильтры.

1.2.3. Инструмент расширения фильтров

Представлен в виде кнопки image-20241213-115548.png , при нажатии на которую раскрываются все поля для фильтрации.

Внимание!

Количество отображаемых полей может меняться в зависимости от размеров окна браузера. Для раскрытия всех полей используйте кнопку  image-20241213-115552.png .

1.3. Поле поиска

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

Состоит из поля ввода и кнопки закрытия ( image-20241213-101535.png ), которая отображается, когда в поле ввода установлен курсор.  Для поиска по части слова, или номера, используется символ *. Можно использовать символ * и для замены любого количества символов.

1.4. Инструмент перезапуска абонентов 

Кнопка image2024-2-21_17-19-51.png  (Рис.1 (4)) служить для перезапуска абонентов. При нажатии на эту кнопку открывается модальное окно "Перезапустить абонентов" (Рис. 10).

Модальное окно Перезапустить абонентов.png

Рис. 10. Модальное окно "Перезапустить абонентов"

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

Предупреждение!

Если причина прекращения "expired", то для следующего обзвона необходимо изменить время в поле "Истекает" на странице данного абонента! В ином случае обзвон этого абонента не будет совершиться.

1.5. Инструмент удаления

Кнопка Снимок экрана 2024-02-16 004151.png  (Рис.1 (5)) служит для удаления абонентов (объектов) с использованием чекбоксов. При нажатии на эту кнопку открывается список с вариантами (Рис.11):

  • Удалить все объекты;

  • Удалить все отфильтрованные объекты;

  • Удалить N выбранных объектов.

Инструмент удаления.png

Рис. 11. Инструмент удаления

Нажатие на один из вариантов подтверждает удаление указанных в варианте объектов.

1.6. Инструмент обновления реестра записей

Обновление таблицы реестра записей выполняется нажатием на кнопку обновления - image-20241213-115639.png .

(Рис.1 (6)).

1.7. Реестр записей

Реестр представляет собой список записей существующих абонентов. 

Состоит из полей:

  1. Чекбокс;

  2. Колонка "Имя";

  3. Колонка "Создан в";

  4. Колонка "Перезвонить в";

  5. Колонка "Назначения";

  6. Колонка "Приоритет";

  7. Колонка "Причина прекращения";

  8. Колонка "Попыток";

  9. Колонка "Оператор

  10. Инструмент редактирования;

  11. Инструмент удаления.

1.7.1. Чекбокс

Используется для выбора одной или нескольких записей абонента.

1.7.2. Колонка "Имя"

Здесь отображаются имена абонентов.

1.7.3. Колонка "Создан в"

Отображается время добавления абонента в очередь.

1.7.4. Колонка "Перезвонить в"

Отображается время, когда необходимо перезвонить абоненту. Задается в постобработке звонка.

1.7.5. Колонка "Назначение"

Отображается номер телефона абонента. Если у абонента больше одного номера телефона, то их количество (без учета номера, что отображается) указывается возле номера. При нажатии на количество открывается модальное окно "Назначения" (Рис.12), где отображаются все номера, тип связи и приоритетность номеров.

Модальное окно Назначения.png

Рис. 12. Модальное окно "Назначения"

1.7.6. Колонка "Приоритет"

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

1.7.7. Колонка "Причина прекращения"

Существуют такие причины прекращения:

  • Пропущенный — пропущенный оператором, присутствует только в превью обзвоне, когда механизм дозвона не дозвонился  к оператору и, соответственно, не набирает абонента;

  • Тайм-аут — присутствует в обзвонах, в которых настроена постобработка, проставляется в случае, если оператор не успел вовремя закончить постобработку;

  • Неудачный — не дозвонились до абонента;

  • Потерянный — дозвонились до абонента, но не было соединения с оператором; 

  • Успешно — успешный;

  • Отменённый — отменён;

  • Истекший — время до которого необходимо было совершить звонок прошло, а звонка не было.

1.7.8.  Колонка "Попыток

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

1.7.9. Колонка "Оператор"

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

Если "Липкость" в настройках очереди отключена, то распределение будет идти на любого свободного оператора.

Если оператор не был назначен — поле будет пустое.

1.7.10. Инструмент редактирования

Нажатие на кнопку редактирования ( Screenshot 2024-11-29 113414.png ) открывает доступ к деталям, в которых можно изменить данные объекта. При наведении курсором на кнопку отображается информация с названием инструмента.

1.7.11. Инструмент удаления

Используется для удаления объекта с подтверждением через модальное окно. При наведении на кнопку удаления ( image-20250624-091835.png ) отображается информация с названием инструмента.  После нажатия кнопки удаления появляется модальное окно с подтверждениемНажатие кнопки "Да" удаляет объект и запись о нем. Нажатие кнопки "Нет" закрывает модальное окно, объект не удаляется. 

Модальное окно Подтвердить удаление.png


Рис.13. Модальное окно подтверждения удаления 

1.8. Пагинация

Состоит из поля "Записей на странице", в котором указывается количество записей (возможно задать от 1 до 1000) на одну страницу и кнопок вперед  image-20241213-095758.png и назад  image-20241213-095901.png для переключения страниц.

2. Возможности

2.1. Добавления нового абонента

Цель

Добавить нового абонента

Предусловия

  1.  Доступ к приложению Admin;

  2.  Доступ к разделу "Очереди" в приложении Admin;

  3.  Разрешение на действия в разделе "Очереди";

  4. Наличие, минимум, одной очереди.

Сценарий:


  1. Нажать кнопку "Добавить". Открывается страница детали "Общее".

  2. Внести данные. Перейти на страницу детали "Тип связи".

  3. Добавить тип связи. Кнопка "Сохранить" становится активной.

  4. Перейти на страницу детали "Переменные", если для данного абонента нужно добавить переменные.

  5. Внести данные.

  6. Нажать кнопку "Сохранить"

Результат

Данные сохранены. Абонент добавлен

2.2. Удаление абонента из очереди

Цель

Удалить абонента из очереди

Предусловия

  1.  Доступ к приложению Admin;

  2.  Доступ к разделу "Очереди" в приложении Admin;

  3.  Разрешение на действия в разделе "Очереди";

  4. Наличие, минимум, одной очереди;

  5. Наличие, минимум, одного абонента.

Сценарий:


  1. Найти абонента, которого необходимо удалить.

  2. Нажать на кнопку удаления -  Снимок экрана 2024-02-16 005633.png . Открывается модальное окно для подтверждения удаления.

  3. Нажать кнопку "Да".

Результат

 Данные сохранены. Абонент удален.

2.3. Удаление нескольких абонентов из очереди

Цель

Удалить несколько абонентов из очереди

Предусловия

  1.  Доступ к приложению Admin;

  2.  Доступ к разделу "Очереди" в приложении Admin;

  3.  Разрешение на действия в разделе "Очереди";

  4. Наличие, минимум, одной очереди;

  5. Наличие, минимум, одного абонента.

Сценарий:


  1. Найти абонентов, которых необходимо удалить. Выбрать их с помощью чекбокса.

  2. Нажать на кнопку удаления вверху реестра записей. Открывается модальное окно для подтверждения удаления.

  3. Нажать кнопку "Да".

Результат

Данные сохранены. Выбранные абоненты удалены.

2.4. Редактирование абонента 

Цель

Изменения параметров абонента

Предусловия

  1.  Доступ к приложению Admin;

  2.  Доступ к разделу "Очереди" в приложении Admin;

  3.  Разрешение на действия в разделе "Очереди";

  4. Наличие, минимум, одной очереди;

  5. Наличие, минимум, одного абонента.

Сценарий:


  1. Найти в реестре записей абонента, которого необходимо редактировать.

  2. Нажать на кнопку редактирования в записи этого абонента. Открывается страница детали "Общее".

  3. Открыть нужную деталь.

  4. Внести изменения.

  5. Нажать кнопку "Сохранить".

Результат

Данные сохранены. 

2.5. Добавления абонентов посредством импорта CSV-файла

Цель

Добавить абонентов посредством импорта CVS файла

Предусловия

  1.  Доступ к приложению Admin;

  2.  Доступ к разделу "Очереди" в приложении Admin;

  3. Разрешение на действие в разделе "Очереди";

  4. Наличие CSV-файла;

  5. Наличие, минимум, одной очереди.

Сценарий:


  1. Нажать кнопку  Screenshot 2024-10-16 152246.png возле кнопки "Добавить". Выбрать опцию "Импорт данных из CSV файлов". Открывается окно выбора файла.

  2. Выбрать файл, нажать кнопку "Открыть". Открывается модальное окно "Импортировать CSV".

  3. В выпадающих списках выберите названия колонок (использованные в файле CSV), данные из которых должны соответствовать выбираемому параметру. К примеру, в выпадающем списке "name" выбрать "имя". Кнопка "Добавить" становится активной.

  4. Нажать кнопку "Сохранить".

Результат

Модальное окно закрылось. Абоненты из CSV-файла добавились в реестр записей.