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

Настройка IVM

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

1. Навигация

Чтобы загрузить медиафайл, необходимо перейти в раздел “Admin(Рис. 1) → “Справочники(Рис. 2.(1)) → “Медиафайлы(Рис. 2.(2)).

Admin.png
Рис. 1. Раздел “Admin”
Справочники - Медиафайлы.png
Рис. 2. Раздел “Справочники” → “Медиафайлы”

После перехода откроется страница Медиафайлы (Рис. 3).

Страница "Медиафайлы"-20260226-062246.png
Рис. 3. Страница “Медиафайлы”

2. Загрузка медиафайла

Чтобы загрузить новый медиафайл:

  1. Нажмите на область “Загрузка файлов здесь” в верхней части страницы (Рис. 4).

Медиафайлы-20260226-061138.png
Рис. 4. Область “Загрузка файлов здесь”
  1. Выберите файл на своем устройстве.

  2. Дождитесь завершения загрузки — файл появится в реестре (Рис. 5).

Реестр_записей-20260226-063331.png
Рис. 5. Реестр записей

2.1. Требования к файлам

Поддерживаются следующие форматы:

  • mp3;

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

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

Размер файла не должен превышать 5 МБ.

3. Создание Flow-схемы

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

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

Откроется страница со списком всех схем (Рис. 8).

Схемы.png
Рис. 8. Страница “Схемы”

3.1. Создание новой схемы

Чтобы создать новую схему:

Нажмите кнопку “Добавить” в правом верхнем углу страницы (Рис. 9).

Кнопка "Добавить".png
Рис. 9. Кнопка “Добавить“

Откроется модальное окно создания схемы (Рис. 10).

Создать новую схему.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”
Контакт-центр - Ресурсы.png
Рис. 19. Раздел “Контакт-центр” → “Ресурсы”

Откроется страница со списком всех созданных ресурсов (Рис. 20).

Страница "Ресурсы".png
Рис. 20. Страница “Ресурсы”

4.2. Создание нового ресурса

Чтобы создать новый ресурс:

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

Кнопка Добавить - Ресурсы.png
Рис. 21. Кнопка “Добавить”
  1. Откроется страница создания нового ресурса. На вкладке Общее заполните обязательные поля (Рис. 22):

Ресурсы.png
Рис. 22. Вкладка “Общее“ (“Ресурсы“)
  • Имя (Рис. 22.(1)) — укажите название ресурса.

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

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

  1. После заполнения данных нажмите кнопку “Сохранить” (Рис. 22.(4)).

4.3. Настройка номеров (при использовании прямого транка)

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

Для этого:

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

Вкладка номера.png
Рис. 23. Вкладка “Номера”
  1. Откроется модальное окно “Добавить номер” (Рис. 24).

Добавить номер.png
Рис. 24. Модальное окно “Добавить номер”
  1. В поле “Номер” укажите номер, который ожидает на своей стороне провайдер. Нажмите кнопку “Добавить”.

4.4. Включение ресурса

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

Вернитесь в реестр ресурсов. В колонке “Состояние” включите переключатель для созданного ресурса (Рис. 25).

Включение ресурса.png
Рис. 25. Включение созданного ресурса

Ресурс должен находиться в активном состоянии image-20260226-081942.png .

5. Создание группы ресурсов

Группа ресурсов используется для объединения одного или нескольких ресурсов и дальнейшего назначения её в IVR-очереди.

5.1. Навигация

Чтобы создать группу ресурсов:

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

image-20260227-084540.png
Рис. 26. Меню
  1. В открывшемся меню выберите: Admin” → “Контакт-центр” → “Группы ресурсов (Рис. 27).

image-20260227-084615.png
Рис. 27. Переход на “Admin” → “Контакт-центр” → “Группы ресурсов”
  1. Откроется страница со списком всех созданных групп ресурсов (Рис. 28).

image-20260227-084714.png
Рис. 28. Страница “Группы ресурсов“

5.2. Создание новой группы ресурсов

  1. Нажмите кнопку “Добавить” в правом верхнем углу страницы (Рис. 29).

