AdminGuide:Service:EventsNotification

Torna a AdminGuide:Service

Descrizione del servizio

Tramite questo servizio è possibile monitorare gli eventi selezionati ricevendo delle notifiche.

Per ogni evento selezionato dall’utente è possibile associare delle azioni di notifica, come l’invio di una mail o la chiamata ad un Web Service.

Configurazione del servizio

Nella sessione Monitoraggio → Notifiche è possibile gestire la funzionalità di notifica.

Notification Action List

In Notification Action List è possibile aggiungere una nuova notification selezionando l’azione di Email o WebService.

Email

Selezionando Add New Email Notification Action è possibile definire il destinatario della mail di notifica dell’evento e le informazioni che vogliamo trasmettere. Nella tabella seguente sono illustrati i parametri che è possibile definire per l’Email Notification.

Parametro	Descrizione	Valore
-
Abilitato	Consente di disabilitare l’Email Notification	Si / No
Nome	Identificativo della notifica	Alfanumerico
Email Settings
Destinatari	indirizzo email del destinatario della notifica	Alfanumerico
Soggetto	Oggetti della mail di notifica	Alfanumerico
Body	Testo dell’email contenente placeholder sia di default che specifici dell’ evento	Alfanumerico

I parametri generici sono elencati nella seguente tabella:

Parametro	Descrizione
-
%event_id%	sequenziale dell'evento
%event_name%	identificativo dell'evento
%event_description%	descrizione testuale dell'evento
%event_severity%	criticità dell'evento (numerica, da 4 a 0 corrispondenti ai livelli DEBUG|INFO|WARNING|CRITICAL|FATAL
%event_timestamp%	epoch di occorrenza dell'evento

I parametri specifici di evento sono invece elencati nella nel pannello Notification; questi paramentri possono essere riportati in tre formati diversi: JSON, XML e AVP.

Il set completo dei parametri relativi ad un evento è ottenibile con il placeholder: %call_params[<format>]%

Web Service

Selezionando Add New WebService Notification Action è necessario inserire il nome della notification che partirà al verificarsi dell’evento, tra le impostazioni generali.

Nella tabella seguente sono illustrati i parametri che è possibile definire per la WebService Notification.

Parametro	Descrizione	Valore
-
Abilitato	Consente di disabilitare la WebService Notification	Si / No
Nome	Identificativo della notifica	Alfanumerico
WebService Settings
URL	URL di Notifica	Alfanumerico
Tipo Auth	Tipo di Autenticazione	None/ Basic
Auth username	Username per autenticazione (solo in caso Auth)	Alfanumerico
Auth password	Password per autenticazione (solo in caso Auth)	Alfanumerico
Tipo Request	Tipo della richiesta	Get/Post
Request content	Contenuto della richiesta (solo Post)	Placeholder

Al verificarsi dell’evento arriverà una segnalazione al WebService esterno che gestirà le informazioni ricevute.

Notification List

Nella sezione Notification List, selezionando Add new notification è possibile selezionare l’evento per cui ottenere la notifica.

Nella tabella seguente sono elencati gli eventi che possono essere monitorati e a cui può essere associata una notifica.

Evento	Descrizione
pbx.queue.enter	Una chiamata arriva al servizio di coda
pbx.queue.enqueue	Una chiamata entra nel servizio di coda; rispetto all'evento precedente, significa che la coda è aperta
pbx.queue.ringmember	Una chiamata viene presentata ad un operatore di coda
pbx.queue.ringnoanswer	Un operatore selezionato non ha gestito la chiamata; la chiamata è ancora in coda e andrà ad altri operatori, se ci sono e non è scaduto il tempo massimo di attesa
pbx.queue.servedcall	Una chiamata nella coda è stata servita, ovvero risposta da un operatore
pbx.queuemember.pause	Un operatore di coda è entrato in pausa
pbx.queuemember.unpause	Un operatore di coda è uscito dalla pausa
pbx.queue.unservedcall	Una chiamata nella coda non è stata servita globalmente; rappresenta quindi l'esito finale della chiamata che non è stata servita da nessun operatore
pbx.extension.missedcall	Un interno ha perso una chiamata; l'evento viene innescato solo se nelle azioni di trabocco di quell'interno è spuntata la voce "genera evento"
pbx.extension.missedcall	Un interno ha perso una chiamata; l'evento viene innescato solo se nelle azioni di trabocco di quell'interno è spuntata la voce "genera evento"
pbx.dynamic-routing.enter	Una chiamata è entrata nel servizio di Instradamento dinamico
pbx.dynamic-routing.input	Un nuovo parametro è stato inserito dal chiamante nell'instradamento dinamico
pbx.wake-up.unanswered	Il servizio sveglia non ha avuto risposta dalla camera
pbx.user.create	È stato creato un nuovo utente di Kalliope
pbx.user.password-change	È stata cambiata la password di un utente di Kalliope
storage.quota.exceeded	È stata superata la quota di archiviazione riservata ad un determinato tenant
storage.quota.restored	L'occupazione di archiviazione di un determinato tenant è tornata sotto la quota riservata
ademco.*.* alarmreceiver.*.*	Eventi specifici utilizzati dal modulo opzionale KalliopeLift per interfacciarsi con i combinatori telefonici degli ascensori

Nella tabella seguente sono illustrati i parametri che è possibile definire per la notifica.

Parametro	Descrizione	Valore
-
Abilitato	Consente di disabilitare la notifica	Si / No
Nome	Identificativo della notifica	Alfa-numerico
Events
Event	Tipo di eventi per cui si vuole ricevere notifica	Da elenco
Severity	Severity dell'evento	Fatal/Critical/Warning/Info/Debug
Notification Action
Notification Action	Associazione ad una NotificationAction	Da elenco

Al momento in cui si verifica l’evento selezionato riceveremo una notifica con le informazioni richieste.

Esempio pratico

Per maggiore chiarezza facciamo un esempio. Per l’evento “Coda non Servita” , se effettuiamo una chiamata da 103 a 201 a cui è associata la coda QueueTest e dopo 5 secondi il chiamante abbandona il servizio, possiamo richiedere nella mail informazioni circa

• l’id dell’evento
• il nome dell’evento
• nome della coda, il tempo di attesa
• il motivo per cui la coda non è stata servita

semplicemente inserendo nel body i placeholder appositi.

Nella Notification List indicheremo come evento “pbx.queue.unservedcall” associando la Notification Action precedentemente creata.

Riceveremo quindi una mail con le seguenti informazioni:

Unserved

1511212918.0

1

Default

103

201

5

CANCELLED

Oppure possiamo ottenere la seguente risposta inserendo il placeholder:

%call_params[<JASON>]% :

{"reason":"CANCELED","queue_id":"1","uniqueid":"1511212918.0","called_num":"201","caller_num":"103","queue_name":"QueueTest","waiting_time":"5"}

%call_params[<XML>]%

> <?xml version="1.0"?>

> <response><reason>CANCELED</reason><queue_id>1</queue_id><uniqueid>1511212918.0</uniqueid><called_num>201</called_num><caller_num>103</caller_num><queue_name>QueueTest</queue_name><waiting_time>5</waiting_time></response>

> %call_params[AVP]%:

> reason=CANCELED&queue_id=1&uniqueid=1511212918.0&called_num=201&caller_num=103&queue_name=QueueTest&waiting_time=5