Automatisierung von Feiertagsplänen in 3CX

Einführung

Dieses Dokument bietet eine umfassende Anleitung zur Konfiguration von Feiertagsansagen und Anrufweiterleitung in 3CX. Es beschreibt zwei Hauptmethoden zur Verwaltung von Anrufabläufen an Feiertagen: zentralisierte abteilungsbasierte Feiertagspläne und das Anrufskript holiday.cs.

• Abteilungsbezogene Feiertagspläne ermöglichen es Administratoren, Feiertage und die zugehörigen Ansagen auf Abteilungsebene festzulegen. Diese Pläne können anschließend automatisch auf verschiedene Endpunkte angewendet werden, darunter Warteschleifen, IVR-Systeme, Rufgruppen und die Anrufbearbeitung der Abteilungen. Dies vereinfacht die Wartung und gewährleistet eine einheitliche Feiertagskommunikation im gesamten System.
• Das Anrufskript holiday.cs bietet eine hochgradig anpassbare Anrufablauflogik für erweiterte oder spezifische Routing-Anforderungen.

Abteilungsbezogene Feiertagspläne

Diese Funktionalität ermöglicht es Ihnen, Feiertage und zugehörige Eingabeaufforderungen auf Abteilungsebene zu definieren, die dann dynamisch auf mehrere Endpunkte angewendet werden können.

Konfigurationsschritte

• Schritt 1: Abteilung erstellen oder auswählen: Bevor Sie Feiertage definieren, stellen Sie sicher, dass Sie in 3CX eine Abteilung konfiguriert haben. Falls Sie noch keine haben, müssen Sie diese erstellen.

• Navigieren Sie zu Admin > Abteilungen.
• Wählen Sie eine bestehende Abteilung aus oder klicken Sie auf +Hinzufügen, um eine neue zu erstellen.

• Schritt 2: Feiertage für die Abteilung festlegen: Sobald Sie eine Abteilung haben, können Sie spezifische Feiertage und die dazugehörigen Ankündigungen definieren.

• Gehen Sie zu „Admin“ > „Geschäftszeiten“.
• Wählen Sie die entsprechende Abteilung aus (z. B. „Büro Italien“).
• Klicken Sie auf den Reiter „Feiertage/Urlaub“.
• Klicken Sie auf „+Hinzufügen“, um einen neuen Feiertag anzulegen.
• Geben Sie einen Namen für den Feiertag ein (z. B. „Weihnachten“).
• Geben Sie das Datum für den Feiertag an (z. B. „25. Dezember“).
• Laden Sie eine Ansage hoch oder wählen Sie eine vorhandene aus, die während dieses Feiertags abgespielt werden soll (z. B. „Wir haben am ersten Weihnachtsfeiertag geschlossen.“). Diese Ansage wird dem Feiertag zugeordnet.

• Schritt 3: Feiertagskalender der Abteilung einem Endpunkt zuweisen: Konfigurieren Sie abschließend die gewünschten Endpunkte so, dass sie den Feiertagskalender der Abteilung nutzen.

• Bearbeiten Sie den gewünschten Endpunkt (z. B. eine Warteschleife, eine Rufgruppe, ein IVR-System oder die Anrufeinstellungen der Abteilung).
• Suchen Sie die Option „Wenn Feiertag/Urlaub, weiterleiten an“.
• Ändern Sie diese Option auf „Gespräch beenden“ oder ein anderes Ziel außer der Standardeinstellung „Trotzdem akzeptieren“. Dadurch werden weitere Optionen für Feiertagsansagen freigeschaltet.
• Aktivieren Sie die Option „Ansage wiedergeben“.
• Wählen Sie im Dropdown-Menü „Abteilungsfeiertagsansage abspielen“ aus.

Die Urlaubsroute des Endpunkts wird nun die Ansage des aktiven Abteilungsfeiertags dynamisch auflösen, wobei das normale Ziel beibehalten wird.

Wie abteilungsbezogene Urlaubspläne funktionieren

Wenn ein Endpunkt (z. B. eine Warteschleife, ein IVR-System, eine Rufgruppe oder die Anrufverwaltung einer Abteilung) für die Option „Abteilungsfeiertagsansage abspielen“ konfiguriert ist, prüft er automatisch die definierten Feiertage der aktiven Abteilung. Ist ein Feiertag aktiv, spielt das System die zugehörige Feiertagsansage ab und folgt der konfigurierten Feiertagsweiterleitung. Dadurch entfällt die Notwendigkeit, Ansagen oder Regeln für jeden Endpunkt manuell für jeden Feiertag zu aktualisieren.

Verwendung des Aufrufskripts holiday.cs

Das Aufrufskript holiday.cs ist eine bestehende Funktion, die erweiterte Möglichkeiten zur Urlaubsplanung für bestimmte Szenarien bietet, die möglicherweise nicht durch die abteilungsbasierten Zeitpläne abgedeckt werden.

