Automatyzacja harmonogramów świątecznych w 3CX

Wprowadzenie

Niniejszy dokument stanowi kompleksowy przewodnik po konfiguracji komunikatów świątecznych i kierowania połączeń w systemie 3CX. Szczegółowo opisuje dwie główne metody zarządzania przepływem połączeń świątecznych: scentralizowane harmonogramy świąteczne oparte na działach oraz skrypt połączeń holiday.cs.

  • Harmonogramy świąteczne oparte na działach pozwalają administratorom definiować święta i powiązane z nimi komunikaty na poziomie działu. Harmonogramy te mogą być następnie automatycznie stosowane do różnych punktów końcowych (endpoints), w tym kolejek, wirtualnych recepcjonistów (IVR), grup dzwonienia oraz obsługi połączeń działu, co usprawnia utrzymanie systemu i zapewnia spójność komunikatów świątecznych w całym systemie.
  • Skrypt połączeń holiday.cs oferuje wysoce konfigurowalną logikę przepływu połączeń dla bardziej zaawansowanych lub specyficznych wymagań dotyczących routingu.

Harmonogramy świąteczne oparte na działach

Ta funkcjonalność pozwala na zdefiniowanie świąt i powiązanych z nimi komunikatów na poziomie działu, które mogą być następnie dynamicznie stosowane do wielu punktów końcowych.

Kroki konfiguracji

  • Krok 1: Utworzenie lub wybór działu: Przed zdefiniowaniem świąt upewnij się, że masz skonfigurowany dział w 3CX. Jeśli go nie masz, musisz go utworzyć.
  • Przejdź do „Admin” > „Departments” (Działy).
  • Wybierz istniejący dział lub kliknij „+ Add” (+ Dodaj), aby utworzyć nowy.

  • Krok 2: Definiowanie dni świątecznych dla działu: Gdy masz już dział, możesz zdefiniować konkretne święta i powiązane z nimi komunikaty.
  • Przejdź do „Admin” > „Office Hours” (Godziny pracy).
  • Wybierz odpowiedni dział (np. „Biuro Włochy”).
  • Kliknij zakładkę „Office Holidays” (Święta biurowe).
  • Kliknij „+ Add” (+ Dodaj), aby zdefiniować nowe święto.
  • Wprowadź „Name” (Nazwa) dla święta (np. „Xmas”).
  • Określ „Date” (Data) święta (np. „25 December”).
  • Prześlij lub wybierz istniejący komunikat (prompt), który ma być odtwarzany podczas tego święta (np. „W Boże Narodzenie nasze biuro jest zamknięte.”). Ten komunikat będzie centralnie przypisany do danego święta.

  • Krok 3: Przypisanie świątecznego harmonogramu działu do punktu końcowego: Na koniec skonfiguruj wybrane punkty końcowe tak, aby korzystały z harmonogramu świątecznego działu.
  • Edytuj konkretny punkt końcowy (np. kolejkę, grupę dzwonienia, wirtualnego recepcjonistę lub własne ustawienia obsługi połączeń działu).
  • Zlokalizuj opcję „When on holiday route to” (Podczas święta kieruj do).
  • Zmień tę opcję na „End Call” (Zakończ połączenie) lub dowolne inne miejsce docelowe poza domyślnym „Accept anyway” (Mimo to akceptuj). To działanie odblokuje dalsze opcje komunikatów świątecznych.
  • Włącz przełącznik „Play Announcement” (Odtwórz komunikat).
  • Z menu rozwijanego wybierz „Play department holiday prompt” (Odtwórz komunikat świąteczny działu).

Trasa świąteczna punktu końcowego będzie teraz dynamicznie pobierać komunikat z aktywnego święta działu, zachowując jednocześnie swoje normalne miejsce docelowe.

Jak działają harmonogramy świąteczne oparte na działach

Gdy punkt końcowy (taki jak kolejka, wirtualny recepcjonista, grupa dzwonienia lub obsługa połączeń działu) jest skonfigurowany do korzystania z opcji „Play department holiday prompt”, system automatycznie sprawdzi święta biurowe zdefiniowane dla aktywnego działu. Jeśli święto jest aktywne, system odtworzy powiązany komunikat świąteczny i zastosuje skonfigurowane kierowanie świąteczne. Eliminuje to potrzebę ręcznej aktualizacji komunikatów lub reguł w każdym punkcie końcowym przy okazji każdego święta.

Korzystanie ze skryptu połączeń holiday.cs

