Автоматизация расписания праздников в 3CX

Введение

В руководстве подробно рассматривается настройка праздничных приветствий и маршрутизации вызовов в АТС 3CX. Детально описаны два основных метода управления праздничными сценариями вызовов: централизованные расписания праздников на уровне отделов и скрипт вызовов holiday.cs.

  • Праздничные расписания на уровне отделов позволяют определять праздничные дни и связанные голосовые приветствия. В дальнейшем расписания можно автоматически применять к различным объектам, включая очереди (Queues), голосовые меню (IVRs), группы вызова (Ring Groups) и обработку звонков отделов. В результате упрощается обслуживание и обеспечивается единообразие праздничных сообщений во всей системе.
  • Скрипт вызовов holiday.cs обеспечивает гибкую логику сценариев вызовов для более сложных или специфических требований к маршрутизации.

Расписание праздников на уровне отделов

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

Шаги настройки

  • Шаг 1: Создайте или выберите отдел: перед определением праздничных дней убедитесь, что отдел настроен в АТС 3CX. При отсутствии отдела его необходимо создать.
  • Перейдите в Admin > Departments.
  • Выберите существующий отдел или нажмите + Add для создания нового.

  • Шаг 2: Определите праздничные дни для отдела: после настройки отдела можно указать конкретные праздничные дни и связанные с ними приветствия.
  • Перейдите в Admin > Office Hours.
  • Выберите соответствующий отдел (Department) (например, "Italy Office").
  • Нажмите на вкладку Office Holidays.
  • Нажмите + Add для определения нового праздничного дня.
  • Введите имя (Name) для праздничного дня (например, "Xmas").
  • Укажите дату (Date) для праздничного дня (например, "25 декабря").
  • Загрузите или выберите существующее приветствие для воспроизведения в этот праздничный день (например, "Мы закрыты в Рождество."). Это приветствие будет централизованно привязано к праздничному дню.

  • Шаг 3: Назначьте праздничное расписание отдела конечной точке (Endpoint): настройте необходимые конечные точки для использования праздничного расписания отдела.
  • Отредактируйте конкретную конечную точку (например, очередь, группу вызова, IVR или настройки отдела Department Call Handling).
  • Найдите опцию "When on holiday route to".
  • Переключите эту опцию на "End Call" или любое другое направление, кроме значения по умолчанию "Accept anyway". Это действие открывает дополнительные параметры праздничных приветствий.
  • Включите переключатель "Play Announcement".
  • В выпадающем меню выберите "Play department holiday prompt".

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

Как работают расписания праздников на уровне отделов

Когда конечная точка (такая как  очередь, группу вызова, IVR или собственные настройки Department Call Handling) настроена на использование опции "Play department holiday prompt", система автоматически проверяет определенные праздничные дни активного отдела. Если праздничный день активен, система воспроизводит связанное праздничное приветствие и направляет вызов по настроенному праздничному маршруту. Это исключает необходимость вручную обновлять приветствия или правила на каждой конечной точке для каждого праздника.

Использование скрипта вызовов holiday.cs

Скрипт вызовов holiday.cs - это существующая функция, обеспечивающая расширенные возможности маршрутизации в праздничные дни для специфических сценариев, не охватываемых расписаниями на уровне отделов.

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

Шаги настройки

  • Шаг 1: Создайте праздничный день
  • Перейдите в Admin > Office Hours.
  • Выберите соответствующий отдел и нажмите на вкладку Office Holidays.
  • Добавьте новый праздничный день с уникальным именем (например: National Day).
  • Шаг 2. Подготовьте приветствие для праздника
  • Запишите или создайте аудиофайл (формат .wav) для праздничного приветствия (Например: nationalday.wav) и загрузите его.
  • Шаг 3. Создайте скрипт обработки вызовов в АТС 3CX
  • Войдите в консоль администратора, перейдите в Integrations > Call Scripts.
  • Нажмите Add from Store.
  • Выберите holiday.cs.

  • Введите имя для скрипта вызовов (должно содержать только символы в нижнем регистре без пробелов)
  • Выберите способ запуска скрипта с помощью опции "Run this script". Например, выберите Upon receiving a call on a trunk.
  • Назначьте скрипт нужному SIP транку.
  • Выберите необходимый отдел.
  • Нажмите OK для продолжения. Произойдет перенаправление на страницу редактора кода, где скрипт скомпилируется автоматически.

  • Содержимое кода C# загрузится в редакторе кода.
  • Нажмите Save для сохранения скрипта и компиляции кода.

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

Как работает скрипт вызовов holiday.cs

  • При поступлении вызова на назначенный SIP транк запускается скрипт.
  • Скрипт проверяет, совпадает ли текущая дата с каким-либо из определенных праздничных дней.
  • При обнаружении совпадения скрипт воспроизводит праздничное приветствие, созданное на Шаге 2.
  • Если день является праздничным, вызов направляется на праздничный маршрут.

В каких случаях использовать каждую опцию

Праздничные расписания на уровне отделов

  • Рекомендуется для: большинства стандартных сценариев маршрутизации в праздничные дни, когда единое праздничное приветствие и маршрутизация применяются к нескольким конечным точкам внутри отдела
  • Преимущества: простота, централизованное управление, сокращение ручной работы, динамическое применение праздничных правил
  • Когда использовать: требуется определить праздничный день один раз для отдела, чтобы все связанные очереди, IVRs и группы вызова автоматически воспроизводили правильное праздничное приветствие и следовали праздничной маршрутизации.

Скрипт вызовов holiday.cs

  • Рекомендуется для: расширенных или специфических требований к маршрутизации в праздничные дни, которые невозможно реализовать с помощью расписаний на уровне отделов. Сюда относится кастомная логика для DIDs, маршрутизируемых на пользователей, или специфические изменения сценариев вызовов (например, завершение вызова после приветствия или исключение определенных DIDs)
  • Преимущества: высокая гибкость, кастомная логика, детализированный контроль над сценарием вызовов
  • Когда использовать: необходимо реализовать уникальную маршрутизацию на основе конкретных DIDs, сложных временных условий или интегрировать систему с внешними источниками данных о праздничных днях. Этот метод требует знакомства с редактированием скриптов вызовов.

Дополнительная информация

Версия документа

Последнее обновление документа 4 июня 2026

https://www.3cx.ru/docs/holiday-prompts/