Automatisierung von Feiertagsplänen in 3CX

Einführung

Dieses Dokument bietet eine umfassende Anleitung zur Konfiguration von Feiertagsansagen und der Anrufweiterleitung innerhalb von 3CX. Es beschreibt zwei primäre Methoden zur Verwaltung von Feiertags-Anrufablaufen: zentrale abteilungsbezogene Feiertagspläne und das Anrufskript holiday.cs.

• Abteilungsbezogene Feiertagspläne ermöglichen es Administratoren, Feiertage und die zugehörigen Ansagen auf Abteilungsebene zu definieren. Diese Pläne können dann automatisch auf verschiedene Endpunkte angewendet werden, einschließlich Warteschleifen, IVRs, Rufgruppen und der Abteilungs-Anrufhandhabung, was die Wartung vereinfacht und eine einheitliche Feiertagssprachnachricht im gesamten System gewährleistet.
• Das Anrufskript holiday.cs bietet hochgradig anpassbare Anrufablauf-Logik für erweiterte oder spezifische Routing-Anforderungen.

Abteilungsbezogene Feiertagspläne

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

Konfigurationsschritte

• Schritt 1: Erstellen oder Auswählen einer Abteilung: Bevor Sie Feiertage definieren, stellen Sie sicher, dass Sie eine Abteilung in 3CX konfiguriert haben. Wenn Sie keine haben, müssen Sie eine 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: Definiton von Betriebsfeiertagen für die Abteilung: Sobald Sie eine Abteilung haben, können Sie spezifische Feiertage und deren zugehörige Ansagen definieren.

• Gehen Sie zu Admin > Bürozeiten.
• Wählen Sie die relevante Abteilung aus (z. B. "Italy Office").
• Klicken Sie auf den Reiter Feiertage.
• Klicken Sie auf + Hinzufügen, um einen neuen Feiertag zu definieren.
• Geben Sie einen Namen für den Feiertag ein (z. B. "Xmas").
• Geben Sie das Datum für den Feiertag an (z. B. "25. Dezember").
• Laden Sie eine bestehende Ansage hoch oder wählen Sie eine aus, die an diesem Feiertag abgespielt werden soll (z. B. "Wir haben am Ersten Weihnachtstag geschlossen."). Diese Ansage wird zentral an den Feiertag angehängt.

• Schritt 3: Zuweisen des Abteilungs-Feiertagsplans zu einem Endpunkt: Konfigurieren Sie schlussendlich Ihre gewünschten Endpunkte so, dass sie den Feiertagsplan der Abteilung nutzen.

• Bearbeiten Sie den spezifischen Endpunkt (z. B. eine Warteschleife, Rufgruppe, IVR oder die eigenen Anrufhandhabungseinstellungen der Abteilung).
• Suchen Sie die Option "An Feiertagen weiterleiten an".
• Stellen Sie diese Option z. B. auf "Anruf beenden" oder ein anderes Ziel um, außer die Standardeinstellung "Trotzdem annehmen".

• Diese Aktion schaltet weitere Optionen für Feiertagsansagen frei.

• Aktivieren Sie die Option "Ansage abspielen".
• Ein neues Dropdown-Menü wird angezeigt, das die verfügbaren Ansagen auflistet.

• Wählen Sie "Abteilungs-Feiertagsansage abspielen".

Die Feiertagsweiterleitung des Endpunkts übernimmt nun dynamisch die Ansage des aktiven Abteilungsfeiertags, während das normale Ziel beibehalten wird.

Wie abteilungsbezogene Feiertagspläne funktionieren

Wenn ein Endpunkt (z. B. eine Warteschleife, ein IVR, eine Rufgruppe oder die Anrufhandhabung einer Abteilung) so konfiguriert ist, dass er die Option "Abteilungs-Feiertagsansage abspielen" nutzt, prüft er automatisch die definierten Betriebsfeiertage der aktiven Abteilung. Wenn ein Feiertag aktiv ist, spielt das System die zugehörige Feiertagsansage ab und folgt der konfigurierten Feiertagsweiterleitung. Dadurch entfällt die Notwendigkeit, Ansagen oder Regeln für jeden Feiertag manuell auf jedem Endpunkt zu aktualisieren.

Verwendung des Anrufskripts holiday.cs

Das Anrufskript holiday.cs ist eine bestehende Funktion, die erweiterte Feiertagsweiterleitungsfunktionen für spezielle Szenarien bietet, die möglicherweise nicht durch abteilungsbezogene Pläne abgedeckt werden.

Das Skript holiday.cs ermöglicht hochgradig angepasste Anrufablauf-Logik basierend auf spezifischen Daten oder Bedingungen. Es kann modifiziert werden, um einzigartige Routing-Anforderungen zu implementieren, wie etwa unterschiedliche Ansagen für verschiedene DIDs am selben Feiertag oder komplexe bedingte Weiterleitungen.

