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

Налаштування IVM

У цьому документі описано процес налаштування вихідного IVR-дайлера в системі Webitel. Інструкція включає завантаження медіафайлу, створення голосової схеми, налаштування ресурсів та черги. Після виконання всіх кроків система буде готова до автоматичного вихідного обдзвону клієнтів.

1. Навігація

Щоб завантажити медіафайл, необхідно перейти до розділу Admin (Рис. 1)Довідники (Рис. 2.(1))Медіафайли (Рис. 2.(2)).

Admin.png
Рис. 1. Розділ “Admin”
image-20260302-090228.png
Рис. 2. Розділ “Довідники” → “Медіафайли”

Після переходу відкриється сторінка Медіафайли (Рис. 3).

image-20260302-090524.png
Рис. 3. Сторінка “Медіафайли”

2. Завантаження медіафайлу

Щоб завантажити новий медіафайл:

  1. Натисніть на область “Завантаження файлів тут” у верхній частині сторінки (Рис. 4).

image-20260302-090753.png
Рис. 4. Область “Завантаження файлів тут”
  1. Виберіть файл на своєму пристрої.

  2. Дочекайтеся завершення завантаження — файл з’явиться в реєстрі (Рис. 5).

image-20260302-091039.png
Рис. 5. Реєстр записів

2.1. Вимоги до файлів

Підтримуються такі формати:

  • mp3;

  • wav (8 кГц, 16 біт, моно — стандарт для частоти SIP-каналу).

Рекомендується використовувати формат wav.

Розмір файлу не повинен перевищувати 5 МБ.

3. Створення Flow-схеми

Щоб створити Flow-схему для відтворення раніше завантаженого медіафайлу, необхідно перейти до розділу Admin (Рис. 6) Маршрутизація (Рис. 7.(1)) Схеми (Рис. 7.(2)).

Admin.png
Рис. 6. Розділ “Admin”
image-20260302-093451.png
Рис. 7. Розділ “Маршрутизація” → “Схеми”

Відкриється сторінка зі списком усіх схем (Рис. 8).

image-20260302-093641.png
Рис. 8. Сторінка “Схеми”

3.1. Створення нової схеми

Щоб створити нову схему:

Натисніть кнопку “Додати” у правому верхньому куті сторінки (Рис. 9).

image-20260302-093951.png
Рис. 9. Кнопка “Додати”

Відкриється модальне вікно створення схеми (Рис. 10).

image-20260303-062357.png
Рис. 10. Модальне вікно “Створити нову схему”

У модальному вікні виконайте такі дії:

  • Оберіть метод створення “Діаграма(Рис. 10.(1)).

  • У полі “Тип” оберіть значення “Голосова(Рис. 10.(2)).

  • Натисніть кнопку “Створити (Рис. 10.(3)).

3.2. Редагування схеми

Після створення відкриється вікно редагування схеми (Рис. 11).

Редактирование схемы.png
Рис. 11. Вікно редагування схеми

У робочій області необхідно додати два елементи:

3.3. Додавання елемента “Playback”

Елемент “Playback” відповідає за відтворення медіафайлу на початку розмови.

Щоб додати елемент:

  1. У лівій панелі знайдіть компонент “Playback” (можна скористатися пошуком) (Рис. 12).

Playback_.png
Рис. 12. Пошук компонента “Playback”
  1. Перетягніть компонент “Playback” у робочу область схеми (Рис. 13). З’єднайте блок “Start” з блоком “Playback”.

Playback.png
Рис. 13. Додавання компонента “Playback”
  1. Далі натисніть на компонент (Рис. 14.(1)) — відкриється блок налаштувань.

  2. У полі “Media (Рис. 14.(2)) оберіть раніше завантажений файл.

  3. Натисніть кнопку “Add(Рис. 14.(3)).

Настройка Playback.png
Рис. 14. Налаштування елемента “Playback”

Детальний опис параметрів наведено в документації.

3.4. Додавання елемента “Hangup”

Елемент “Hangup” відповідає за коректне завершення дзвінка.

Щоб додати елемент:

  1. У лівій панелі знайдіть компонент “Hangup(Рис. 15).

