Report cronologici dell'operatore automatico e della coda di chiamata

Questo modello di Power BI fornisce tre report che consentono alle organizzazioni di segnalare il numero di chiamate elaborate da operatori automatici e code di chiamata. Fornisce anche informazioni dettagliate sulle prestazioni dell'agente.

V3.1.6 pubblicato il 15 aprile 2024

Il modello Power BI Operatore automatico & coda di chiamata fornisce i tre report seguenti:

Questi report usano i dati del servizio Voice Applications Analytics Collector (VAAC).

Nota

I Original report verranno rimossi dal modello di Power BI a luglio 2024.

Prerequisiti V3.x.x

Power BI Desktop

Devi aver installato Power BI Desktop. Puoi installare e usare la versione gratuita da Microsoft Windows Store.

Importante

Power BI Desktop viene aggiornato e rilasciato mensilmente, includendo il feedback dei clienti e nuove funzionalità. È supportata solo la versione più recente di Power BI Desktop. Ai clienti che contattano il supporto per Power BI Desktop verrà chiesto di eseguire l'aggiornamento alla versione più recente. Puoi ottenere la versione più recente di Power BI Desktop da Windows Store o come singolo eseguibile contenente tutte le lingue supportate scaricate e installate nel computer.

Servizio Power BI

Questi report possono essere pubblicati nel servizio Power BI.

Una volta pubblicato il report:

  1. Passare alle impostazioni del set di dati.
  2. Espandere la sezione Credenziali origine dati .
  3. Selezionare Modifica credenziali.
  4. Impostare il metodo di autenticazione su OAuth2.
  5. Verifica che l'opzione Ignora connessione di prova sia abilitata.
  6. Seleziona Accedi e fornisci le credenziali.

Al termine, è possibile configurare un aggiornamento pianificato del set di dati.

Autorizzazioni di accesso

Usare uno dei metodi seguenti per controllare l'accesso ai report cronologici:

  1. Criteri per le applicazioni vocali

Se si vuole controllare su quali operatori automatici, code di chiamata e agenti l'utente può segnalare e non vuole fornire alcun accesso all'interfaccia di amministrazione di Teams, creare un criterio per le applicazioni vocali per l'utente che concede l'accesso ai report cronologici e assegnarlo come utente autorizzato agli operatori automatici e alle code di chiamata appropriati.

Per ulteriori informazioni, vedi Pianificare l'operatore automatico e Gli utenti autorizzati alla coda di chiamata.

Mancia

L'approccio consigliato prevede l'uso dei criteri delle applicazioni vocali per controllare l'accesso. Con i criteri delle applicazioni vocali e gli utenti autorizzati è possibile controllare quali operatori automatici, code di chiamata e agenti su cui un utente può segnalare. Se necessario, il criterio consente comunque a un utente di segnalare tutti gli operatori automatici, le code di chiamata e gli agenti senza la necessità di concedere all'utente l'accesso all'interfaccia di amministrazione di Teams.

Per accedere a questa funzionalità, è necessario modificare un criterio delle applicazioni vocali esistente per abilitare le autorizzazioni cronologiche per la creazione dei report oppure creare un nuovo criterio per le applicazioni vocali con le autorizzazioni di reporting cronologiche abilitate. Le autorizzazioni per i report cronologici possono attualmente essere impostate solo tramite PowerShell e saranno disponibili nell'interfaccia di amministrazione di Teams entro la fine dell'anno.

Per ulteriori informazioni, vedere:

Nuovi criteri per le applicazioni vocali Criteri per le applicazioni vocali esistenti
New-CsTeamsVoiceApplicationsPolicy/-HistoricalAutoAttendantMetricsPermission Set-CsTeamsVoiceApplicationsPolicy/-HistoricalAutoAttendantMetricsPermission
New-CsTeamsVoiceApplicationsPolicy/-HistoricalCallQueueMetricsPermission Set-CsTeamsVoiceApplicationsPolicy/-HistoricalCallQueueMetricsPermission
New-CsTeamsVoiceApplicationsPolicy/--HistoricalAgentMetricsPermission Set-CsTeamsVoiceApplicationsPolicy/-HistoricalCallQueueMetricsPermission
  1. Pipeline di Call Quality Dashboard (legacy)

Se si vuole che l'utente presenti report su tutti gli operatori automatici, le code di chiamata e gli agenti nel tenant e si vuole concedere all'utente l'accesso all'interfaccia di amministrazione di Teams per eseguire altri report sull'utilizzo, assegnare all'utente un ruolo di accesso CQD con entrambi i campi Visualizza report e Visualizza EUII impostati su .

Per altre informazioni, vedere Ruolo di accesso a Call Quality Dashboard.

Nota

Se a un utente viene assegnato un ruolo CQD e un criterio per le applicazioni vocali, il ruolo CQD assumerà la precedenza e l'utente vedrà tutti gli operatori automatici, le code di chiamata e gli agenti nel tenant.

Installazione desktop V3.x.x

I passaggi seguenti presuppongono che il client Power BI Desktop sia installato nel computer e che l'account disponga delle autorizzazioni necessarie per accedere alla pipeline di dati di Call Quality Dashboard.

Eseguire le operazioni seguenti:

  1. Scarica e salva il file V3.1.6.zipTeams Auto Attendant & i rapporti cronologici della coda di chiamata nel computer.

  2. Aprire il file ZIP.

  3. Aprire il file modello Teams Auto Attendant & Call Queue Historical Reports V3.1.6.pbit . Power BI Desktop dovrebbe avviarsi.

  4. Viene chiesto di selezionare DataSource, Livello report e Offset UTC.

    Screenshot che mostra le selezioni DataSource, Livello report e Offset UTC.

    • DataSource: selezionare la api.interfaces.records.teams.microsoft.com voce.
    • Livello report:
      • Selezionare Per Call (impostazione predefinita) per recuperare tutti i singoli record di chiamata.
      • Selezionare Per Day per recuperare un totale aggregato per ogni giorno.
    • Offset UTC: selezionare l'offset UTC che rappresenta il fuso orario in cui sono presentati i report. Valido solo quando il livello di report è impostato su Per Call

    Confronto tra ogni giorno e chiamata

    Per segnalazione chiamata recupera i singoli record di chiamata per ogni operatore automatico, coda di chiamata e agente e li rende disponibili nel client Power BI. Il rapporto per chiamata consente anche di visualizzare i record delle chiamate nel fuso orario locale selezionato dall'utente. Per alcuni clienti, in particolare quelli che usano il ruolo di accesso CQD per controllare l'accesso, questo può determinare il raggiungimento del limite predefinito di 90.000 o 200.000 per ogni record di query. In questo caso, dovrebbe essere selezionata l'opzione Per day reporting.

    I report giornalieri recuperano un record di riepilogo giornaliero per ogni operatore automatico, coda di chiamata e agente. Il risultato è un numero inferiore di record restituiti al client, riducendo la possibilità di raggiungere il limite predefinito di 90.000 o 200.000 per ogni record di query. I report giornalieri sono basati solo su UTC-00:00 (00:00:00-23:59:59 UTC) e qualsiasi offset UTC fornito dall'utente viene ignorato.

  5. Ti viene chiesto di accedere con un account. Selezionare Account aziendale e quindi selezionare Accedi.

    Screenshot che mostra l'accesso per V3.x.x.

  6. Selezionare Connetti per aggiornare i dati.

Latenza dei dati per l'operatore automatico e l'analisi della coda di chiamata

I dati sono in genere disponibili entro 30 minuti dal completamento della chiamata, ma in alcuni casi possono essere richieste diverse ore prima che i dati vengano visualizzati.

È necessario aggiornare il report per visualizzare i nuovi dati.

Report cronologici dell'operatore automatico e della coda di chiamata

Report analisi operatore automatico cloud

Interpretare il report

Screenshot che mostra un report di analisi dell'operatore automatico cloud di esempio.