Konfigurationsschritte

• Schritt 1: Erstellen Sie einen Feiertag

• Navigieren Sie zu Admin > Bürozeiten.
• Wählen Sie die entsprechende Abteilung aus und klicken Sie auf den Reiter Feiertage.
• Fügen Sie einen neuen Feiertag mit einem eindeutigen Namen hinzu (Beispiel: Nationalfeiertag).

• Schritt 2: Bereiten Sie die Feiertagsansage vor

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

• Schritt 3: Erstellen Sie ein Anrufskript in 3CX

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

• Geben Sie einen Namen für das Anrufskript ein (sollte nur Kleinbuchstaben ohne Leerzeichen enthalten).
• Wählen Sie aus, wie dieses Skript über die Option "Dieses Skript ausführen" 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 Ihrer Wahl aus.
• Klicken Sie auf OK, um fortzufahren. Dadurch werden Sie zur Code-Editor-Seite weitergeleitet, die das Skript automatisch kompiliert.

• Der Inhalt des C#-Codes wird im Code-Editor geladen.
• Drücken Sie Speichern, um das Skript zu speichern und den Code zu kompilieren.

Bei erfolgreicher Kompilierung wird das Skript ausgeführt, wenn ein eingehender Anruf auf einer beliebigen DID des zugewiesenen Trunks erkannt wird.

So funktioniert das Anrufskript holiday.cs

• Wenn ein Anruf über den zugewiesenen SIP-Trunk eingeht, wird das Skript ausgelöst.
• Das Skript prüft, ob das aktuelle Datum mit einem der von Ihnen definierten Feiertage übereinstimmt.
• Wenn eine Übereinstimmung gefunden wird, spielt das Skript die Feiertagsansage ab, die Sie in Schritt 2 erstellt haben.
• 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-Feiertagsweiterleitungsszenarien, bei denen eine einheitliche Feiertagsansage und -weiterleitung für mehrere Endpunkte innerhalb einer Abteilung gilt.
• Vorteile: Einfachheit, zentrale Verwaltung, reduzierter manueller Aufwand, dynamische Anwendung von Feiertagsregeln.
• Verwenden, wenn: Sie einen Feiertag einmal für eine Abteilung definieren möchten und alle zugehörigen Warteschleifen, IVRs und Rufgruppen automatisch die richtige Feiertagsansage abspielen und der Feiertagsweiterleitung folgen sollen.

holiday.cs Anrufskript

• Empfohlen für: Erweiterte oder hochspezifische Feiertagsweiterleitungsanforderungen, die nicht durch abteilungsbezogene Pläne erfüllt werden können. Dies umfasst benutzerdefinierte Logik für DIDs, die an Nutzer weitergeleitet werden, oder spezifische Anrufablaufänderungen (z. B. Beenden eines Anrufs nach einer Ansage oder Ausschluss bestimmter DIDs).
• Vorteile: Hohe Flexibilität, benutzerdefinierte Logik, feingranulare Kontrolle über den Anrufablauf.
• Verwenden, wenn: Sie eine eindeutige Weiterleitung basierend auf bestimmten DIDs, komplexen zeitbasierten Bedingungen oder der Integration externer Systeme für Feiertagsinformationen implementieren müssen. Diese Methode erfordert Vertrautheit mit der Anrufskript-Bearbeitung.
• Beispielszenario: Sie möchten, dass die Feiertagsweiterleitung für bestimmte DIDs gilt, bevor der Anruf ein IVR oder eine Warteschleife erreicht, damit Sie das Feiertagsverhalten direkt am Eingang verwalten können.

Nicht beide im selben Anrufpfad verwenden

Vermeiden Sie die Verwendung von sowohl holiday.cs als auch Feiertagsansagen auf Endpunktebene im selben Anrufpfad. Wenn beide aktiviert sind, hört der Anrufer die Feiertagsansage möglicherweise zweimal: einmal vom Anrufskript und noch einmal vom Endpunkt.

Wählen Sie eine Methode pro Anrufablauf:

• verwenden Sie Feiertagsansagen auf Endpunktebene für einfache IVR-, Warteschleifen-, Rufgruppen- oder Abteilungs-Feiertagsansagen
• verwenden Sie holiday.cs, wenn Sie eine erweiterte Kontrolle auf Trunk-, DID-, Anrufer-ID- oder Eingangsebene benötigen und wenn etwas passieren soll, bevor der Anruf den Endpunkt erreicht

Siehe auch

• Konfigurieren Ihrer Bürozeiten

Letztes Update

Dieses Dokument wurde zuletzt am 22. September 2026 aktualisiert.

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