Das Skript holiday.cs ermöglicht eine hochgradig individualisierte Anrufablauflogik basierend auf bestimmten Daten oder Bedingungen. Es kann angepasst werden, um spezielle Routing-Anforderungen zu implementieren, wie z. B. unterschiedliche Ansagen für verschiedene Rufnummern am selben Feiertag oder komplexe bedingte Weiterleitungen.

Konfigurationsschritte

• Schritt 1: Einen Feiertag erstellen

• Navigieren Sie zu „Administration“ > „Geschäftszeiten“.
• Wählen Sie die entsprechende Abteilung aus und klicken Sie auf den Reiter „Feiertage/Urlaub“.
• Fügen Sie einen neuen Feiertag mit einem eindeutigen Namen hinzu (z. B. „Nationalfeiertag“).

• Schritt 2: Bereiten Sie die Feiertags-Aufforderung vor

• Nehmen Sie eine Audiodatei (im .wav-Format) für die Feiertagsansage auf (Beispiel: nationalfeiertag.wav) und laden Sie diese hoch.

• Schritt 3: Erstellen Sie ein Anrufverarbeitungsskript in 3CX

• Melden Sie sich in Ihrer Admin-Konsole an und gehen Sie zu Integrationen > Anrufskripte.
• Klicken Sie auf „Aus Store hinzufügen“.
• Wählen Sie holiday.cs aus.

• Geben Sie einen Namen für das Anrufskript ein (nur Kleinbuchstaben, keine Leerzeichen).
• Wählen Sie unter „Dieses Skript ausführen“ aus, wie das Skript gestartet werden soll. Wählen Sie beispielsweise „Bei eingehendem Anruf auf einem Trunk“.
• Weisen Sie das Skript dem gewünschten SIP-Trunk zu.
• Wählen Sie eine Abteilung aus.
• Klicken Sie auf „OK“, um fortzufahren. Sie werden zum Code-Editor weitergeleitet, der das Skript automatisch kompiliert.

• Der Inhalt des C#-Codes wird im Code-Editor geladen.
• Klicken Sie auf „Speichern“, um das Skript zu speichern und den Code zu kompilieren.

Wenn die Kompilierung erfolgreich war, wird das Skript gestartet, sobald ein eingehender Anruf auf einer beliebigen Rufnummer des zugewiesenen Trunks erkannt wird.

So funktioniert das Aufrufskript holiday.cs

• Wenn ein Anruf auf dem zugewiesenen SIP-Trunk eingeht, wird das Skript ausgeführt.
• Das Skript prüft, ob das aktuelle Datum mit einem der von Ihnen definierten Feiertage übereinstimmt.
• Falls ja, spielt das Skript die in Schritt 2 erstellte Feiertagsansage ab.
• Fällt der Tag auf einen Feiertag, wird der Anruf an das Feiertagsziel weitergeleitet.

Wann welche Option verwenden?

Abteilungsbezogene Feiertagspläne

• Empfohlen für: Die meisten Standard-Urlaubsrouting-Szenarien, in denen eine einheitliche Feiertagsansage und ein einheitliches Routing für mehrere Endpunkte innerhalb einer Abteilung gelten.
• Vorteile: Einfache Verwaltung, zentralisierte Verwaltung, geringerer manueller Aufwand, dynamische Anwendung von Feiertagsregeln.
• Anwendung: Wenn Sie einen Feiertag einmalig für eine Abteilung definieren und alle zugehörigen Warteschlangen, IVR-Systeme und Anrufgruppen automatisch die korrekte Feiertagsansage abspielen und dem Feiertagsrouting folgen sollen.

holiday.cs Anrufskript

• Empfohlen für: Erweiterte oder sehr spezifische Anforderungen an die Anrufweiterleitung an Feiertagen, die nicht durch abteilungsbasierte Dienstpläne abgedeckt werden können. Dies umfasst benutzerdefinierte Logik für die Weiterleitung von Rufnummern an Benutzer oder spezifische Änderungen des Anrufablaufs (z. B. Beendigung eines Anrufs nach einer Ansage oder Ausschluss bestimmter Rufnummern).
• Vorteile: Hohe Flexibilität, benutzerdefinierte Logik, detaillierte Kontrolle über den Anrufablauf.
• Anwendung: Wenn Sie eine individuelle Anrufweiterleitung basierend auf bestimmten Rufnummern, komplexen zeitbasierten Bedingungen implementieren oder externe Systeme für Feiertagsinformationen integrieren müssen. Diese Methode erfordert Kenntnisse in der Bearbeitung von Anrufskripten.

Siehe auch

• Konfigurieren Ihrer Bürozeiten

Letztes Update

Dieses Dokument wurde zuletzt am 4. Juni 2026 aktualisiert.

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