Callout Titolo Descrizione
1 Data Data di inizio e di fine del report.
Usare questo dispositivo di scorrimento per selezionare l'intervallo di date su cui creare report.

Vedi Problemi noti
2 Intervallo di tempo Ora di inizio e di fine del report. Il report si estende su tutte le date/ore dalla data di inizio/ora di inizio alla data di fine/ora di fine.
Usare questo dispositivo di scorrimento per selezionare l'intervallo di tempo su cui eseguire il report.
3 Account di risorse operatore automatico Account delle risorse da segnalare. Per visualizzare le chiamate per un operatore automatico specifico, seleziona tutti gli account delle risorse assegnati a quell'operatore automatico. Se il nome completo account risorsa è aa_test@microsoft.com, il valore è: aa_test
Impostazione predefinita: Tutto
4 Statistiche rapide -> Chiamate in arrivo La suddivisione mostra il numero totale di chiamate ricevute tra la data di inizio/ora di inizio e la data di fine/ora di fine.

SUGGERIMENTO: passa il puntatore del mouse su qualsiasi metrica in questa sezione per visualizzare una descrizione comando con le singole chiamate che costituiscono il totale.
5a Statistiche rapide -> Statistiche di utilizzo La suddivisione mostra la durata media della chiamata nell'operatore automatico e il numero medio di azioni del chiamante.
5b Numero azioni chiamante Suddivisione del numero di azioni del chiamante (pressione dei tasti, comandi vocali)
6 Statistiche rapide -> Directory Search Metodo La suddivisione mostra come è stata usata l'opzione Directory Search dai chiamanti.
Questa sezione del report è vuota se l'operatore automatico non è configurato per questo servizio o se i chiamanti non lo usano.

Definizioni legenda metodo directory Search:
  • DTMF - Il chiamante ha utilizzato la tastiera del telefono per cercare il nome dell'utente
  • Voce - Il chiamante ha usato l'input vocale per cercare il nome dell'utente
7 Risultati chiamata La suddivisione mostra il trattamento della chiamata ricevuto dai chiamanti.

Definizioni della legenda dei risultati delle chiamate:
  • Terminato (nessuna azione chiamante) - Chiamata disconnessa - Il chiamante non ha effettuato alcuna selezione
  • Terminato (con azione chiamante) - Chiamata disconnessa - il chiamante ha effettuato selezioni
  • Terminato (disconnesso) - La chiamata è stata disconnessa in base alla configurazione dell'operatore automatico
  • Terminato (nessun operatore) - La chiamata è stata disconnessa perché non c'era alcun operatore per trasferire la chiamata a
  • Terminato (trasferimento non riuscito): la chiamata è stata disconnessa perché il trasferimento configurato non è riuscito
  • Trasferito (AA) - La chiamata è stata trasferita a un altro operatore automatico
  • Trasferito (CQ) - La chiamata è stata trasferita a una coda di chiamata
  • Trasferito (operatore) - La chiamata è stata trasferita all'operatore
  • Trasferito (segreteria telefonica) - La chiamata è stata trasferita alla segreteria telefonica condivisa
  • Trasferito (esterno) - La chiamata è stata trasferita a un numero esterno
  • Trasferito (utente) - La chiamata è stata trasferita a una persona nell'organizzazione
  • Altro - Si sono verificate altre condizioni

SUGGERIMENTO: passa il puntatore del mouse su qualsiasi metrica in questa sezione per visualizzare una descrizione comando con le singole chiamate che costituiscono il totale.
8 La suddivisione mostra i percorsi del chiamante attraverso l'operatore automatico e il risultato finale della chiamata.