Skrypt połączeń holiday.cs to istniejąca funkcja, która zapewnia zaawansowane możliwości kierowania połączeń w dni świąteczne dla konkretnych scenariuszy, które mogą nie być objęte harmonogramami opartymi na działach.

Skrypt holiday.cs pozwala na wysoce spersonalizowaną logikę przepływu połączeń opartą na konkretnych datach lub warunkach. Można go modyfikować w celu wdrożenia unikalnych wymagań dotyczących routingu, takich jak różne komunikaty dla różnych numerów DID w tym samym dniu świątecznym lub złożone kierowanie warunkowe.

Kroki konfiguracji

  • Krok 1: Utworzenie święta
  • Przejdź do „Admin” > „Office Hours” (Godziny pracy).
  • Wybierz odpowiedni dział i kliknij zakładkę „Office Holidays” (Święta biurowe).
  • Dodaj nowe święto z unikalną nazwą (przykład: „National Day”).
  • Krok 2: Przygotowanie komunikatu świątecznego
  • Nagraj lub utwórz plik audio (format .wav) dla komunikatu świątecznego (przykład: nationalday.wav) i prześlij go.
  • Krok 3: Utworzenie skryptu przetwarzania połączeń w 3CX
  • Zaloguj się do Konsoli Administracyjnej, przejdź do „Integrations” (Integracje) > „Call Scripts” (Skrypty połączeń).
  • Kliknij „Add from Store” (Dodaj ze sklepu).
  • Wybierz holiday.cs.

  • Wprowadź nazwę dla skryptu połączeń (powinna zawierać tylko małe litery bez spacji).
  • Wybierz sposób uruchamiania skryptu w opcji „Run this script” (Uruchom ten skrypt). Wybierz na przykład „Upon receiving a call on a trunk” (Po odebraniu połączenia na trunku).
  • Przypisz skrypt do wybranego trunku SIP.
  • Wybierz dowolny dział.
  • Kliknij „OK”, aby kontynuować. Zostaniesz przekierowany do strony edytora kodu, który automatycznie skompiluje skrypt.

  • Treść kodu C# zostanie załadowana w edytorze kodu.
  • Naciśnij „Save” (Zapisz), aby zapisać skrypt i skompilować kod.

Gdy kompilacja zakończy się sukcesem, skrypt będzie uruchamiany w momencie wykrycia połączenia przychodzącego na dowolnym numerze DID przypisanego trunku.

Jak działa skrypt połączeń holiday.cs

  • Gdy na przypisany trunk SIP przychodzi połączenie, skrypt zostaje wyzwolony.
  • Skrypt sprawdza, czy bieżąca data zgadza się z którymkolwiek ze zdefiniowanych świąt.
  • Jeśli dopasowanie zostanie znalezione, skrypt odtwarza komunikat audio utworzony w Kroku 2.
  • Jeśli dzień jest dniem świątecznym, połączenie jest kierowane do miejsca docelowego dla świąt.

Kiedy wybrać konkretną opcję

Harmonogramy świąteczne oparte na działach

  • Zalecane dla: Większości standardowych scenariuszy kierowania połączeń w dni świąteczne, gdzie spójny komunikat i routing mają zastosowanie do wielu punktów końcowych w ramach działu.
  • Korzyści: Prostota, scentralizowane zarządzanie, mniejszy nakład pracy ręcznej, dynamiczne stosowanie reguł świątecznych.
  • Użyj, gdy: Chcesz zdefiniować święto raz dla działu i sprawić, by wszystkie powiązane kolejki, wirtualni recepcjoniści i grupy dzwonienia automatycznie odtwarzały poprawny komunikat świąteczny i przestrzegały kierowania świątecznego.

Skrypt połączeń holiday.cs

  • Zalecane dla: Zaawansowanych lub wysoce specyficznych wymagań dotyczących kierowania świątecznego, których nie można spełnić za pomocą harmonogramów opartych na działach. Obejmuje to niestandardową logikę dla numerów DID kierowanych do użytkowników lub specyficzne modyfikacje przepływu połączeń (np. zakończenie połączenia po komunikacie lub wykluczenie konkretnych numerów DID).
  • Korzyści: Wysoka elastyczność, niestandardowa logika, szczegółowa kontrola nad przepływem połączeń.
  • Użyj, gdy: Musisz wdrożyć unikalny routing oparty na konkretnych numerach DID, złożone warunki czasowe lub zintegrować się z zewnętrznymi systemami w celu uzyskania informacji o świętach. Ta metoda wymaga znajomości edycji skryptów połączeń.

Zobacz również


Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 4 czerwca 2026 r.
https://www.3cx.pl/docs/holiday-prompts/