image-20260227-085032.png
Рис. 29. Кнопка “Добавить“
  1. Откроется страница создания новой группы.

  2. На вкладке Общее заполните обязательные поля (Рис. 30):

  • Имя — укажите название группы ресурсов.

  • Тип связи — выберите тип связи.

image-20260227-084829.png
Рис. 30. Вкладка “Общее“
  1. Перейдите на вкладку Ресурсы. Нажмите кнопку добавления ресурса (Рис. 31).

image-20260227-085205.png
Рис. 31. Добавление ресурса
  1. Откроется модальное окно “Добавить ресурс” (Рис. 32). Заполните поля:

  • Ресурс — выберите ранее созданный ресурс.

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

  • Резервный ресурс — при необходимости укажите резервный ресурс.

  1. Нажмите кнопку “Добавить”.

image-20260227-085338.png
Рис. 32. Модальное окно “Добавить ресурс“
  1. Добавленный ресурс появится в списке (Рис. 33).

image-20260227-085443.png
Рис. 33. Отображение добавленного ресурса
  1. Перейдите на вкладку Интервал (Рис. 34). Укажите временной интервал работы группы ресурсов:

  • От (hh:mm) — время начала работы.

  • До (hh:mm) — время окончания работы.

При необходимости можно добавить несколько интервалов.

image-20260227-090022.png
Рис. 34. Вкладка “Интервал“
  1. После заполнения всех вкладок нажмите кнопку “Сохранить” в правом верхнем углу (Рис. 35).

image-20260227-090159.png
Рис. 35. Сохранение группы ресурсов
  1. После сохранения группа отобразится в общем списке (Рис. 36).

image-20260227-090234.png
Рис. 36. Отображение добавленной группы ресурсов

6. Создание IVR-дайлера (Outbound IVR Queue)

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

6.1. Навигация

  1. Откройте меню в левом верхнем углу (Рис. 37).

image-20260227-091803.png
Рис. 37. Меню
  1. Перейдите в раздел: “Admin” → “Контакт-центр” → “Очереди (Рис. 38).

image-20260227-091823.png
Рис. 38. Переход на “Admin” → “Контакт-центр” → “Очереди”
  1. Откроется страница со списком всех очередей (Рис. 39).

image-20260227-091943.png
Рис. 39. Страница “Очереди“

6.2. Создание новой очереди

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

image-20260227-092040.png
Рис. 40. Кнопка “Добавить“
  1. В открывшемся модальном окне (Рис. 41) выберите тип: “Исходящая IVR-очередь (Рис. 41.(1)). Нажмите кнопку “Создать” (Рис. 41.(2)). Откроется страница настройки новой очереди.

image-20260227-092214.png
Рис. 41. Модальное окно “Новая очередь“
  1. На вкладке Общее(Рис. 42) заполните основные параметры:

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

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

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

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

image-20260227-092420.png
Рис. 42. Вкладка “Общее“
  1. Перейдите на вкладку Параметры дозвона (Рис. 43). Здесь настраиваются ключевые параметры:

  • Время между попытками (hh:mm:ss) — интервал между дозвонами.

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

  • Лимит задач — ограничение количества активных задач.

  1. Включите параметр “Запись”, который отвечает за запись разговора.

image-20260227-092547.png
Рис. 43. Вкладка “Параметры дозвона“
  1. Перейдите на вкладку Ресурсы. Нажмите кнопку добавления (Рис. 44).

image-20260227-092835.png
Рис. 44. Вкладка “Ресурсы“. Добавление нового ресурса
  1. В модальном окне (Рис. 45) выберите ранее созданную “Группу ресурсов” (Рис. 45.(1)). Нажмите кнопку “Сохранить” (Рис. 45.(2)).

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

image-20260227-093219.png
Рис. 46. Отображение добавленной группы ресурсов
  1. После заполнения всех параметров нажмите кнопку “Сохранить” в правом верхнем углу (Рис. 47).

image-20260227-093335.png
Рис. 47. Сохранение очереди

6.3. Включение IVR-очереди

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

Вернитесь в общий список очередей. В колонке “Состояние” включите переключатель напротив созданного IVR-дайлера (Рис. 48).

image-20260227-093426.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-схема расширяет стандартные возможности очереди и позволяет реализовать более гибкое управление повторными попытками дозвона.