AdminGuide:Service:CallCampaign

Servizio Campagne di avviso

Il servizio “Campagne di avviso” presente sul Kalliope PBX, permette di effettuare una sessione di chiamate automatiche verso un gruppo di destinatari, riproducendo a ciascuno un messaggio audio e registrando la conferma di avvenuto ascolto da parte di ciascuno di essi.

A livello generale, il nuovo servizio consente la configurazione, tramite pannello WEB delle campagne di avviso, ciascuna caratterizzata da un insieme di parametri specifici:

• lista dei partecipanti (interni ed esterni al PBX)
• messaggio da riprodurre
• numero massimo di chiamate esterne contemporanee
• necessità di acquisire o meno le conferme di risposta e di ascolto
• numero di tentativi di chiamata verso ciascun destinatario

Un utente con gli adeguati diritti può operare sulle campagne configurate per comandarne l’avvio (istantaneo o ritardato), visualizzarne lo stato di esecuzione, comandarne la sospensione o l’interruzione.
Una campagna terminerà nel momento in cui per ciascuno dei destinatari configurati si verifichi una delle seguenti condizioni:

• il destinatario risponde alla chiamata e fornisce conferma di risposta e/o di ascolto (se richieste); questa condizione indica il “successo” nel contatto del destinatario
• viene raggiunto il numero massimo di tentativi di chiamata verso quel destinatario, senza che sia soddisfatta la condizione precedente.

Nel caso in cui tutti i destinatari (o il numero minimo richiesto per quella specifica campagna) siano stati contattati con successo, la campagna passa nello stato “Completata”; in caso contrario, al momento dell’esaurimento dei tentativi di chiamata verso tutti i destinatari, la campagna passa nello stato “Incompleta”. In quest’ultimo stato, l’utente può assegnare ulteriori tentativi di chiamata verso uno o più destinatari che non sono stati contattati con successo fino ad allora, oppure marcare come definitivamente chiusa la campagna, portandola nello stato “Terminata”.
Oltre alla gestione in tempo reale delle singole campagne di esecuzione delle campagne di avviso (con visualizzazione dello stato per ciascun destinatario) è possibile accedere ad un registro storico di esecuzione delle campagne concluse: nel registro di queste esecuzioni sono salvati sia agli eventi relativi all’esecuzione della campagna che tutti i parametri di configurazione di esecuzione della stessa, così da poterli consultare anche in caso di modifica della configurazione della campagna o la sua eventuale cancellazione.

Configurazione del Servizio

Il servizio delle Campagne di avviso viene configurato nel pannello “Applicazioni PBX” -> “Campagne di avviso”. La visibilità del pannello e dei relativi tab è condizionata ai permessi associati al ruolo dell’utente.
Il pannello delle Campagne di avviso prevede tre tab:

• Lista Modelli e Lista Campagne (associate all’abilitazione “Gestione delle Campagne di Avviso”)
• Impostazioni generali (associate all’abilitazione “Gestione delle Impostazioni generali delle Campagne di avviso”)

Nel pannello “Impostazioni generali” è possibile configurare i limiti globali del servizio, in termini di numero massimo di campagne attive simultaneamente, e di numero massimo di chiamate contemporanee (a interni, a esterni, e complessive) tra tutte le campagne attive ad un certo momento. I parametri di configurazione sono:

• Numero massimo di campagne simultanee attive: indica il numero massimo di campagne che possono essere contemporaneamente nello stato “Attiva”.
  Il parallelismo riguarda l’effettiva esecuzione delle chiamate delle campagne, per cui ad esempio con grado di parallelismo 1 è possibile avviare una campagna anche in caso di una altra campagna già in esecuzione. Le campagne saranno ordinate in base all’attributo “priorità”, ed in caso di parità in base all’ora di avvio, e il sistema effettuerà le chiamate scegliendo i destinatari dalla campagna a priorità maggiore (entro i vincoli di contemporaneità di chiamata globali e di singola campagna).
  Il valore vuoto indica illimitato.
• Contemporaneità massima chiamate totali/interne/esterne: questi 3 valori determinano il numero massimo di chiamate contemporanee che il sistema può effettuare tra tutte le campagne attive
  Il valore vuoto indica nessun limite.
  NOTA: La somma dei limiti impostati per le chiamate interne ed esterne può eccedere il limite totale, ma comunque il numero di chiamate effettivamente in esecuzione non lo potrà superare (Es. con i valori 10/8/6, possono esserci al più 8 chiamate interne, 6 chiamate esterne, ma complessivamente non più di 10 chiamate; se quindi ad un dato momento sono in esecuzione 7 chiamate interne, potranno essere attive al massimo 3 chiamate esterne)

Ogni volta che una chiamata di una campagna termina (con successo o meno), oppure quando viene attivata una nuova campagna, lo scheduler delle chiamate (che si occupa di determinare se è possibile effettuare una nuova chiamata e verso quale destinatario tra tutti quelli possibili per le varie campagne) opera utilizzando il valore corrente di tali limiti.

Per poter avviare una Campagna, è necessario che prima venga definito un Modello di campagna, a cui sono associati un insieme di parametri che determinano il comportamento delle campagne attivate a partire da quel modello, e quindi venga avviata (o programmata ad una certa data/ora nel futuro) la Campagna a partire da quel modello. Da uno stesso modello possono essere avviate più campagne, in tempi diversi, modificando per ciascuna di esse un sottoinsieme dei parametri di configurazione ereditati dal modello, come il file audio da riprodurre o l’elenco dei destinatari.

