Servizi di notifica

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

../../_images/ConfigurazioneOCC_Servizi1.png

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:

../../_images/ConfigurazioneOCC_CreaServizio_WS1.png

  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 > 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:

../../_images/ConfigurazioneOCC_CreaServizio_Eventi1.png

  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:

    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:

      • Chiamata 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

../../_images/info3.png

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.

Esempio: Chiamata in ring

Nome:Chiamata di servizio inbound - Ring
Tipo:GET
URI:http://democrm.teleniasoftware.com/service/ring.php
Eventi:
Tipo Evento Variabili
Chiamata servizio Chiamata in ring dateISO —> dateTime
idlastcall —> callId
pin —> agent
servizio —> service
cli —> callerNumber

Richiesta generata

http://democrm.teleniasoftware.com/service/new?dateTime=2020-11-20T10%3A24%3A08.674Z&callId=1605867847.783%40d92061befe&agent=op1&service=customercare&callerNumber=0987654321

Esempio: Chiamata abbattuta

Nome:Chiamata di servizio inbound - Abbattuta
Tipo:GET
URI:http://democrm.teleniasoftware.com/service/hangup.php
Eventi:
Tipo Evento Variabili
Chiamata servizio Chiamata di servizio, abbattuta
(dopo la risposta)		 dateISO —> dateTime
idlastcall —> callId
cli —> callerNumber
Chiamata servizio Chiamata abbattuta
(prima della risposta)		 dateISO —> dateTime
idlastcall —> callId
cli —> callerNumber

Richiesta generata

http://democrm.teleniasoftware.com/service/hangup?dateTime=2020-11-20T10%3A24%3A46.959Z&callId=1605867847.783%40d92061befe&callerNumber=0987654321

Esempio: Chiamata trasferita

Nome:Chiamata trasferita - Trasferita
Tipo:GET
URI:http://democrm.teleniasoftware.com/transfer/transfer.php
Eventi:
Tipo Evento Variabili
Trasferita Chiamata trasferita dateISO —> dateTime
id —> callId
clid —> callerNumber
userdnis —> transferToAgent

Richiesta generata

http://democrm.teleniasoftware.com/transfer/transfer?dateTime=2020-11-20T10%3A45%3A57.249Z&callId=1605869145.791%40d92061befe&callerNumber=0987654321&transfer=op2