Hangup.png
Рис. 15. Пошук компонента “Hangup”
  1. Перетягніть його в робочу область (Рис. 16).

  2. З’єднайте вихід блоку “Playback” із входом блоку “Hangup”. Блок “Hangup” має розташовуватися в кінці схеми.

Hangup_.png
Рис. 16. Додавання елемента “Hangup”

Детальний опис параметрів блоку наведено в документації.

Після завершення налаштування збережіть схему (Рис. 17).

Сохранение схемы.png
Рис. 17. Збереження схеми

4. Створення ресурсу для вихідних дзвінків

Для здійснення вихідних дзвінків IVR-черги необхідно попередньо створити ресурс.

4.1. Навігація

Щоб створити ресурс:

Перейдіть до розділу “Admin (Рис. 18) → “Контакт-центр (Рис. 19.(1)) → “Ресурси (Рис. 19.(2)).

Admin.png
Рис. 18. Розділ “Admin”
image-20260303-063731.png
Рис. 19. Розділ “Контакт-центр” → “Ресурси”

Відкриється сторінка зі списком усіх створених ресурсів (Рис. 20).

image-20260303-064012.png
Рис. 20. Сторінка “Ресурси”

4.2. Створення нового ресурсу

Щоб створити новий ресурс:

  1. Натисніть кнопку “Додати” у правому верхньому куті (Рис. 21).

image-20260303-064102.png
Рис. 21. Кнопка “Додати”
  1. Відкриється сторінка створення нового ресурсу. На вкладці “Загальне” заповніть обов’язкові поля (Рис. 22):

image-20260303-064415.png
Рис. 22. Вкладка “Загальне” (“Ресурси”)
  • Ім’я (Рис. 22.(1)) — вкажіть назву ресурсу.

  • Шлюз (Рис. 22.(2)) — оберіть шлюз, через який здійснюватимуться вихідні дзвінки.

  • Ignore Early Media (Рис. 22.(3)) — рекомендується встановити значення consume. Даний параметр дозволяє ігнорувати раннє медіа (гудки, мелодії очікування) та реагувати саме на підняття слухавки абонентом.

  1. Після заповнення даних натисніть кнопку “Зберегти(Рис. 22.(4)).

4.3. Налаштування номерів (при використанні прямого транку)

Якщо в якості шлюзу використовується не реєстраційний шлюз, а прямий транк із провайдером, необхідно додатково вказати номер.

Для цього:

  1. Перейдіть на вкладку “Номери”. Натисніть кнопку додавання номера (Рис. 23).

image-20260303-064539.png
Рис. 23. Вкладка “Номери”
  1. Відкриється модальне вікно “Додати номер(Рис. 24).

image-20260303-064714.png
Рис. 24. Модальне вікно “Додати номер”
  1. У полі “Номер” вкажіть номер, який очікує провайдер на своїй стороні. Натисніть кнопку “Додати”.

4.4. Увімкнення ресурсу

Після створення ресурсу необхідно активувати його.

Поверніться до реєстру ресурсів. У колонці “Стан” увімкніть перемикач для створеного ресурсу (Рис. 25).

image-20260303-064838.png
Рис. 25. Увімкнення створеного ресурсу

Ресурс повинен перебувати в активному стані image-20260226-081942.png .

5. Створення групи ресурсів

Група ресурсів використовується для об’єднання одного або кількох ресурсів і подальшого призначення її в IVR-черзі.

5.1. Навігація

Щоб створити групу ресурсів:

  1. Натисніть на іконку меню у лівому верхньому куті (Рис. 26).

image-20260303-065006.png
Рис. 26. Меню
  1. У відкритому меню оберіть: “Admin” → “Контакт-центр” → “Групи ресурсів(Рис. 27).

image-20260303-065053.png
Рис. 27. Перехід до “Admin” → “Контакт-центр” → “Групи ресурсів”
  1. Відкриється сторінка зі списком усіх створених груп ресурсів (Рис. 28).

image-20260303-065136.png
Рис. 28. Сторінка “Групи ресурсів”