Definizioni di colonna:
  • MM-DD - Il mese e il giorno della chiamata
  • Ora di inizio : l'ora di inizio della chiamata
  • Nome - Nome account risorsa
  • Flusso delle chiamate: flusso della chiamata seguito dalla chiamata. Vedere Dimensioni operatore automatico -> AutoAttendantCallFlow
  • Tipo di chiamata: metodo di connettività per la chiamata. CalllingPlan o DirectRouting
  • Risultato chiamata : risultato finale della chiamata (vedere #7 Risultati chiamata)
  • Numero di chiamate: numero di chiamate che hanno seguito lo stesso percorso
  • Durata media chiamata (secondi) - Numero medio di secondi trascorsi nella chiamata nell'operatore automatico

SUGGERIMENTO: passa il puntatore del mouse su qualsiasi metrica in questa sezione per visualizzare una descrizione comando con le singole chiamate che costituiscono il totale.

Problemi noti

  1. Vengono riportate solo le chiamate e le azioni del chiamante nel primo operatore automatico che risponde alla chiamata. Le chiamate e le azioni del chiamante negli operatori automatici incatenato (quando un operatore automatico si trasferisce a un altro operatore automatico) non vengono riportate.
  2. Viene visualizzato il nome dell'account della risorsa Operatore automatico invece del nome dell'operatore automatico. Per mostrare tutto il traffico per un operatore automatico, è necessario selezionare tutti gli account delle risorse assegnati all'operatore automatico.
  3. Sono disponibili solo 28 giorni di cronologia delle chiamate. I dati dell'operatore automatico sono considerati dati personali ed sono soggetti ai criteri di conservazione della privacy dei dati.
  4. Il selettore Data talvolta mostra date esterne all'intervallo di dati disponibili, creando un report vuoto. Modificare le date in modo che siano comprese negli ultimi 28 giorni per risolvere il problema.

Report Analisi code di chiamata cloud

Interpretare il report

Screenshot che mostra un report di analisi delle code di chiamata nel cloud di esempio.

Callout Titolo Descrizione
1 Data Data di inizio e di fine del report.
Usare questo dispositivo di scorrimento per selezionare l'intervallo di date su cui creare report.

Vedi Problemi noti
2 Intervallo di tempo Ora di inizio e di fine del report. Il report si estende su tutte le date/ore dalla data di inizio/ora di inizio alla data di fine/ora di fine.
Usare questo dispositivo di scorrimento per selezionare l'intervallo di tempo su cui eseguire il report.
3 Account delle risorse della coda di chiamata Account delle risorse da segnalare. Per visualizzare le chiamate per una coda di chiamata specifica, selezionare tutti gli account delle risorse assegnati a tale coda di chiamata. Se il nome completo account risorsa è cq_test@microsoft.com, il valore è: cq_test
Impostazione predefinita: Tutto
4 Statistiche rapide -> Chiamate in arrivo La suddivisione mostra il numero totale di chiamate ricevute tra la data di inizio/ora di inizio e la data di fine/ora di fine.

SUGGERIMENTO: passa il puntatore del mouse su qualsiasi metrica in questa sezione per visualizzare una descrizione comando con le singole chiamate che costituiscono il totale.
5 Statistiche rapide -> Tempo medio di attesa (secondi) La suddivisione mostra la durata media della chiamata nella coda di chiamata prima che un chiamante risponda o lo abbandoni.
6 Risultati chiamata La suddivisione mostra il trattamento della chiamata ricevuto dai chiamanti.

Definizioni della legenda dei risultati delle chiamate:
  • Abbandonato : il chiamante si è disconnesso prima che un agente rispondesse o prima che si verificasse il timeout della chiamata
  • Risposta dell'agente - Il chiamante ha risposto da un agente
  • Overflow: si è verificata la condizione di gestione dell'eccezione di overflow della chiamata
  • Timeout - Si è verificata la gestione delle eccezioni del timeout di chiamata
  • Nessun agente : si è verificata la condizione di gestione dell'eccezione Nessun agente
  • Altro - Si sono verificate altre condizioni

SUGGERIMENTO: passa il puntatore del mouse su qualsiasi metrica in questa sezione per visualizzare una descrizione comando con le singole chiamate che costituiscono il totale.
7 Volume chiamate, chiamate abbandonate, numero di consenso esplicito dell'agente La suddivisione mostra il numero di chiamate ricevute e abbandonate ogni ora e il numero massimo di agenti che sono stati inseriti nella coda di chiamata in quel momento
8 Durata media sessione (secondi) La suddivisione mostra il tempo di attesa delle chiamate prima del risultato di ogni chiamata.

  • Risposta dell'agente (chiamata) - per le chiamate a cui risponde un agente
  • Risposta dell'agente (callback) - per le richiamate a cui ha risposto un agente
  • Abbandonato : per le chiamate abbandonate prima che un agente rispondesse o prima che si verificasse il timeout della chiamata
  • Overflow (disconnesso) - per le chiamate in cui si è verificata la gestione dell'eccezione di Overflow di chiamata e il trattamento doveva disconnettersi
  • Overflow (Xferred) - per le chiamate in cui si è verificata la gestione dell'eccezione di Overflow chiamata e il trattamento è stato quello di trasferire il chiamante a una persona nell'organizzazione o esternamente
  • Overflow (Segreteria telefonica) - per le chiamate in cui si è verificata la gestione dell'eccezione di Overflow chiamata e il trattamento è stato quello di inviare la chiamata alla segreteria telefonica condivisa
  • Timeout (disconnessione): per le chiamate in cui si è verificata la gestione dell'eccezione di Timeout chiamata e il trattamento doveva disconnettersi
  • Timeout (Xferred): per le chiamate in cui si è verificata la gestione dell'eccezione di timeout di chiamata e il trattamento è stato quello di trasferire il chiamante a una persona dell'organizzazione o esternamente
  • Timed Out (Segreteria telefonica) - per le chiamate in cui si è verificata la gestione dell'eccezione di Timeout chiamata e il trattamento è stato quello di inviare la chiamata alla segreteria telefonica condivisa
  • Nessun agente (disconnessione) - per le chiamate in cui si è verificata la gestione dell'eccezione No Agents e il trattamento è stato quello di disconnettersi
  • Nessun agente (Xferred) - per le chiamate in cui si è verificata la gestione dell'eccezione No Agents e il trattamento è stato quello di trasferire il chiamante a una Persona nell'organizzazione o esternamente
  • Nessun agente (segreteria telefonica) - per le chiamate in cui si è verificata la gestione dell'eccezione No Agents e il trattamento è stato quello di inviare la chiamata alla segreteria telefonica condivisa
  • Altro - per le chiamate in cui si sono verificate altre condizioni
9 Destinazioni di overflow/timeout/nessun agente La suddivisione mostra dove sono state inviate le chiamate che hanno ricevuto il trattamento di gestione delle eccezioni Call Overflow, Call Timeout o No Agents.

  • ApplicationEndpoint : la chiamata è stata trasferita a un altro operatore automatico o coda di chiamata
  • Cassetta postale : la chiamata è stata trasferita alla segreteria telefonica condivisa
  • Altro - si sono verificate altre condizioni
  • Telefono : la chiamata è stata trasferita esternamente
  • Utente : la chiamata è stata trasferita a una Persona nell'organizzazione

Problemi noti

  1. Vengono segnalate solo le chiamate e le azioni del chiamante nella prima coda di chiamata che risponde alla chiamata. Le chiamate in code di chiamata incatenato (quando una coda di chiamata si trasferisce a un'altra coda di chiamata) non vengono segnalate.
  2. Viene visualizzato il nome dell'account della risorsa Code di chiamata invece del nome della coda di chiamata. Per mostrare tutto il traffico per una coda di chiamata, è necessario selezionare tutti gli account delle risorse assegnati alla coda di chiamata.
  3. Sono disponibili solo 28 giorni di cronologia delle chiamate. I dati della coda di chiamata sono considerati dati personali ed sono soggetti a criteri di conservazione della privacy dei dati.
  4. Il selettore Data talvolta mostra date esterne all'intervallo di dati disponibili, creando un report vuoto. Modificare le date in modo che siano comprese negli ultimi 28 giorni per risolvere il problema.

Report sequenza temporale agente coda di chiamata cloud

Interpretare il report

Screenshot che mostra il report sequenza temporale dell'agente di chiamata nel cloud di esempio.

Callout Titolo Descrizione
1 Data Data di inizio e di fine del report.
Usare questo dispositivo di scorrimento per selezionare l'intervallo di date su cui creare report.

Vedi Problemi noti
2 Agent Username Gli agenti su cui riferire. Se il nome utente completo è user@microsoft.com, il valore è: utente
Impostazione predefinita: Tutto
3 Account delle risorse della coda di chiamata Account delle risorse da segnalare. Per visualizzare le chiamate per una coda di chiamata specifica, selezionare tutti gli account delle risorse assegnati a tale coda di chiamata.
Impostazione predefinita: Tutto
4 Statistiche rapide -> Chiamate in arrivo La suddivisione mostra il numero totale di chiamate a cui è stata data risposta, il numero medio di chiamate a cui ha risposto ogni agente e la durata media delle chiamate a cui è stata data risposta gestita.

SUGGERIMENTO: passa il puntatore del mouse su qualsiasi metrica in questa sezione per visualizzare una descrizione comando con le singole chiamate che costituiscono il totale.
5 Risposte alle chiamate (per data) La suddivisione mostra il numero di chiamate con risposta dell'agente per data
6 La suddivisione mostra il numero di chiamate a cui risponde ogni agente in coda e la durata media della chiamata per tali chiamate.
7 Risposta alle chiamate (per ora) La suddivisione mostra il numero di chiamate con risposta dell'agente per ora
8 La suddivisione mostra il numero di chiamate a cui risponde l'agente, per coda di chiamata.

Definizioni di colonna:
  • MM-DD - Il mese e il giorno della chiamata
  • Ora - L'ora in cui è stata data risposta alla chiamata
  • Call Quality Dashboard - Nome account risorsa
  • Nome agente : nome URI dell'agente che ha risposto alla chiamata
  • Risposte alle chiamate - Il numero di chiamate a cui l'agente ha risposto da questa coda di chiamata
  • Durata media chiamata (secondi) - Durata media della chiamata di ogni chiamata in secondi
  • Durata totale chiamata (minuti) - Durata totale delle chiamate per tutte le chiamate
  • Durata totale chiamata (HH:MM:SS) - Durata totale della chiamata per tutte le chiamate

Problemi noti

  1. Sono disponibili solo 28 giorni di cronologia delle chiamate. I dati della coda di chiamata e dell'agente sono considerati dati personali ed sono soggetti ai criteri di conservazione della privacy dei dati.
  2. Viene visualizzato il nome dell'account della risorsa Code di chiamata invece del nome della coda di chiamata. Per mostrare tutto il traffico per una coda di chiamata, è necessario selezionare tutti gli account delle risorse assegnati alla coda di chiamata.
  3. Viene visualizzato il nome UPN dell'agente invece del nome.
  4. Il selettore Data talvolta mostra date esterne all'intervallo di dati disponibili, creando un report vuoto. Modificare le date in modo che siano comprese negli ultimi 28 giorni per risolvere il problema.
  5. In alcuni scenari, il numero di chiamate a cui l'agente ha risposto potrebbe essere diverso rispetto al numero di chiamate mostrato nella cronologia delle chiamate del client di Teams. La cronologia delle chiamate del client di Teams è corretta. Il supporto è in fase di analisi, ma al momento non è disponibile alcun tempo stimato per la riparazione.
  6. Quando un agente risponde a una chiamata in una coda di chiamata diversa a causa del reindirizzamento tramite la gestione dell'eccezione di overflow chiamata, viene visualizzata nella coda di chiamata originale in cui si è verificata l'eccezione invece di quella in cui ha risposto alla chiamata.

Definizioni di campo dei rapporti cronologici dell'operatore automatico e della coda di chiamata

fAutoAttendant table field description

Nome Tipo di dati Descrizione
Nome AA Testo Nome dell'account della risorsa associato all'operatore automatico

Se il nome completo account risorsa è aa_test@microsoft.com, il valore è: aa_test
Ora di inizio AA Numero intero Ora di inizio chiamata operatore automatico - Locale (in base all'offset UTC selezionato)
AA Start Time Local Data/ora Ora di inizio chiamata operatore automatico - Locale (in base all'offset UTC selezionato)
Ora inizio AA UTC Data/ora Ora di inizio chiamata Operatore automatico - UTC
AACallerActionCount Numero intero Riepiloga: Somma
Numero di azioni selezionate dal chiamante in Operatore automatico durante la chiamata
AACallerActionCountAverage (misura) Numero intero Media di AACallerActionCount: zero anziché vuoto
AACallFlow Testo Vedere Dimensioni operatore automatico -> AutoAttendantCallFlow
AACallResult Testo Vedere Dimensioni operatore automatico -> AutoAttendantCallResult
AACallResultLegend Testo Elementi della legenda per su AACallResult. I valori possibili sono:
  • Terminato (nessuna azione chiamante) - Chiamata disconnessa - Il chiamante non ha effettuato alcuna selezione
  • Terminato (con azione chiamante) - Chiamata disconnessa - il chiamante ha effettuato selezioni
  • Terminato (disconnesso) - La chiamata è stata disconnessa in base alla configurazione dell'operatore automatico
  • Terminato (nessun operatore) - La chiamata è stata disconnessa perché non c'era alcun operatore per trasferire la chiamata a
  • Terminato (trasferimento non riuscito): la chiamata è stata disconnessa perché il trasferimento configurato non è riuscito
  • Trasferito (AA) - La chiamata è stata trasferita a un altro operatore automatico
  • Trasferito (CQ) - La chiamata è stata trasferita a una coda di chiamata
  • Trasferito (operatore) - La chiamata è stata trasferita all'operatore
  • Trasferito (segreteria telefonica) - La chiamata è stata trasferita alla segreteria telefonica condivisa
  • Trasferito (esterno) - La chiamata è stata trasferita a un numero esterno
  • Trasferito (utente) - La chiamata è stata trasferita a una persona nell'organizzazione
  • Altro - Si sono verificate altre condizioni
AAChainDuration Numero decimale Riepiloga: Somma
Durata della chiamata in Operatore automatico
AAChainDurationAverage (misura) Numero decimale Media di AAChainDuration - zero anziché vuota
AAChainIndex Numero intero
AAConnectivityType Testo Vedere Dimensioni comuni -> PSTNConnectivityType
AACount Numero intero Riepilogato: Somma
Numero di operatori automatici coinvolti nella chiamata
AADirectorySearchMethod Testo Vedere Dimensioni operatore automatico -> AutoAttendantDirectorySearchMethod
AADirectorySearchMethodCountDTMF (Misura) Numero intero Numero di chiamate che usavano DTMF per la ricerca nella directory- zero anziché vuoto
AADirectorySearchMethodCountVoice (Misura) Numero intero Numero di chiamate che usavano Voice per la ricerca nella directory - zero invece di vuoto
AADirectorySearchMethodLegend Testo Elementi della legenda per AADirectorySearchMethod. I valori possibili sono:
  • DTMF - Il chiamante ha utilizzato la tastiera del telefono per cercare il nome dell'utente
  • Voce - Il chiamante ha usato l'input vocale per cercare il nome dell'utente
AATransferAction Testo Vedere Dimensioni operatore automatico -> AutoAttendantTransferAction
Durata chiamata Secondi Numero intero Durata chiamata
Ora di fine chiamata locale Data/ora Ora di fine chiamata - Locale (in base all'offset UTC selezionato)
Ora di fine chiamata UTC Data/ora Ora di fine chiamata - UTC
Ora di inizio chiamata locale Data/ora Ora di inizio chiamata - Locale (in base all'offset UTC selezionato)
Ora inizio chiamata UTC Data/ora Ora di inizio chiamata - UTC
ID conferenza Testo Usato per la risoluzione dei problemi: fornire queste informazioni all'apertura di un biglietto
ID finestra di dialogo Testo Usato per la risoluzione dei problemi: fornire queste informazioni all'apertura di un biglietto
ID documento Testo Usato per la risoluzione dei problemi: fornire queste informazioni all'apertura di un biglietto
MM-DD Testo Chiamata operatore automatico mese-giorno
PSTNMinutes Numero intero Riepiloga: Somma
Utilizzo totale dei minuti
TotalCallCount Numero intero Riepiloga: Somma
Sempre 1 - usato per fornire la somma di tutte le chiamate
TotalCallCountSum (Misura) Numero intero Somma di TotalCallCount

Report Analisi code di chiamata cloud

Descrizione del campo della tabella fCallQueueAnalytics

Nome Tipo di dati Descrizione
Numero chiamate Numero intero Riepiloga: Somma
Numero di chiamate
Numero chiamate abbandonato Numero intero Riepiloga: Somma
Numero di chiamate abbandonate
Somma conteggio chiamate (misura) Numero intero Somma conteggio chiamate- zero anziché vuota
Somma conteggio chiamate abbandonata (misura) Numero intero Numero di chiamate abbandonato: zero anziché vuoto
Durata chiamata Secondi Numero intero Riepiloga: Somma
Durata chiamata
Ora di fine chiamata locale Data/ora Ora di fine chiamata - Locale (in base all'offset UTC selezionato)
Ora di fine chiamata UTC Data/ora Ora di fine chiamata - UTC
Numero agente coda di chiamata Numero intero Riepiloga: Somma
Numero di agenti configurati nella coda di chiamata
Numero di richieste di consenso esplicito per l'agente della coda di chiamata Numero intero Riepiloga: Somma
Numero di agenti che hanno fornito il consenso alla coda di chiamata
Risultato chiamata in coda di chiamata Testo Vedere Dimensioni della coda di chiamata -> CallQueueCallResult
Legenda dei risultati delle chiamate in coda di chiamata Testo Elementi della legenda per Risultato coda di chiamata. Valori possibili:
  • Abbandonato : il chiamante riagganciato prima che un agente potesse rispondere o prima del timeout
  • Risposta dell'agente : il chiamante ha risposto da un agente
  • Overflow: si è verificata l'eccezione di overflow della chiamata
  • Timeout : si è verificata l'eccezione di timeout di chiamata
  • Nessun agente : si è verificata l'eccezione nessun agente
  • Altro - si sono verificate altre condizioni
Tipo di destinazione coda di chiamata Testo Vedere Dimensioni della coda di chiamata -> CallQueueTargetType
Legenda del tipo di destinazione coda di chiamata Testo Elementi della legenda per tipo di destinazione coda di chiamata. Valori possibili:
  • Abbandonato : il chiamante riagganciato prima che un agente potesse rispondere o prima del timeout
  • Risposta dell'agente (chiamata): al chiamante è stata data risposta da un agente
  • Risposta dell'agente (callback): la richiamata è stata risolta da un agente
  • Overflow (applicazione) - eccezione di overflow chiamata - chiamata instradata a un'altra applicazione
  • Overflow (disconnesso) - eccezione di overflow chiamata - chiamata disconnessa
  • Overflow (esterno) - si è verificata l'eccezione di overflow della chiamata - chiamata trasferita esternamente
  • Overflow (utente) - eccezione di overflow chiamata - chiamata trasferita a una persona nell'organizzazione
  • Overflow (segreteria telefonica) - Eccezione di overflow chiamata - Chiamata trasferita alla segreteria telefonica condivisa
  • Timeout (applicazione) - eccezione di timeout di chiamata - chiamata instradata a un'altra applicazione
  • Timeout (disconnessione) - si è verificata l'eccezione di timeout di chiamata - chiamata disconnessa
  • Timeout (esterno) - si è verificata l'eccezione di timeout di chiamata - la chiamata è stata trasferita esternamente
  • Timeout (utente) - si è verificata l'eccezione di timeout di chiamata - la chiamata è stata trasferita a una persona nell'organizzazione
  • Timed Out (Segreteria telefonica) - eccezione di timeout chiamata - chiamata è stata trasferita alla segreteria telefonica condivisa
  • Nessun agente (applicazione) - si è verificata l'eccezione di nessun agente - chiamata è stata instradata a un'altra applicazione
  • Nessun agente (disconnetti) - si è verificata l'eccezione nessun agente - chiamata disconnessa
  • Nessun agente (esterno) - si è verificata l'eccezione di nessun agente - chiamata è stata trasferita esternamente
  • Nessun agente (utente) - assenza di eccezioni di agenti - la chiamata è stata trasferita a una Persona nell'organizzazione
  • Nessun agente (segreteria telefonica) - si è verificata l'eccezione nessun agente - la chiamata è stata trasferita alla segreteria telefonica condivisa
Ora di inizio chiamata locale Data/ora Ora di inizio chiamata - Locale (in base all'offset UTC selezionato)
Ora inizio chiamata UTC Data/ora Ora di inizio chiamata - UTC
ID conferenza Testo Usato per la risoluzione dei problemi: fornire queste informazioni all'apertura di un biglietto
Call Quality Dashboard Testo Nome dell'account della risorsa collegato alla coda di chiamata

Se il nome completo account risorsa è cq_test@microsoft.com, il valore è: cq_test
CQHour Numero intero Ora di inizio chiamata in coda di chiamata
Data Data/ora Data e ora di inizio chiamata in coda di chiamata (ora)
DateTimeCQName Testo Chiave univoca per filtrare in fCallQueueFinalStateAction
ID finestra di dialogo Testo Usato per la risoluzione dei problemi: fornire queste informazioni all'apertura di un biglietto
ID documento Testo Usato per la risoluzione dei problemi: fornire queste informazioni all'apertura di un biglietto
Tipo di connettività PSTN Testo Vedere Dimensioni comuni -> PSTNConnectivityType
Totale minuti PSTN Numero intero Riepiloga: Somma
Numero totale di minuti di utilizzo per le chiamate PSTN

Descrizione del campo della tabella fCallQueueFinalStateAction

Nome Tipo di dati Descrizione
Durata media chiamata (secondi) Numero decimale Riepiloga: Somma
Durata media delle chiamate in secondi per le chiamate abbandonate
Media durata media chiamata (secondi) (misura) Numero intero Media della durata media delle chiamate (secondi) - zero anziché vuota
Durata media coda di chiamata (sec) Numero decimale Riepiloga: Somma
Tempo medio di attesa in secondi per le chiamate a cui si è risposto
Durata media coda di chiamata (sec) (misura) Numero intero Media della durata media della coda di chiamata (sec) - zero anziché vuota
Numero chiamate Numero intero Riepiloga: Somma
Numero di chiamate
Risultato chiamata in coda di chiamata Testo Vedere Dimensioni della coda di chiamata -> CallQueueCallResult
Legenda dei risultati delle chiamate in coda di chiamata Testo Elementi della legenda per Risultato chiamata in coda di chiamata. Valori possibili:
  • Abbandonato : il chiamante riagganciato prima che un agente potesse rispondere o prima del timeout
  • Risposta dell'agente (chiamata): al chiamante è stata data risposta da un agente
  • Risposta dell'agente (callback): la richiamata è stata risolta da un agente
  • Overflow (disconnesso) - eccezione di overflow chiamata - chiamata disconnessa
  • Overflowed (Xferred) - eccezione di overflow chiamata - chiamata trasferita esternamente
  • Overflow (segreteria telefonica) - Eccezione di overflow chiamata - Chiamata trasferita alla segreteria telefonica condivisa
  • Timed Out (Callback) - timeout del callback - callback non si è verificato
  • Timeout (disconnessione) - si è verificata l'eccezione di timeout di chiamata - chiamata disconnessa
  • Timed Out (Xferred) - eccezione di timeout chiamata - chiamata trasferita esternamente
  • Timed Out (Segreteria telefonica) - eccezione di timeout chiamata - chiamata è stata trasferita alla segreteria telefonica condivisa
  • Nessun agente (disconnetti) - si è verificata l'eccezione nessun agente - chiamata disconnessa
  • Nessun agente (Xferred) - si è verificata l'eccezione nessun agente - chiamata è stata trasferita esternamente
  • Nessun agente (segreteria telefonica) - si è verificata l'eccezione nessun agente - la chiamata è stata trasferita alla segreteria telefonica condivisa
Azione di stato finale sulla coda di chiamata Testo Vedere Dimensioni della coda di chiamata -> CallQueueFinalStateAction
Call Quality Dashboard Testo Nome dell'account della risorsa collegato alla coda di chiamata

Se il nome completo account risorsa è cq_test@microsoft.com, il valore è: cq_test
CQHour Numero Ora in cui è stata effettuata la chiamata
Data Data/ora Data e ora di inizio chiamata in coda di chiamata (ora)
DateTimeCQName Testo Chiave univoca per filtrare in fCallQueueFinalStateAction
IsAbandoned Vero/falso True se il chiamante termina la chiamata prima che l'agente risponda
Data locale Data/ora Data/ora locale (in base all'offset UTC selezionato)
Data UTC Data/ora Data/ora UTC

Report sequenza temporale agente coda di chiamata cloud

Descrizione del campo della tabella fAgentTimelineAnalytics

Nome Tipo di dati Descrizione
Nome agente Testo UPN utente
Se il nome utente completo è user@microsoft.com, il valore è: utente
AgentTimelineAnalyticsSummaryLink Testo Usato per il collegamento con fAgentTimelineAnalyticsSummary per la descrizione comando popup
Durata chiamata (HH:MM:SS) Testo Durata chiamata (minuti) convertita in HH:MM:SS
Durata chiamata (minuti) Numero intero Riepiloga: Somma
Durata totale chiamata delle chiamate in coda di chiamata in minuti
Durata chiamata (secondo) Numero intero Riepiloga: Somma
Durata totale delle chiamate in coda di chiamata in secondi
Ora di fine chiamata locale Data/ora Ora di fine chiamata - Locale (in base all'offset UTC selezionato)
Ora di fine chiamata UTC Data/ora Ora di fine chiamata - UTC
Ora di inizio chiamata locale Data/ora Ora di inizio chiamata - Locale (in base all'offset UTC selezionato)
Ora inizio chiamata UTC Data/ora Ora di inizio chiamata - UTC
ID conferenza Testo Usato per la risoluzione dei problemi: fornire queste informazioni all'apertura di un biglietto
Call Quality Dashboard Testo Nome dell'account della risorsa collegato alla coda di chiamata

Se il nome completo account risorsa è cq_test@microsoft.com, il valore è: cq_test
Datetime Datetime Data della chiamata
ID finestra di dialogo Testo Usato per la risoluzione dei problemi: fornire queste informazioni all'apertura di un biglietto
ID documento Testo Usato per la risoluzione dei problemi: fornire queste informazioni all'apertura di un biglietto
Ora (misura) Numero intero Ora di chiamata
Total Call Count Numero intero Riepiloga: Somma
Numero di chiamate presentate all'agente

Descrizione del campo della tabella fAgentTimelineAnalyticsSummary

Nome Tipo di dati Descrizione
Nome agente Testo UPN utente
Se il nome utente completo è user@microsoft.com, il valore è: utente
AgentTimelineAnalyticsLink Testo Usato per il collegamento con fAgentTimelineAnalytics per la descrizione comando popup
Durata media chiamata (secondi) Numero decimale Riepiloga: Somma
Durata media delle chiamate in coda di chiamata in secondi
Durata media chiamata (secondi) - zero anziché vuota (misura) Numero intero Durata media chiamata (secondi) - zero anziché vuota
Call Quality Dashboard Testo Nome dell'account della risorsa collegato alla coda di chiamata

Se il nome completo account risorsa è cq_test@microsoft.com, il valore è: cq_test
Data Data Data della chiamata
Hour Numero intero Ora di chiamata
MM-DD Testo Mese e giorno di chiamata
Total Call Count Numero intero Riepiloga: Somma
Numero di chiamate presentate all'agente
Total Call Count divided by Count of Agent Name (Measure Numero intero Numero medio di chiamate per agente
Total Call Count Sum (Misura) Numero intero Somma del totale del numero di chiamate: zero anziché vuoto
Durata totale chiamata (HH:MM:SS) Testo Durata chiamata (minuti) convertita in HH:MM:SS
Durata totale chiamata (minuti) Numero intero Riepiloga: Somma
Durata totale chiamata delle chiamate in coda di chiamata in minuti

Limiti dei dati

Ogni scheda del report recupera i dati per tutti gli operatori automatici, le code di chiamata o gli agenti nel tenant per l'intervallo di date selezionato. Questo recupero dei dati si verifica indipendentemente dagli account di risorsa specifici o dall'agente selezionato nel report. I filtri per mostrare solo le informazioni richieste si verificano in locale.

Ogni scheda del report è limitata al recupero di 90.000 righe.

Se ogni giorno viene elaborato un numero elevato di chiamate, è possibile che nel report non vengano visualizzate tutte le chiamate per tutti i giorni compresi nell'intervallo di date selezionato. Non viene visualizzata alcuna notifica quando si verifica questa esclusione. Provare ad abbreviare l'intervallo di date per evitare questo problema.

Se l'abbreviazione dell'intervallo di date non è sufficiente, è possibile aumentare il numero di righe che è possibile recuperare modificando il report nel modo seguente:

  1. Selezionare Trasforma dati nella barra multifunzione per aprire il editor di Power Query.
  2. Selezionare LimitResultRowsCount sul lato sinistro.
  3. Modificare il valore del campo a destra su un numero più grande.
  4. Chiudere la finestra editor di Power Query.
  5. Selezionare quando viene richiesto di applicare subito le modifiche. Il report dovrebbe essere aggiornato automaticamente.
  6. Salvare il report.

Il numero massimo di righe che è possibile restituire è 200.000.

L'impostazione del valore su un numero superiore a 200.000 non ha alcun effetto in quanto questo valore è un limite hardcoded sul server.

L'aumento del limite comporta tempi di esecuzione e risposta più lunghi.

Limiti di tempo di esecuzione del report

L'aumento del numero massimo di righe che è possibile restituire comporta tempi di esecuzione e risposta più lunghi, il che significa che il report potrebbe timeout prima che i dati possano essere restituiti. Il tempo di esecuzione del report può essere aumentato modificando il report nel modo seguente:

  1. Selezionare l'icona Trasforma dati nella barra multifunzione per aprire il editor di Power Query.
  2. Selezionare reportExecutionMinutes sul lato sinistro.
  3. Modificare il valore del campo a destra su un numero più grande.
  4. Chiudere la finestra editor di Power Query.
  5. Selezionare quando viene richiesto di applicare subito le modifiche. Il report dovrebbe essere aggiornato automaticamente.
  6. Salvare il report.

Personalizzazione

È possibile personalizzare alcuni aspetti della visualizzazione dei report, ad esempio l'aggiunta o la rimozione di campi da visualizzare nelle varie visualizzazioni, la modifica del tipo di grafico e altro ancora.

Modificare lo schema dei colori

I passaggi seguenti presuppongono che siano già stati completati i passaggi di installazione.

Eseguire le operazioni seguenti:

  1. Selezionare la scheda Visualizza sulla barra multifunzione.

    Screenshot che seleziona la scheda Visualizza per cambiare la combinazione di colori.

  2. Selezionare lo schema colori nell'elenco a discesa.

    Screenshot che mostra varie combinazioni di colori.

Dimensioni e misure

Sono disponibili le seguenti dimensioni e misure.

Dimensioni comuni

Queste dimensioni sono comuni sia agli operatori automatici che alle code di chiamata:

Nome (tipo) Valori possibili Descrizione
ConferenceId
(Testo)
GUID Identificatore di chiamata
Data
(DateTime)
Data della chiamata (UTC)
DialogId
(Testo)
GUID Identificatore di chiamata
Id documento
(Testo)
GUID Identificatore di chiamata
Durata
(Numero intero)
Durata della chiamata, in secondi
Endtime
(DateTime)
Ora di fine chiamata (UTC)
FirstIsCaller
(booleano)
Classificazione del primo e del secondo endpoint
FirstUPN
(Testo)
Nome dell'entità utente (UPN) dell'utente del primo endpoint
Hour
(Testo)
Ora di inizio chiamata (UTC)
Minute
(Testo)
Minute call started (UTC)
PSTNCallDuration
(Numero intero)
Durata della chiamata
PSTNCallType
(Testo)
Esterno La chiamata proviene dall'esterno del tenant
Interno La chiamata proviene dall'interno del tenant
PSTNConnectivityType
(Testo)
Piano chiamate La chiamata è arrivata su un numero di piano per chiamate
DirectRouting La chiamata è arrivata su un numero di routing diretto
Chiamata ACS La chiamata è arrivata dal Web (click2call)
Second
(Testo)
Seconda chiamata avviata (UTC)
SecondUPN
(Testo)
Nome dell'entità utente (UPN) dell'utente del secondo endpoint
TenantId
(Testo)
ID tenant
Timestamp
(DateTime)
Il record ora è stato scritto (UTC)
UserStartTimeUTC
(DateTime)
Ora di avvio della chiamata (UTC)

Dimensioni operatore automatico

Nome (tipo) Valori possibili Descrizione
AutoAttendantCallFlow
(Testo)
Incapsula i diversi stati della chiamata dell'operatore automatico
abs_search Si è verificata una ricerca per nome
Annuncio È stato riprodotto un annuncio
automatic_menu Routing delle chiamate predefinito
call_termination Chiamata terminata, vedere AutoAttendantCallResult
call_transfer Chiamata trasferita, vedere AutoAttendantCallResult
first_level_menu Stato transizione: può essere ignorato
main_menu Messaggio di saluto riprodotto
speech_input_confirmation Il chiamante ha usato l'input vocale
user_selection Il chiamante usava la voce del tasto tono tocco
AutoAttendantCallResult
(Testo)
Risultato finale della chiamata
failed_to_establish_media Non è stato possibile stabilire la parte multimediale della chiamata
failover_to_operator Chiamata trasferita all'operatore in genere a causa di un errore di sistema
oaa_chain_too_long Troppe gambe nell'AA
oaa_session_too_long La sessione AA è durata troppo a lungo
service_declined AA non ha accettato la chiamata
service_terminated La configurazione AA disconnette la chiamata o la chiamata sospesa
terminated_automatic_selection La configurazione AA disconnette le chiamate
terminated_no_operator Tutto terminato a causa di un errore nessun operatore definito
terminated_transfer_failed Chiamata terminata come trasferimento non riuscito- in genere a numero esterno
transfer_in_progress Trasferimento AA-AA>
transferred_to_operator La chiamata è stata trasferita all'operatore
transferred_to_cq La chiamata è stata trasferita alla coda di chiamata
transferred_to_receptionist Come transferred_to_operator
transferred_to_self La chiamata è stata restituita all'inizio dell'AA
transferred_to_shared_voicemail La chiamata è stata trasferita alla segreteria telefonica condivisa
transferred_to_user La chiamata è stata trasferita a un utente
Sconosciuto Si è verificata una condizione sconosciuta
user_terminated Chiamante riagganciato
AutoAttendantCallerActionCounts
(Numero intero)
Il numero di azioni (tasto toni o voci vocali) eseguito dal chiamante
AutoAttendantChainDurationInSecs
(Numero reale)
Il numero di secondi per cui la chiamata è rimasta in questa parte del flusso della chiamata
AutoAttendantChainIndex
(Numero intero)
AutoAttendantChainStartTime
(DateTime)
Ora di inizio di questa parte del flusso delle chiamate
AutoAttendantCount
(Numero intero)
Numero di operatori automatici tramite cui è stata eseguita la transizione
AutoAttendantDirectorySearchMethod
(Testo)
Metodo di ricerca della directory
abs_search_dtmf Tono tocco
abs_search_voice Opzioni vocali
AutoAttendantId
(Testo)
GUID operatore automatico
AutoAttendantIdentity
(Testo)
URI dell'account della risorsa in cui è arrivata la chiamata
AutoAttendantTransferAction
(Testo)
Tipo di destinazione trasferimento chiamata
AA Trasferito a un AA
CQ Trasferito a un call quality dashboard
external_pstn Trasferito a un numero esterno
segreteria telefonica condivisa Trasferito alla segreteria telefonica condivisa
Sconosciuto Azione sconosciuta
HasAA
(booleano)
L'AA è coinvolta nella chiamata

Dimensioni della coda di chiamata

Nome (tipo) Valori possibili Descrizione
CallQueueAgentCount
(Numero intero)
Numero di agenti in coda di chiamata
CallQueueAgentOptInCount
(Numero intero)
Numero di agenti che hanno acconsentito a partecipare alla coda di chiamata
CallQueueCallResult
(Testo)
Stato finale chiamata in coda di chiamata
agent_joined_conference Risposta alla chiamata - Call Call in modalità conferenza
callback_call_timed_out Il timeout della chiamata di richiamata
Rifiutato
Disconnesso
errore
Fallito
Non valido
traboccante Condizione di overflow soddisfatta
timed_out Condizione di timeout soddisfatta
no_agent Nessuna condizione agente soddisfatta
transferred_to_agent Risposta alla chiamata - Call Call in modalità di trasferimento
transferred_to_callback_caller Risposta alla chiamata di callback da parte dell'agente
CallQueueDurationSeconds
(Numero reale)
Durata della chiamata nella coda di chiamata
CallQueueFinalStateAction
(Testo)
Azione finale coda di chiamata
Scollegare chiamate time_out
disconnect_with_busy chiamate traboccanti
failed_to_accept_call La coda di chiamata non ha potuto accettare la chiamata
Avanti La chiamata è stata inoltrata a una persona dell'organizzazione o esternamente
shared_voicemail La chiamata è stata inviata alla segreteria telefonica condivisa
Altro Si sono verificate altre condizioni
Segreteria telefonica La chiamata è stata inviata alla segreteria telefonica personale
CallQueueId
(Testo)
GUID della coda di chiamata
CallQueueIdentity
(Testo)
URI dell'account della risorsa in cui è arrivata la chiamata
CallQueueTargetType
(Testo)
Destinazione reindirizzamento chiamate
ApplicationEndpoint Altre applicazioni vocali
Cassetta postale Segreteria telefonica condivisa
Altro Si sono verificate altre condizioni
Telefono Trasferimento esterno
Utente Utente nel tenant
HasCQ
(booleano)
Call Quality Dashboard è coinvolto nella chiamata
TransferredFromCQId
(Testo)
La chiamata GUID della coda di chiamata è stata trasferita da
TransferredFromCallQueueIdentity
(Testo)
URI dell'account risorsa da cui è stata trasferita la chiamata

Misure

Nome (tipo) Valori possibili Descrizione
AvgAutoAttendantChainDurationSeconds
(Numero reale)
La durata media della chiamata all'interno di ogni parte del flusso delle chiamate dell'operatore automatico
AvgCallDuration
(Numero reale)
Durata media della chiamata in secondi
AvgCallQueueDurationSeconds
(Numero reale)
Durata media della coda di chiamata in secondi
PSTNTotalMinutes
(Numero reale)
Durata totale delle chiamate in minuti
TotalAudioStreamDuration
(Numero reale)
TotalCallCount
(Numero intero)
Numero totale di chiamate

Creazione di una query valida

Una query valida è costituita da diversi attributi in un oggetto JSON:

{
   "Filters":[
      {
         "DataModelName":"Date",
         "Value":"2022-04-01",
         "Operand":4
      },
      {
         "DataModelName":"Date",
         "Value":"2022-04-30",
         "Operand":6
      }
   ],
   "Dimensions":[
      {
         "DataModelName":"AutoAttendantIdentity"
      },
      {
         "DataModelName":"AutoAttendantDirectorySearchMethod"
      }
   ],
   "Measurements":[
      {
         "DataModelName":"PSTNTotalMinutes"
      },
      {
         "DataModelName":"TotalCallCount"
      }
   ],
   "Parameters":{
      "UserAgent":"Power BI Desktop"
   },
   "LimitResultRowsCount":100000
}

Campi obbligatori

  • Filtri: usati per filtrare i dati restituiti da VAAC

    • DataModelName deve essere una delle dimensioni supportate
    • Il valore deve essere nel formato corretto (datetime, string, number e così via)
    • Operandi:
      • 0 - Uguale a
      • 1 - Diverso da
      • 2 - Contiene
      • 3 - Inizia con
      • 4 - Maggiore di
      • 5 - Maggiore o uguale a
      • 6 - Minore di
      • 7 - Minore o uguale a
      • 8 - Non contiene
      • 9 - Non inizia con
  • Dimensioni:

    • DataModelName deve essere una delle dimensioni supportate
  • Misure:

    • DataModelName deve essere una delle misure supportate
  • Parametri: attualmente è supportato solo UserAgent.

  • LimitResultRowsCount: numero massimo di righe restituite da VAAC

Accesso a VAAC all'esterno di Power BI

Qualsiasi applicazione che può accedere ai servizi Web RESTful può usare l'API VAAC per recuperare i dati cronologici. Nell'esempio seguente viene usato Postman .

Preparazione

  1. Scarica Postman.
  2. Importa la cartella postman nelle istruzioni scaricate sul file ZIP in Postman.

Screenshot che mostra l'importazione completata

Accesso a VAAC tramite Postman

  1. Selezionare VAAC - msit nell'elenco a discesa Nessun ambiente in alto a destra.

  2. Selezionare Ambienti nel menu della barra di sinistra.

  3. Selezionare VAAC - msit in Globali.

  4. Sostituire userName, password e tenantId con le credenziali applicabili.

  5. Seleziona Reimposta tutto nell'angolo in alto a destra.

  6. Selezionare Salva.

    Screenshot che mostra i campi nome utente, password e ID tenant configurati

  7. Seleziona Raccolte nel menu della barra di sinistra.

  8. Selezionare Config API Access Token - Prod e passare alla scheda Corpo .

  9. Selezionare Invia.

    Viene restituito un token di accesso.

    Screenshot che mostra il risultato con il token di accesso restituito.

    Se non viene restituito un token di accesso, verificare le credenziali per assicurarsi che dispongano di autorizzazioni sufficienti.

  10. Selezionare VAAC ConfigAPI Prod e passare alla scheda Params .

  11. Compilare la stringa di query .

  12. Selezionare Invia.

Lettura del risultato

Dopo aver inviato il tuo input, ci sono un paio di possibili risultati:

  • Se l'input non è valido, viene restituito un messaggio di errore con il motivo effettivo

  • Se l'input è valido, il risultato sarà simile al seguente:

    Screenshot che mostra il risultato della query con il campo dataResult

    In questo caso, i dati si trova nel campo "dataResult" nello stesso ordine richiesto negli attributi di dimensione e misura della query.

Comprimere la query JSON

L'API VAAC accetta solo stringhe compresse GZip o codificate in Base64 come input.

Trova qualsiasi sito Web per comprimere il BLOB JSON utilizzando GZIP o Base64.

L'output GZIP dovrebbe essere simile al seguente:

H4sIAAAAAAAACq2SQWsCMRCF7/6KkLNC3EoPe9u6FISuFbW9lB4GM9TQbEaSCSLif+9mV4uCBwXnMkze5L0vkH1PCCFfjWX0QeZfaWxqf+xJLIGhIo12CjXKPM0o+2cLn2BjEjKVZQM1Gqjhhfy+QQ9Oy3x0PDz0H5HypK6nPJ9SUv9uV2RpanTBkLvxiUVkKpjRaXA80ejY8E7eg3/hUBqPKya/WyD41bpCXpP+tzvjrBBC9NjA8o2ks8VyuiQGWxkXGcNdkO3FMVg7puj4GtAMfLPa/Y2Tk/wI6IufhjHl0xa9eJmIEsMv06Y16cLlm6kNzzFEy3Pahi4kH6pUvcMfrAhUU3oCAAA=

L'output base64 dovrebbe essere simile al seguente:

ew==
IkZpbHRlcnMiOls=
ew==
IkRhdGFNb2RlbE5hbWUiOiJEYXRlIiw=
IlZhbHVlIjoiMjAyMi0wNC0wMSIs
Ik9wZXJhbmQiOjQ=
fSw=
ew==
IkRhdGFNb2RlbE5hbWUiOiJEYXRlIiw=
IlZhbHVlIjoiMjAyMi0wNC0zMCIs
Ik9wZXJhbmQiOjY=
fQ==
XSw=
IkRpbWVuc2lvbnMiOls=
ew==
IkRhdGFNb2RlbE5hbWUiOiJBdXRvQXR0ZW5kYW50SWRlbnRpdHki
fSw=
ew==
IkRhdGFNb2RlbE5hbWUiOiJBdXRvQXR0ZW5kYW50RGlyZWN0b3J5U2VhcmNoTWV0aG9kIg==
fQ==
XSw=
Ik1lYXN1cmVtZW50cyI6Ww==
ew==
IkRhdGFNb2RlbE5hbWUiOiJQU1ROVG90YWxNaW51dGVzIg==
fSw=
ew==
IkRhdGFNb2RlbE5hbWUiOiJUb3RhbENhbGxDb3VudCI=
fQ==
XSw=
IlBhcmFtZXRlcnMiOns=
IlVzZXJBZ2VudCI6IlBvd2VyIEJJIERlc2t0b3Ai
fSw=
IkxpbWl0UmVzdWx0Um93c0NvdW50IjoxMDAwMDA=
fQ==

URL-Encode la query JSON compressa

La query JSON compressa GZIP o Base64 deve essere codificata url.

L'output codificato dell'URL GZIP è simile al seguente:

H4sIAAAAAAAACq2SQWsCMRCF7%2F6KkLNC3EoPe9u6FISuFbW9lB4GM9TQbEaSCSLif%2B9mV4uCBwXnMkze5L0vkH1PCCFfjWX0QeZfaWxqf%2BxJLIGhIo12CjXKPM0o%2B2cLn2BjEjKVZQM1Gqjhhfy%2BQQ9Oy3x0PDz0H5HypK6nPJ9SUv9uV2RpanTBkLvxiUVkKpjRaXA80ejY8E7eg3%2FhUBqPKya%2FWyD41bpCXpP%2BtzvjrBBC9NjA8o2ks8VyuiQGWxkXGcNdkO3FMVg7puj4GtAMfLPa%2FY2Tk%2FwI6IufhjHl0xa9eJmIEsMv06Y16cLlm6kNzzFEy3Pahi4kH6pUvcMfrAhUU3oCAAA%3D

L'output codificato URL base64 è simile al seguente:

%0Aew%3D%3D%0AIkZpbHRlcnMiOls%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJEYXRlIiw%3D%0AIlZhbHVlIjoiMjAyMi0wNC0wMSIs%0AIk9wZXJhbmQiOjQ%3D%0AfSw%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJEYXRlIiw%3D%0AIlZhbHVlIjoiMjAyMi0wNC0zMCIs%0AIk9wZXJhbmQiOjY%3D%0AfQ%3D%3D%0AXSw%3D%0AIkRpbWVuc2lvbnMiOls%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJBdXRvQXR0ZW5kYW50SWRlbnRpdHki%0AfSw%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJBdXRvQXR0ZW5kYW50RGlyZWN0b3J5U2VhcmNoTWV0aG9kIg%3D%3D%0AfQ%3D%3D%0AXSw%3D%0AIk1lYXN1cmVtZW50cyI6Ww%3D%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJQU1ROVG90YWxNaW51dGVzIg%3D%3D%0AfSw%3D%0Aew%3D%3D%0AIkRhdGFNb2RlbE5hbWUiOiJUb3RhbENhbGxDb3VudCI%3D%0AfQ%3D%3D%0AXSw%3D%0AIlBhcmFtZXRlcnMiOns%3D%0AIlVzZXJBZ2VudCI6IlBvd2VyIEJJIERlc2t0b3Ai%0AfSw%3D%0AIkxpbWl0UmVzdWx0Um93c0NvdW50IjoxMDAwMDA%3D%0AfQ%3D%3D

Importante

L'API VAAC è limitata a restituire un massimo di 200.000 righe per ogni query.

Le richieste nel sistema vengono limitate in base all'indirizzo IP che effettua la chiamata, all'identità tenant riconosciuta nell'intestazione dell'autenticazione e al servizio di chiamata per impedire a un singolo client, tenant o servizio di monopolizzare le risorse.

Cronologia e stato del supporto per la versione 3.x.x

Consulta: Teams Auto Attendant & call queue historical reports - Change Log.docx in the downloaded zip file for a detailed list of changes.

Versione Data di pubblicazione Supportati Filename Descrizione
3.1.6 15 aprile 2024 Teams Auto Attendant & Call Queue Historical Reports V3.1.6 Supporto click2call, callback, utenti autorizzati e alcuni oggetti visivi modificati a causa della deprecazione
3.1.5 29 gennaio 2024 Teams Auto Attendant & Call Queue Historical Reports V3.1.5 Corretto un errore con la logica della query per giorno per fAgentTimelineAnalytics e fAgentTimelineAnalyticsSummary
3.1.4 24 gennaio 2024 Teams Auto Attendant & Call Queue Historical Reports V3.1.4 Report giornalieri per clienti con volumi di grandi dimensioni, miglioramenti dell'accessibilità per le utilità per la lettura dello schermo
3.1.3 13 settembre 2023 No Teams Auto Attendant & Call Queue Historical Reports V3.1.3 Miglioramenti dell'accessibilità per le utilità per la lettura dello schermo
3.1.2 21 luglio 2023 No Teams Auto Attendant & Call Queue Historical Reports V3.1.2 Supporta l'offset di qualsiasi fuso orario, pop-up di chiamata dettagliata aggiunta su Operatore automatico & coda di chiamata, supporto nessun agente
3.1.1 11 maggio 2023 No Teams Auto Attendant & Call Queue Historical Reports V3.1.1 Corretto un errore con i filtri dei dati Data, Agente e Coda di chiamata
3.1.0 1 maggio 2023 No Teams Auto Attendant & Call Queue Historical Reports V3.1.0 Nuovi modelli, aggiunta di una chiamata dettagliata nella sequenza temporale dell'agente, supporto del servizio Power BI
3.0.7 16 febbraio 2023 No Teams Auto Attendant & Call Queue Historical Reports V3.0.7 Errore corretto nella sequenza temporale dell'agente quando i minuti di chiamata sono maggiori di 9
3.0.6 14 febbraio 2023 No Teams Auto Attendant & Call Queue Historical Reports V3.0.6 Errore corretto, classificazione delle chiamate migliorata e visuali sequenza temporale dell'agente
3.0.5 9 gennaio 2023 No Teams Auto Attendant & Call Queue Historical Reports V3.0.5 Migliorati gli oggetti visivi Per le destinazioni di overflow/timeout delle chiamate e la sequenza temporale dell'agente
3.0.4 18 novembre 2022 No Teams Auto Attendant & Call Queue Historical Reports V3.0.4 Errore corretto, classificazione delle chiamate migliorata, aggiunta della legenda
3.0.3 8 novembre 2022 No Teams Auto Attendant & Call Queue Historical Reports V3.0.3 Errore corretto, collegamento alla documentazione aggiunto, query ottimizzate
3.0.1 26 ottobre 2022 No Teams Auto Attendant & Call Queue Historical Reports V3.0.1 Rimozione dell'immissione dell'origine dati di test
3.0.0 25 ottobre 2022 No Teams Auto Attendant & Call Queue Historical Reports V3.0.0 Nuova origine dati back-end