Automatizzazione dei programmi festivi in 3CX

Introduction

Il presente documento offre una guida completa alla configurazione degli annunci relativi alle festività e all'instradamento delle chiamate all'interno di 3CX. Descrive in dettaglio due metodi principali per la gestione dei flussi di chiamata durante le festività: i calendari festivi centralizzati basati sui reparti e lo script di chiamata holiday.cs.

  • I calendari festivi basati sui reparti consentono agli amministratori di definire i giorni festivi e i messaggi associati a livello di reparto. Questi calendari possono quindi essere applicati automaticamente a vari endpoint, tra cui code, IVR, gruppi di squillo e gestione delle chiamate di reparto, semplificando la manutenzione e garantendo messaggi festivi coerenti in tutto il sistema.
  • Lo script di chiamata holiday.cs offre una logica di flusso delle chiamate altamente personalizzabile per requisiti di instradamento più avanzati o specifici.

Calendari festivi basati sui dipartimenti

Questa funzionalità consente di definire i giorni festivi e i messaggi associati a livello di reparto, che possono poi essere applicati dinamicamente a più endpoint.

Passi di configurazione

  • Passo 1 - Creare o selezionare un reparto: prima di definire i giorni festivi, assicurarsi di avere un reparto configurato in 3CX. Se non ne avete uno, dovrete crearlo.
  • Vai su Admin > Reparti.
  • Scegli un reparto esistente o clicca su + Aggiungi per crearne uno nuovo.

  • Passo 2 - Definire i giorni festivi per il reparto: Una volta creato un reparto, è possibile definire giorni festivi specifici e i relativi annunci.
  • Vai su Admin > Orari di ufficio.
  • Seleziona il dipartimento pertinente (ad es. “Ufficio Italia”).
  • Clicca sulla scheda Giorni festivi.
  • Clicca su + Aggiungi per definire un nuovo giorno festivo.
  • Inserisci un nome per il giorno festivo (ad es. “Natale”).
  • Specifica la data del giorno festivo (ad es. “25 dicembre”).
  • Carica o seleziona un prompt (messaggio) esistente da riprodurre durante questa festività (ad es. “Siamo chiusi il giorno di Natale”). Questo messaggio sarà associato in modo centralizzato alla festività.

  • Passo 3 - Assegna il calendario festivo del reparto a un endpoint: Infine, configura gli endpoint desiderati per utilizzare il calendario festivo del reparto.
  • Modifica l'endpoint specifico (ad es. una coda, un gruppo di squilli, un IVR o le impostazioni di gestione delle chiamate del reparto stesso).
  • Individua l'opzione “Quando in festività, instradare verso”.
  • Imposta questa opzione su “Termina chiamata” o su qualsiasi altra destinazione eccetto l'impostazione predefinita “Accetta comunque”. Questa azione sblocca ulteriori opzioni di annuncio festivo.
  • Attiva l'opzione “Riproduci annuncio”.
  • Dal menu a discesa, seleziona “Riproduci messaggio festività reparto”.

L'instradamento festivo dell'endpoint risolverà ora dinamicamente l'annuncio dalle festività attive del reparto, mantenendo la sua destinazione normale.

Come funzionano i calendari festivi basati sul dipartimento

Quando un endpoint (come una coda, un IVR, un gruppo di squilli o la gestione delle chiamate di un reparto) è configurato per utilizzare l'opzione “Riproduci messaggio festivo del reparto”, verificherà automaticamente i giorni festivi definiti per il reparto attivo. Se è attivo un giorno festivo, il sistema riprodurrà l'annuncio festivo associato e seguirà l'instradamento festivo configurato. Ciò elimina la necessità di aggiornare manualmente i messaggi o le regole su ciascun endpoint per ogni festività.

Utilizzo dello script di chiamata holiday.cs

Lo script di chiamata holiday.cs è una funzionalità esistente che fornisce capacità avanzate di instradamento festivo per scenari specifici che potrebbero non essere coperti dai programmi basati sui reparti.

