Configura i servizi di notifica

I servizi di notifica possono essere configurati dall’apposita sezione dell’OCC Notification Service.

Come mostrato in figura, da questa interfaccia è possibile cercare (1) e gestire (2) i servizi configurati oppure crearne di nuovi (3).

Crea un nuovo servizio di notifica

In questa sezione puoi configurare gli eventi di chiamata che verranno notificati su un singolo Web Service.

Avvertimento

Sul server dove risiede il Web Service, le richieste provenienti da TVox devono essere consentite e non bloccate da alcun controllo di accesso o firewall. In genere, le richieste HTTP viaggiano sulla porta 8080/80, mentre le richieste HTTPS sulla porta 443.

Vediamo nel dettaglio quali sono i parametri di configurazione del Web Service in riferimento alla seguente immagine:

1. Nome: descrive brevemente il gruppo di eventi notificati al Web Service corrente

2. Abilitato: abilita/disabilita le notifiche al Web Service corrente

3. Tipo: metodo HTTP con cui verranno eseguite le richieste verso il Web Service, può essere di 2 tipi:

   1. GET, le variabili configurate sugli eventi vengono notificate attraverso parametri in query string
   2. POST, le variabili configurate sugli eventi vengono notificate all’interno del body della richiesta (Context-Type: application/x-www-form-urlencoded)

4. URI: URI del Web Service su cui verranno eseguite le richieste

5. Username (Opzionale): username di autenticazione tramite Basic Authentication

6. Password (Opzionale): password di autenticazione tramite Basic Authentication

7. Timeout connessione: tempo massimo (in secondi) entro cui la richiesta tenterà una connessione verso l’URI configurato

8. Timeout risposta: tempo massimo (in secondi) che la richiesta aspetterà per avere una risposta dall’URI configurato

Ora approfondiamo la configurazione degli eventi:

1. Abilitato: abilita/disabilita le notifiche del singolo evento al Web Service corrente
2. Tipo: tipologia della chiamata da notificare
3. Evento: evento da notificare in base al tipo di chiamata selezionato
4. Filtro (Opzionale): se l’evento riguarda una chiamata di servizio, è possibile filtrare l’evento su un singolo servizio
5. Variabili: mappa chiave/chiave delle informazioni dell’evento da notificare al Web Service

La descrizione dettagliata degli eventi e delle variabili configurabili può essere trovata nella documentazione tecnica.

Documentazione tecnica

Per conoscere la versione di libreria «Notification Service» attualmente disponibile nel vostro sistema TVox, potete andare sull’OCC nella sezione info. Conoscendo la vostra versione potete accedere alla Documentazione tecnica

Log

Nella sezione Log è possibile visionare e scaricare il log mensile delle notifiche prodotte dal Notification Service.
Questo può tornare molto utile sia in fase di sviluppo del Web Service, sia per un’analisi approfondita nel caso in cui vi fosse qualche malfunzionamento.

Nota

Il log viene mantenuto per 12 mesi.