5.2. Створення нової групи ресурсів

  1. Натисніть кнопку “Додати” у правому верхньому куті сторінки (Рис. 29).

image-20260303-065213.png
Рис. 29. Кнопка “Додати”
  1. Відкриється сторінка створення нової групи.

  2. На вкладці “Загальне” заповніть обов’язкові поля (Рис. 30):

  • Ім’я — вкажіть назву групи ресурсів.

  • Тип зв’язку — оберіть тип зв’язку.

image-20260303-065339.png
Рис. 30. Вкладка “Загальне”
  1. Перейдіть на вкладку “Ресурси”. Натисніть кнопку додавання ресурсу (Рис. 31).

image-20260303-065425.png
Рис. 31. Додавання ресурсу
  1. Відкриється модальне вікно “Додати ресурс(Рис. 32). Заповніть поля:

  • Ресурс — оберіть раніше створений ресурс.

  • Пріоритет — вкажіть пріоритет використання ресурсу (чим менше значення, тим вищий пріоритет).

  • Резервний ресурс — за потреби вкажіть резервний ресурс.

  1. Натисніть кнопку “Додати”.

image-20260303-065544.png
Рис. 32. Модальне вікно “Додати ресурс”
  1. Доданий ресурс з’явиться у списку (Рис. 33).

image-20260303-065735.png
Рис. 33. Відображення доданого ресурсу
  1. Перейдіть на вкладку “Інтервал” (Рис. 34). Вкажіть часовий інтервал роботи групи ресурсів:

  • Від (hh:mm) — час початку роботи.

  • До (hh:mm) — час завершення роботи.

За потреби можна додати кілька інтервалів.

image-20260303-070032.png
Рис. 34. Вкладка “Інтервал”
  1. Після заповнення всіх вкладок натисніть кнопку “Зберегти” у правому верхньому куті (Рис. 35).

image-20260303-070118.png
Рис. 35. Збереження групи ресурсів
  1. Після збереження група відобразиться у загальному списку (Рис. 36).

image-20260303-070154.png
Рис. 36. Відображення доданої групи ресурсів

6. Створення IVR-дайлера (Outbound IVR Queue)

Після створення ресурсу та групи ресурсів необхідно створити IVR-чергу.

6.1. Навігація

  1. Відкрийте меню у лівому верхньому куті (Рис. 37).

image-20260303-070312.png
Рис. 37. Меню
  1. Перейдіть до розділу: “Admin” → “Контакт-центр” → “Черги(Рис. 38).

image-20260303-071510.png
Рис. 38. Перехід до “Admin” → “Контакт-центр” → “Черги”
  1. Відкриється сторінка зі списком усіх черг (Рис. 39).

image-20260303-071607.png
Рис. 39. Сторінка “Черги”

6.2. Створення нової черги

  1. Натисніть кнопку “Додати” у правому верхньому куті (Рис. 40).

image-20260303-071717.png
Рис. 40. Кнопка “Додати”
  1. У відкритому модальному вікні (Рис. 41) оберіть тип: “Вихідна IVR-черга(Рис. 41.(1)). Натисніть кнопку “Створити(Рис. 41.(2)). Відкриється сторінка налаштування нової черги.

image-20260303-071923.png
Рис. 41. Модальне вікно “Нова черга”
  1. На вкладці “Загальне(Рис. 42) заповніть основні параметри:

  • Ім’я (Рис. 42.(1)) — вкажіть назву дайлера.

  • Календар (Рис. 42.(2)) — оберіть календар. Календар визначає робочий час дайлера (часові вікна дзвінків).

  • Схема (Рис. 42.(3)) — оберіть раніше створену голосову схему, яка має відтворюватися при відповіді.

Інші параметри можна залишити за замовчуванням або налаштувати відповідно до вимог проєкту.

image-20260303-154150.png
Рис. 42. Вкладка “Загальне“ (“Черги“)
  1. Перейдіть на вкладку “Налаштування додзвону абонентів(Рис. 43). Тут налаштовуються ключові параметри:

  • Час між спробами (hh:mm:ss) — інтервал між повторними спробами дозвону.

  • Максимальна кількість спроб — кількість спроб дозвону одному абоненту.

  • Ліміт задач — обмеження кількості активних задач.

  1. Увімкніть параметр “Запис”, який відповідає за запис розмови.

