Connettore Webhook

INDICE

• Connettore Webhook
• Dati di Esempio
  • Esempio chiamata in ingresso
  • Esempio chiamata in uscita
• Legenda dati
• Privacy dei dati

Connettore Webhook

Setera OneCloud dispone di un Connettore Webhook per ciascuna organizzazione.

Tale connettore permette di inviare i dati relativi alle chiamate degli utenti in tempo reale da Setera verso un sistema terzo come CRM o ERP.

NOTE:
- Il connettore Webhook non invia alcun dato relativo ai numeri di funzione come IVR, ACD, Hunt Group ecc...
- Il connettore Webhook ha effetto solo sulle chiamate effettuate/ricevute dagli utenti.

Dati inclusi:

• Numero chiamante
• Date e ora della chiamata in uscita seguita da fuso orario UTC
• Stato corrente della chiamata
• Indirizzo Email del chiamante
• User ID del chiamante
• Dispositivo utilizzato dal quale è stata effettuata/ricevuta la chiamata
• Numero chiamato
• Indirizzo Email del chiamato
• User ID del chiamato

Il Webhook invierà questi dati come richiesta HTTPS POST con payload in formato JSON verso un URL che dovrai fornire al tuo referente tecnico Setera, insieme agli utenti indicati per il monitoraggio.

Per ogni chiamata vengono inviate più notifiche in momenti distinti, ciascuna contenente un singolo oggetto JSON che rappresenta uno specifico stato della chiamata.

Dati di Esempio

Esempio chiamata in ingresso

In questo esempio, l'utente OneCloud (setera.test@seteratesting.fi, +35894272XXXX) riceve una chiamata sulla sua applicazione Softphone dal numero +35840940XXXX.

Il sistema invierà quindi al tuo endpoint richieste HTTPS POST separate, ciascuna con un payload JSON relativo allo stato attuale della chiamata.

Di seguito un esempio di sequenza tipica per una chiamata in ingresso:

• Sequenza 1: Chiamata in arrivo (EARLY)

{
    "seq_num": 1,
    "call_id": "tvNAazZlEwDZTCO74Pk95Q",
    "branch_id": "L1FIItkNwW0.",
    "timestamp": "2021-09-30T10:36:19.315+00:00",
    "state": "EARLY",
    "direction": "INCOMING",
    "local_user_id": "setera.test@seteratesting.fi",
    "local_number": "+35894272XXXX",
    "device_type": "SOFT",
    "remote_number": "+35840940XXXX"
}

{
    "seq_num": 2,
    "call_id": "tvNAazZlEwDZTCO74Pk95Q",
    "branch_id": "L1FIItkNwW0.",
    "timestamp": "2021-09-30T10:36:21.970+00:00",
    "state": "CONFIRMED",
    "direction": "INCOMING",
    "local_user_id": "setera.test@seteratesting.fi",
    "local_number": "+35894272XXXX",
    "device_type": "SOFT",
    "remote_number": "+35840940XXXX"
 }

 {
    "seq_num": 3,
    "call_id": "tvNAazZlEwDZTCO74Pk95Q",
    "branch_id": "L1FIItkNwW0.",
    "timestamp": "2021-09-30T10:36:26.018+00:00",
    "state": "TERMINATED",
    "termination-reason": "HANGUP",
    "direction": "INCOMING",
    "local_user_id": "setera.test@seteratesting.fi",
    "local_number": "+35894272XXXX",
    "device_type": "SOFT",
    "remote_number": "+35840940XXXX"
}

Esempio chiamata in uscita

In questo esempio, l'utente OneCloud (setera.test@seteratesting.fi, +35894272XXXX) effettua una chiamata in uscita dalla sua applicazione Softphone verso il numero +35840940XXXX.

Come per la chiamata in ingresso, l'Endpoint riceve li dati per ciascun avvenimento:

• Sequenza 1: Chiamata in uscita (EARLY)

{
    "seq_num": 1,
    "call_id": "lbDc8Xh8eqzweI1BOr8apg",
    "branch_id": "VrcWMeJVUDc.",
    "timestamp": "2021-09-30T12:04:23.242+00:00",
    "state": "EARLY",
    "direction": "OUTGOING",
    "local_user_id": "setera.test@seteratesting.fi",
    "local_number": "+35894272XXXX",
    "device_type": "SOFT",
    "remote_number": "+35840940XXXX"
}

• Sequenza 2: Il chiamato risponde (CONFIRMED)

{
    "seq_num": 2,
    "call_id": "lbDc8Xh8eqzweI1BOr8apg",
    "branch_id": "VrcWMeJVUDc.",
    "timestamp": "2021-09-30T12:04:25.739+00:00",
    "state": "CONFIRMED",
    "direction": "OUTGOING",
    "local_user_id": "setera.test@seteratesting.fi",
    "local_number": "+35894272XXXX",
    "device_type": "SOFT",
    "remote_number": "+35840940XXXX"
}

{
    "seq_num": 3,
    "call_id": "lbDc8Xh8eqzweI1BOr8apg",
    "branch_id": "VrcWMeJVUDc.",
    "timestamp": "2021-09-30T12:04:28.448+00:00",
    "state": "TERMINATED",
    "termination-reason": "HANGUP",
    "direction": "OUTGOING",
    "local_user_id": "setera.test@seteratesting.fi",
    "local_number": "+35894272XXXX",
    "device_type": "SOFT",
    "remote_number": "+35840940XXXX"
}

Legenda dati

Privacy dei dati

Tra le impostazioni del connettore Webhook è possibile applicare una restrizione sulla visibilità dei dati che verranno trasmessi all'indirizzo URL precedentemente definito ed è quindi possibile rimuovere o mascherare alcuni dati relativi ad informazioni personali.

A seguire le opzioni possibili:

1. Rimozione dell'User-Id dell'utente.
2. Modifica il Numero dell'utente. Scegli se Rimuovere o Mascherare le ultime X cifre del numero (tra 1 - 15 cifre)
3. Rimozione Email dell'utente.
4. Rimozione dell'User-Id del chiamato/chiamante remoto.
5. Modifica il Numero del chiamato/chiamante remoto. Scegli se Rimuovere o Mascherare le ultime X cifre del numero (tra 1 - 15 cifre)
6. Rimozione Email dell'utente del chiamato/chiamante remoto.
7. Rimozione del tipo dispositivo