La prima operazione da fare per attivare una Campagna è quindi creare un Modello, dal pannello “Lista Modelli”, cliccando sull’azione “Aggiungi nuovo modello di campagna”.
Il pannello di creazione (o modifica) di un Modello di Campagna permette la configurazione dei seguenti parametri:

• Abilitato: check-box che indica se il Modello è abilitato. Se un Modello è disabilitato non possono essere avviate o pianificate Campagne che lo utilizzano
• Nome: nome della Campagna. Ammette caratteri alfanumerici, spazi, trattini, underscore. Questo attributo viene utilizzato come Display-Name per le chiamate effettuate dalla Campagna verso i destinatari
• Numero chiamante: è il numero chiamante utilizzato dal sistema per effettuare le chiamate della campagna. Viene utilizzato sia per le chiamate ad altri interni che per le chiamate a numeri esterni. Nel caso di chiamate esterne il numero chiamante effettivo sarà derivato da questo in base alle regole di manipolazione configurate per la linea di uscita che sarà impegnata.
• Classe di instradamento in uscita: determina l’instradamento delle chiamate verso i destinatari esterni. Nel caso in cui la classe non permetta di chiamare uno o più dei destinatari configurati, le relative chiamate falliranno ma non viene effettuato un controllo preventivo.
• Priorità: questo valore viene utilizzato dallo scheduler di generazione delle chiamate nel momento in cui si libera lo spazio per una nuova chiamata se sono presenti 2 o più campagne attive.
• File audio: selezione del file audio da riprodurre a ciascun destinatario.
• Soglia di completamento: questo parametro indica il numero di destinatari che è sufficiente contattare con successo per considerare la campagna completa.
• Numero di tentativi di chiamata: questo parametro indica il numero massimo di tentativi di chiamata (senza successo) che possono essere effettuati verso il destinatario. Al raggiungimento di tale numero di chiamate senza che il destinatario abbia risposto e dato conferma (di risposta o ascolto, se richieste), il sistema non effettuerà più nuovi tentativi di chiamata verso questo destinatario, che risulterà quindi “non contattato” in modo definitivo. È facoltà dell’utente che gestisce la campagna di poter aggiungere nuovi tentativi di chiamata verso quei destinatari per i quali sia stato esaurito questo limite.
• Questo valore non può essere illimitato (default 5).
• Timeout per chiamata: il timeout di squillo (in secondi) per ciascuna chiamata effettuata dalla campagna
• Richiedi conferma di risposta: questa check-box indica se il sistema deve richiedere al destinatario la digitazione del tasto 1 per confermare che abbia effettivamente risposto, prima di effettuare la riproduzione del messaggio. Questa impostazione vale sia per i destinatari interni che esterni, ed assicura che la chiamata non sia andata ad un risponditore o casella vocale.
• Richiesta conferma ascolto: questa check-box indica se il sistema deve richiedere al destinatario la digitazione del tasto 9 al termine dell’ascolto del messaggio, a conferma dell’effettivo ascolto e comprensione di questo. La mancata conferma o la pressione di un tasto diverso da quello indicato causa la ripetizione del messaggio. Se la chiamata viene abbattuta senza conferma di ascolto, il sistema considererà il destinatario come “non contattato”, e se il destinatario ha ancora tentativi residui (perché non ha raggiunto il numero massimo di tentativi di chiamata configurati per la campagna) potrà essere nuovamente chiamato in seguito, in base alle politiche di scheduling del servizio.
• Contemporaneità massima chiamate interne/esterne/totali: questi 3 valori determinano il numero massimo di chiamate che questa campagna può effettuare complessivamente, verso destinatari interni e verso destinatari esterni. Un valore “null” indica nessun limite. La somma dei limiti impostati per le interne e le esterne può eccedere il limite totale, ma comunque il numero di chiamate effettivamente in esecuzione non lo potrà superare.
• Elenco destinatari: questo elenco viene popolato con destinatari interni o esterni. Nel caso di contatti inseriti manualmente, oltre al numero si possono specificare un nome ed un indirizzo mail (per l’invio del messaggio). L’elenco è ordinabile; lo scheduler delle chiamate utilizzerà tale ordinamento in fase di selezione della prossima chiamata da effettuare, a parità degli altri parametri.

Una volta creato il modello questo apparirà nel pannello “Lista Modelli”, da cui l’utente abilitato può effettuare le seguenti operazioni:

• Creare un numero arbitrario di Modelli di Campagne
• Cancellare uno o più Modelli di Campagna esistenti selezionando l’icona Cestino.
  Nel caso di un Modello da cui siano state avviate o programmate una o più Campagne, la cancellazione è permessa, in quanto tutti i parametri necessari all’esecuzione della campagna di avviso sono stati già copiati dal modello nella configurazione operativa di quella campagna. All’utente viene comunque indicata l’esistenza di campagne in corso o schedulate associate a tale Modello, mediante pop-up di conferma cancellazione.
• Clonare un Modello esistente per crearne una nuova, che ne eredita le impostazioni
• Modificare la configurazione di un Modello di Campagna precedentemente creata; nel caso di una Campagna per la quale esistano una o più istanze in esecuzione o schedulata, la modifica è comunque permessa a seguito dell’indicazione mediante il pop-up di conferma.
• Visualizzare la lista dei destinatari della Campagna.