Налаштування додзвону.png
Рис. 43. Вкладка “Налаштування додзвону абонентів“
  1. Перейдіть на вкладку “Ресурси”. Натисніть кнопку додавання (Рис. 44).

Ресурси.png
Рис. 44. Вкладка “Ресурси”. Додавання нового ресурсу
  1. У модальному вікні (Рис. 45) оберіть раніше створену “Групу ресурсів” (Рис. 45.(1)). Натисніть кнопку “Зберегти(Рис. 45.(2)).

Група ресурсів.png
Рис. 45. Модальне вікно “Група ресурсів“
  1. Додана група відобразиться у списку (Рис. 46).

групи ресурсів.png
Рис. 46. Відображення доданої групи ресурсів
  1. Після заповнення всіх параметрів натисніть кнопку “Зберегти” у правому верхньому куті (Рис. 47).

Зберегти.png
Рис. 47. Збереження черги

6.3. Увімкнення IVR-черги

Після створення черги її необхідно активувати.

Поверніться до загального списку черг. У колонці “Стан” увімкніть перемикач навпроти створеного IVR-дайлера (Рис. 48).

Стан.png
Рис. 48. Увімкнення створеної черги

Черга повинна перебувати в активному стані – image-20260226-081942.png .

7. Додаткові можливості: гнучка Retry-логіка через after-схему

Стандартні параметри IVR-черги дозволяють задати єдиний інтервал між повторними спробами дозвону. Цей інтервал застосовується до всіх викликів однаково.

Якщо потрібна більш гнучка логіка повторних дзвінків (наприклад, різні інтервали після кожної спроби або залежно від результату дзвінка), використовується after-схема, яка виконується після завершення виклику в черзі.

7.1. Приклад реалізації after-схеми

[
  {
    "if": {
      "expression": "${call_cause} == 'USER_BUSY' || ${call_cause} == 'CALL_REJECTED'",
      "then": [
        {
          "set": [
            {
              "status": "Зайнято"
            }
          ]
        },
        {
          "abandoned": {
            "export": [
              "status"
            ],
            "waitBetweenRetries": "3600"
          }
        }
      ]
    }
  },
  {
    "if": {
      "expression": "${cc_result} && +${call_voice_sec} <= 10",
      "then": [
        {
          "set": [
            {
              "status": "Недослухав"
            }
          ]
        },
        {
          "abandoned": {
            "export": [
              "status"
            ]
          }
        }
      ]
    }
  }
]

7.2. Які задачі вирішує after-схема

After-схема дозволяє:

  • аналізувати результат дзвінка;

  • враховувати причину завершення виклику;

  • перевіряти тривалість розмови;

  • задавати індивідуальні інтервали повторного дозвону;

  • визначати, чи потрібна повторна спроба.

Таким чином можна реалізувати сценарії, які неможливо налаштувати лише стандартними параметрами черги.

7.3. Використовувані змінні

  • call_cause — причина завершення дзвінка (USER_BUSY, CALL_REJECTED — абонент зайнятий або виклик відхилено);

  • call_voice_sec — тривалість розмови в секундах;

  • set — створення змінної status (наприклад: “Зайнято”, “Недослухав”);

  • abandoned — фіналізація обробки дзвінка та визначення необхідності повторної спроби;

  • export — виведення змінної status в історію дзвінків;

  • waitBetweenRetries — встановлення індивідуального інтервалу повторного набору (в секундах).

7.4. Приклад логіки

У наведеній схемі реалізовано таку логіку:

  • при значенні call_cause = USER_BUSY або CALL_REJECTED встановлюється статус “Зайнято” та задається повторний дзвінок через 3600 секунд;

  • при тривалості розмови ≤ 10 секунд встановлюється статус “Недослухав”;

  • підсумковий статус зберігається в історії дзвінків.

After-схема розширює стандартні можливості черги та дозволяє реалізувати більш гнучке керування повторними спробами дозвону.