Lo script holiday.cs consente una logica di flusso delle chiamate altamente personalizzata basata su date o condizioni specifiche. Può essere modificato per implementare requisiti di instradamento unici, come messaggi diversi per DID diversi nello stesso giorno festivo, o un instradamento condizionale complesso.

Passaggi di configurazione

  • Passo 1: Creare un giorno festivo
  • Vai su Admin > Orari di ufficio.
  • Seleziona il reparto pertinente e clicca sulla scheda Giorni festivi dell'ufficio.
  • Aggiungi un nuovo giorno festivo con un nome univoco (esempio: Festa nazionale).
  • Passo 2: Preparare il messaggio di festività
  • Registra o crea un file audio (formato.wav) per il messaggio di festività (Esempio: nationalday.wav) e caricarlo.
  • Passo 3: Creare uno script di elaborazione delle chiamate in 3CX
  • Accedi alla Console di amministrazione, andare su Integrazioni > Script di chiamata.
  • Clicca su Aggiungi dallo Store.
  • Selezionare holiday.cs.

  • Inserisci un nome per lo script di chiamata (deve contenere solo caratteri minuscoli e nessun spazio).
  • Seleziona come desideri che questo script venga avviato tramite l'opzione “Esegui questo script”. Ad esempio, scegli “Alla ricezione di una chiamata su un trunk”.
  • Assegna lo script al trunk SIP desiderato.
  • Seleziona un reparto a tua scelta.
  • Clicca su OK per procedere. Verrà reindirizzato alla pagina dell'editor di codice, che compilerà automaticamente lo script.

  • Il contenuto del codice C# verrà caricato nell'editor di codice.
  • Premere Salva per salvare lo script e compilare il codice.

Una volta completata la compilazione, lo script verrà avviato quando viene rilevata una chiamata in arrivo su qualsiasi DID del trunk assegnato.

Come funziona lo script di chiamata holiday.cs

  • Quando arriva una chiamata sul trunk SIP assegnato, lo script viene attivato.
  • Lo script verifica se la data corrente corrisponde a una delle festività che hai definito.
  • Se viene trovata una corrispondenza, lo script riproduce il messaggio audio festivo che hai creato nel Passo 2.
  • Se il giorno cade in un giorno festivo, la chiamata viene instradata alla destinazione festiva.

Quando utilizzare ciascuna opzione

Calendari festivi per dipartimento

  • Consigliato per: La maggior parte dei casi standard di instradamento durante i giorni festivi, in cui un annuncio e un instradamento uniformi si applicano a più terminali all'interno di un reparto.
  • Vantaggi: Semplicità, gestione centralizzata, riduzione del lavoro manuale, applicazione dinamica delle regole relative alle festività.
  • Da utilizzare quando: Si desidera definire una festività una sola volta per un reparto e fare in modo che tutte le code, gli IVR e i gruppi di squillo associati riproducano automaticamente il messaggio corretto relativo alla festività e seguano l'instradamento previsto.

Script di chiamata holiday.cs

  • Consigliato per: Requisiti di instradamento relativi alle festività avanzati o altamente specifici che non possono essere soddisfatti dai programmi basati sui reparti. Ciò include una logica personalizzata per i DID instradati agli utenti o modifiche specifiche al flusso delle chiamate (ad esempio, terminare una chiamata dopo un messaggio o escludere DID specifici).
  • Vantaggi: Elevata flessibilità, logica personalizzata, controllo granulare sul flusso delle chiamate.
  • Da utilizzare quando: É necessario implementare un instradamento unico basato su DID specifici, condizioni complesse basate sul tempo o integrarsi con sistemi esterni per le informazioni sulle festività. Questo metodo richiede familiarità con la modifica degli script di chiamata.

Per saperne di più

Ultimo aggiornamento

Questo documento è stato aggiornato il 4 giugno 2026

https://www.3cx.it/doc/holiday-prompts/