Webhooks di notifica degli eventi

Le webhook in uscita sono un modo per notificare un'altra piattaforma quando si verifica uno dei 6 eventi predefiniti nel codice di uContact. Quando si verifica un evento, viene inviata una richiesta POST HTTP a un URL specifico sulla piattaforma di destinazione. Questa richiesta contiene informazioni sull'evento in questione a seconda del tipo.

Eventi.

Tutti gli eventi inviano le loro informazioni in un oggetto JSON che contiene informazioni specifiche per ogni evento. Questi oggetti JSON contengono sempre la data e l'ora in cui si è verificato l'evento nel parametro 'date' e l'evento che si è verificato nel parametro 'event' per impostazione predefinita in tutti i casi.

Di seguito, verranno dettagliati ciascuno degli eventi in questione insieme a un esempio dell'oggetto JSON inviato in ciascun caso.

Evento	Descrizione	Dati da inviare	Esempio JSON

Evento	Descrizione	Dati da inviare	Esempio JSON
AgentRingNoAnswer	Questo evento viene attivato quando un agente non risponde a una chiamata entro il tempo massimo di suoneria configurato per la campagna.	agent: Nome utente agentNumber: Estensione dell'agente agentFullName: Nome completo dell'agente callerIdNum: Numero di chiamata campaign: Campagna attraverso la quale la chiamata entra	{"event":"AgentRingNoAnswer","date":"2023-48-13 06:48:51","agent":"agentTest","agentNumber":"9999","agentFullName":"Agente Test","callerIdNum":"1234","campaign":"Demo<-"}
AgentLog	Questo evento viene attivato quando un agente effettua il login o il logout da uContact.	agent: Nome utente. isLogin: I dati restituiranno solo 'vero' o 'falso' a seconda che si tratti di un accesso o di un'uscita, rispettivamente.	{"event":"AgentLog","date":"2023-16-13 05:16:22","agent":"agentTest","isLogin":true} {"event":"AgentLog","date":"2023-16-13 15:18:43","agent":"agentTest","isLogin":false}
AgentBreak	Questo evento viene attivato quando un agente imposta o rimuove il proprio stato di pausa.	agent: Nome utente motive: Motivo della pausa isBreak: Dati che restituiscono solo 'vero' o 'falso' a seconda che si tratti di un evento di pausa o di ripresa.	{"event":"AgentBreak","date":"2023-52-13 04:52:57","agent":"AgentTest","motive":"Lunch","isBreak":true} {"event":"AgentBreak","date":"2023-52-13 05:52:00","agent":"ccass_sderi","motive":"Lunch","isBreak":false}
FinishInteraction	Questo evento verrà attivato quando viene conclusa qualsiasi interazione su un canale uContact. Ciò include telefonia, webchat, SMS o email.	guid: GUID dell'interazione. campaign: Campagna in corso di servizio. agent: Agente che ha gestito l'interazione. duration: Tempo attivo dell'interazione. clientId: Identificatore dell'utente che viene servito (dipende dal canale). channel: Canale attraverso cui è stata gestita l'interazione.
InteractionDisposition	Questo evento verrà attivato quando un agente di uContact registra una categorizzazione per un'interazione telefonica	guid: GUID dell'interazione campaign: Campagna in corso di servizio. agent: Agente che ha gestito l'interazione. value1: Categoria di livello 1. value2: Categoria di livello 2. value3: Categoria di livello 3. channel: "Canale di interazione.

Come registrare il webhook per inviare la notifica dell'evento.

Attualmente, uContact non ha un'interfaccia utente per registrare i webhook, quindi è necessario aggiungerli manualmente in una tabella nel database.

La tabella in questione è la tabella denominata 'webhooks' situata nel database ccdata. Ha la seguente struttura: Id, nome, descrizione, evento, URL, utente. Questa tabella ha già aggiunto gli eventi di notifica in questione e, se nulla è stato configurato in precedenza, il campo 'URL' dovrebbe essere vuoto, come mostrato nell'immagine di seguito.

Per registrare il webhook, è sufficiente inserire il link nel campo 'url' vuoto. Dopo aver inserito il link, i dati inizieranno ad essere inviati all'URL fornito. L'URL non può superare i 256 caratteri.