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/chat 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)
   3. SALESFORCE, le richieste verso Salesforce vengono autenticate tramite flusso OAuth 2.0 JWT Bearer, come documentato qui, è necessario completare la configurazione dei parametri di autenticazione Salesforce (sezione OCC «Configurazione generali di sistema > Autenticazione e sicurezza > Terze parti > Salesforce»). Le variabili configurate vengono notificate all’interno del body della richiesta (Context-Type: application/x-www-form-urlencoded), come per il tipo POST.

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

5. Username (Opzionale): username di autenticazione tramite Basic Authentication. Non previsto per il tipo SALESFORCE

6. Password (Opzionale): password di autenticazione tramite Basic Authentication. Non previsto per il tipo SALESFORCE

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. Canale: canale (Telefonico, Chat - WEB, Chat - WhatsApp)

3. Tipo: tipologia della chiamata/chat da notificare

4. Evento: evento da notificare in base al tipo di chiamata/chat selezionato

5. Filtro (Opzionale): se l’evento riguarda una chiamata/chat di servizio, è possibile filtrare l’evento su un singolo servizio

6. Variabili:

   1. Variabili, mappa chiave TVox / chiave Web Service delle informazioni dell’evento da notificare al Web Service

   2. Variabili popup, mappa chiave TVox / chiave Web Service delle informazioni di popup dell’evento da notificare al Web Service; queste variabili possono essere definite nei flussi IVR/BPM per le seguenti tipologie di chiamata/chat:

      • Chiamata/Chat servizio (sia Servizio Contact Center che Servizio di Risposta)
      • Outbound (nel caso di IVR/BPM convolti da campagne telefoniche di Power Dialer)

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.