Creazione di report - Report cronologici delle applicazioni vocali

Il report di analisi dell'agente di telefonia di Teams cloud mostra l'analisi delle chiamate in arrivo agli agenti di telefonia di Teams.

Il report Analisi operatore automatico cloud mostra i dati analitici per le chiamate in arrivo agli operatori automatici.

Il report Analisi coda di chiamata cloud mostra l'analisi delle chiamate in arrivo in Call Code.

Il report Analisi sequenza temporale agente cloud mostra una visualizzazione sequenza temporale dei rappresentanti (agenti) attivi nelle chiamate in coda delle chiamate.

Esegui la procedura seguente:

1. Scaricare e salvare il file Teams Auto Attendant & Call Queue Historical Reports V3.3.1.pbit nel computer.

2. Apri il Teams Auto Attendant & Call Queue Historical Reports V3.3.1.pbit file modello. Dovrebbe essere avviato Power BI Desktop.

3. Selezionare la posizione del tenant, la lingua e la differenza UTC.

   

   • Posizione tenant: selezionare la posizione del cloud del tenant.
     • Il cloud pubblico include tenant Government Community Cloud (GCC).
   • Lingua: Selezionare la lingua e il livello di report.
     • Selezionare Per Call questa opzione per recuperare tutti i record delle singole chiamate.
     • Selezionare Per Day questa opzione per recuperare un totale aggregato per ogni giorno.
   • Offset UTC: selezionare la differenza UTC che rappresenta il fuso orario in cui vengono presentati i report. Valido solo quando il livello del rapporto è Per Call.

   Importante

   Per i clienti dell'agente telefonico di Teams, consultare i problemi noti di Analisi agente telefonico di Teams.

   Al giorno vs Per chiamata

   • Il report Per chiamata recupera i record delle singole chiamate per ogni operatore automatico, coda delle chiamate e rappresentante (agente) per cui l'utente è autorizzato e li rende disponibili nel client Power BI. La creazione di report per chiamata consente inoltre 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 DQC per controllare l'accesso, la segnalazione Per chiamata potrebbe comportare il raggiungimento del limite predefinito di 150.000 record per query. Vedi Limiti di dati.

   • La creazione di report giornalieri recupera un record di riepilogo giornaliero per ogni operatore automatico, coda di chiamate e rappresentante (agente). Questo reporting comporta un minor numero di record restituiti al client, riducendo la possibilità di raggiungere il limite predefinito di 150.000 record per query. La segnalazione giornaliera si basa solo su un giorno UTC-00:00 (00:00:00-23:59:59 UTC) e qualsiasi offset UTC fornito dall'utente viene ignorato.

I passaggi da 4 a 7 vengono eseguiti una sola volta, la prima volta che il modello viene caricato.

4. Configurare l'autenticazione delle origini dati.

   1. Selezionare File, quindi Opzioni e impostazioni e quindi Impostazioni origine dati.

   

5. Eseguire la procedura seguente per ognuna delle due origini dati visualizzate nel gruppo in base alla posizione del tenant:

   • Gruppo 1: Dipartimento della Difesa (DoD)
   • Gruppo 2: Government Community Cloud High (GCCH)
   • Gruppo 3: cloud pubblico (inclusi i tenant Government Community Cloud (GCC))

   1. Selezionare l'origine dati.

   2. Selezionare Modifica autorizzazioni, quindi Modifica.

   3. Selezionare Account aziendale e quindi Accedi (o Accedi come utente diverso).

      

   4. Accedere con il proprio account di Teams.

6. Selezionare Salva, quindi OK e infine Chiudi.

7. Selezionare Aggiorna nella barra multifunzione per aggiornare i dati.

   A seconda delle impostazioni di Power BI Desktop, potrebbe essere visualizzata anche la finestra popup seguente:

   

   Abilita la casella di controllo Ignora livelli di privacy . Tutti i dati provengono dal database dei report storici e non avviene alcun trasferimento di dati indesiderato.

Dopo la pubblicazione, eseguire i passaggi seguenti nel servizio Power BI:

1. Vai alle Impostazioni del set di dati.

2. Espandere la sezione Credenziali origine dati .

   

   • Gruppo 1: cloud pubblico (inclusi i tenant del Government Community Cloud (GCC))
   • Gruppo 2: Government Community Cloud High (GCCH)
   • Gruppo 3: Dipartimento della Difesa (DoD)

3. Eseguire la procedura seguente per le due origini dati del gruppo in base alla posizione del tenant:

   • Selezionare Modifica credenziali.
   • Impostare il metodo Authentication su OAuth2.
   • Imposta l'impostazione del livello di privacy per questa origine dati su Organizational.
   • Verificare che la connessione di prova sia abilitata.
   • Seleziona Accedi e fornisci le tue credenziali.

   

4. Eseguire la procedura seguente per le origini dati negli altri due gruppi:

   • Selezionare Modifica credenziali.
   • Impostare il metodo Authentication su Anonymous.
   • Imposta l'impostazione del livello di privacy per questa origine dati su Organizational.
   • Verificare che la connessione di prova sia abilitata.
   • Seleziona Accedi.

   

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

Note di analisi dell'agente di Telefono di Teams

1. Amministratori senza un criterio per le applicazioni vocali o amministratori con un criterio per le applicazioni vocali in cui le autorizzazioni per la creazione di report cronologici per l'operatore automatico sono impostate su None o Only authorized auto attendants: ↩

• La creazione di report viene eseguita in base al nome dell'account di risorsa.
• Gli operatori automatici annidati che ricevono chiamate tramite un Voice App trasferimento segnalano le chiamate sotto il GUID dell'operatore automatico.
• Per visualizzare le chiamate per uno specifico agente telefonico di Teams, selezionare gli account risorsa assegnati a tale agente telefonico di Teams.
  • Ad esempio: se il nome completo dell'account di risorsa è tpa_test@microsoft.com, questo valore è: tpa_test.

2. Amministratori con un criterio di applicazioni vocali in cui le autorizzazioni per la creazione di report cronologici per l'operatore automatico sono impostate su All o Utenti autorizzati: ↩

• La creazione di report avviene in base al nome dell'agente Telefono di Teams.

• Utenti di Code App:

  • Questo report non è attualmente disponibile per gli utenti di Code App.

Analisi agente telefonico di Teams Problemi noti

1. Il selettore di data a volte mostra date esterne all'intervallo di dati disponibili, generando un report vuoto. Modificare le date in modo che rientrino nell'intervallo di date supportato per risolvere il problema. ↩

2. Il report è supportato solo nelle lingue/impostazioni locali seguenti: ↩

• Inglese (Australia)
• Inglese (Regno Unito)
• Inglese (Stati Uniti)

Se è selezionata una lingua/impostazioni locali diverse da queste, viene utilizzato l'inglese (Stati Uniti) per impostazione predefinita.

3. Il report supporta solo la creazione di report a livello di chiamata . Se viene selezionata l'opzione Per giorno , il valore predefinito del report è Per chiamata. ↩

Note di analisi dell'operatore automatico

1. Amministratori senza un criterio per le applicazioni vocali o amministratori con un criterio per le applicazioni vocali in cui le autorizzazioni per la creazione di report cronologici per l'operatore automatico sono impostate su None o Only authorized auto attendants: ↩

• La creazione di report viene eseguita in base al nome dell'account di risorsa.
• Gli operatori automatici annidati che ricevono chiamate tramite un Voice App trasferimento segnalano le chiamate sotto il GUID dell'operatore automatico.
• Per visualizzare le chiamate per uno specifico operatore automatico, selezionare gli account di risorsa assegnati a tale operatore automatico.
  • Ad esempio: se il nome completo dell'account di risorsa è aa_test@microsoft.com, questo valore è: aa_test.

2. Amministratori con un criterio di applicazioni vocali in cui le autorizzazioni per la creazione di report cronologici per l'operatore automatico sono impostate su All o Utenti autorizzati: ↩

• La creazione di report avviene in base al nome dell'operatore automatico.

• Utenti di Code App:

  • La creazione di report viene eseguita in base al nome dell'account di risorsa.
  • I rapporti sono in UTC.

Analisi dell'operatore automatico Problemi noti

1. Il selettore di data a volte mostra date esterne all'intervallo di dati disponibili, generando un report vuoto. Modificare le date in modo che rientrino nell'intervallo di date supportato per risolvere il problema. ↩

Note di Analisi coda di chiamata

1. Amministratori senza un criterio per le applicazioni vocali o amministratori con un criterio per applicazioni vocali in cui le autorizzazioni per la creazione di report cronologici della coda delle chiamate sono impostate su None o Only authorized auto attendants: ↩

• La creazione di report viene eseguita in base al nome dell'account di risorsa.
• Le code di chiamate annidate che ricevono chiamate tramite un Voice App rapporto di trasferimento segnalano tali chiamate con il nome utente dell'account di risorsa che esegue il trasferimento.
• Per visualizzare le chiamate per una coda di chiamata specifica, selezionare gli account di risorsa assegnati a tale coda di chiamata o, se annidati, gli account di risorsa che eseguono i trasferimenti.
  • Ad esempio: se il nome completo dell'account di risorsa è aa_test@microsoft.com, questo valore è: aa_test.

2. Amministratori con un criterio di applicazioni vocali in cui le autorizzazioni per la creazione di report cronologici della coda delle chiamate sono impostate su All o Utenti autorizzati: ↩

• La segnalazione avviene in base al nome della coda di chiamata.

• Utenti di Code App:

  • La creazione di report viene eseguita in base al nome dell'account di risorsa.
  • I rapporti sono in UTC.

Analisi della coda di chiamata Problemi noti

1. Il selettore di data a volte mostra date esterne all'intervallo di dati disponibili, generando un report vuoto. Modificare le date in modo che rientrino nell'intervallo di date supportato per risolvere il problema. ↩

Note di analisi della sequenza temporale dell'agente

1. Amministratori senza un criterio per le applicazioni vocali o amministratori con un criterio per applicazioni vocali in cui le autorizzazioni per la creazione di report cronologici della coda delle chiamate sono impostate su None o Only authorized auto attendants: ↩

• La creazione di report viene eseguita in base al nome dell'account di risorsa.
• Le code di chiamate annidate che ricevono chiamate tramite un Voice App rapporto di trasferimento segnalano tali chiamate con il nome utente dell'account di risorsa che esegue il trasferimento.
• Per visualizzare le chiamate per una coda di chiamata specifica, selezionare gli account di risorsa assegnati a tale coda di chiamata o, se annidati, gli account di risorsa che eseguono i trasferimenti.
  • Ad esempio: se il nome completo dell'account di risorsa è aa_test@microsoft.com, questo valore è: aa_test.

2. Amministratori con un criterio di applicazioni vocali in cui le autorizzazioni per la creazione di report cronologici della coda delle chiamate sono impostate su All o Utenti autorizzati: ↩

• La segnalazione avviene in base al nome della coda di chiamata.

• Utenti di Code App:

  • La creazione di report viene eseguita in base al nome dell'account di risorsa.
  • I rapporti sono in UTC.

Analisi della sequenza temporale dell'agente Problemi noti

1. Il selettore di data a volte mostra date esterne all'intervallo di dati disponibili, generando un report vuoto. Modificare le date in modo che rientrino nell'intervallo di date supportato per risolvere il problema. ↩

2. Viene visualizzato il nome UPN dell'agente anziché il suo nome. ↩

3. Se un rappresentante (agente) risponde a una chiamata reindirizzata da un'altra coda a causa di un overflow delle chiamate, la chiamata viene conteggiata per la coda originale in cui si è verificato l'overflow, non per la coda a cui è stata data risposta.

4. Le chiamate di richiamata gestite dai rappresentanti (agenti) non vengono tracciate, quindi il report Coda di chiamata e il report Sequenza temporale agente mostrano un numero diverso di chiamate con risposta.

Queste istruzioni presuppongono che i modelli di report cronologici AA/CQ siano installati e funzionanti sul desktop.

Registra un'applicazione Entra ID

Nel portale di Azure:

1. Vai a Microsoft Entra IDRegistrazioni>app.
2. Selezionare Nuova registrazione.
3. Copia i seguenti valori:
   • ID tenant
   • Client ID
4. Creare un segreto client.
   • Assicurati di copiare questo segreto client subito dopo averlo creato, perché non è possibile recuperarlo una volta usciti dalla pagina di creazione.
5. Concedere a Microsoft Graph le autorizzazioni, ad esempio:
   • User.Read.All
   • Group.Read.All
6. Concedere il consenso dell'amministratore.

Configurare il report di Power BI

1. Aprire i report.
2. Selezionare Trasforma dati.
3. In Query:
   • Selezionare TenantID e incollare il valore del passaggio 3 precedente.
   • Seleziona ClientID e incolla il valore del passaggio 3 precedente.
   • Selezionare ClientSecret e incollare il valore del passaggio 4 precedente.
4. Selezionare TeamsUsers.
5. Selezionare Editor avanzato.
6. Eliminare tutto il testo visualizzato.
7. Copia il testo qui sotto.
8. Incollarlo nell'editor di Power BI.

let
    TeamsUserInvalidConfig = if Text.Length(TenantID) = 0 or Text.Length(ClientID) = 0 or Text.Length(ClientSecret) = 0 then true else false,

    GetAllPagesURL = if #"Tenant Location" = "Department of Defence (DoD)" then
                "https://dod-graph.microsoft.us/v1.0/users?$select=displayName,userPrincipalName,id"
            else if #"Tenant Location" = "Government Community Cloud High (GCCH)" then
                "https://graph.microsoft.us/v1.0/users?$select=displayName,userPrincipalName,id"
            else  // Public Cloud
                "https://graph.microsoft.com/v1.0/users?$select=displayName,userPrincipalName,id",
    
    TokenResponse = if TeamsUserInvalidConfig then
            null
        else
            if #"Tenant Location" = "Department of Defence (DoD)" then
                Json.Document(
                    Web.Contents(
                        "https://login.microsoftonline.us",
                        [
                            RelativePath = TenantID & "/oauth2/v2.0/token",
                            Headers = [
                                #"Content-Type" = "application/x-www-form-urlencoded"
                            ],
                            Content =
                                Text.ToBinary(
                                    Uri.BuildQueryString([
                                        client_id = ClientID,
                                        scope = "https://graph.microsoft.com/.default",
                                        client_secret = ClientSecret,
                                        grant_type = "client_credentials"
                                    ])
                                )
                        ]
                    )
                )
            else if #"Tenant Location" = "Government Community Cloud High (GCCH)" then
                 Json.Document(
                    Web.Contents(
                        "https://login.microsoftonline.us",
                        [
                            RelativePath = TenantID & "/oauth2/v2.0/token",
                            Headers = [
                                #"Content-Type" = "application/x-www-form-urlencoded"
                            ],
                            Content =
                                Text.ToBinary(
                                    Uri.BuildQueryString([
                                        client_id = ClientID,
                                        scope = "https://graph.microsoft.com/.default",
                                        client_secret = ClientSecret,
                                        grant_type = "client_credentials"
                                    ])
                                )
                        ]
                    )
                )
            else // Public Cloud
                Json.Document(
                    Web.Contents(
                        "https://login.microsoftonline.com",
                        [
                            RelativePath = TenantID & "/oauth2/v2.0/token",
                            Headers = [
                                #"Content-Type" = "application/x-www-form-urlencoded"
                            ],
                            Content =
                                Text.ToBinary(
                                    Uri.BuildQueryString([
                                        client_id = ClientID,
                                        scope = "https://graph.microsoft.com/.default",
                                        client_secret = ClientSecret,
                                        grant_type = "client_credentials"
                                    ])
                                )
                        ]
                    )
                ),

    AccessToken = if TeamsUserInvalidConfig then
            null
        else
            TokenResponse[access_token],

    GetPage = if TeamsUserInvalidConfig then
            null
        else
            (url as text) =>
            let
                Source = Json.Document(
                    Web.Contents(
                        url,
                        [
                            Headers = [
                                Authorization = "Bearer " & AccessToken
                            ]
                        ]
                    )
                )
            in
                Source,

    GetAllPages = if TeamsUserInvalidConfig then
            null
        else
            (url as text) =>
            let
                Pages =
                    List.Generate(
                        () => GetPage(url),
                        each _ <> null,
                        each
                            if Record.HasFields(_, "@odata.nextLink")
                            then GetPage(_[#"@odata.nextLink"])
                            else null,
                        each _[value]
                    ),

                Combined = List.Combine(Pages)
            in
                Combined,

    Result = if TeamsUserInvalidConfig then
            Table.FromRows(
                {
                    { "", "", "" }
                },
                { "displayName", "userPrincipalName", "id"}
            )
        else
            GetAllPages(GetAllPagesURL),

    UsersTable = if TeamsUserInvalidConfig then
            Result
        else
            Table.FromRecords(Result),

    // converting to lower case as AgentTimeline is all lower case
    LowerCaseColumn = Table.TransformColumns(
        UsersTable,
        {{"userPrincipalName", Text.Lower, type text}}
    )

in
    LowerCaseColumn

Impostazioni locali supportate

Problemi noti di localizzazione

1. La lingua selezionata si applica solo ai report e non ai componenti o alle descrizioni comandi di Power BI. Per impostazione predefinita, Power BI usa la stessa lingua del desktop di Windows.

   Per cambiare la lingua di Power BI, selezionare:

   • File
   • Opzioni e impostazioni
   • Opzioni
   • Impostazioni internazionali
   • Lingua dell'applicazione
     • Impostazione predefinita impostata su "Usa la lingua di visualizzazione predefinita di Windows".
     • Seleziona la lingua desiderata nell'elenco a discesa.

       Nota

       L'elenco di lingue visualizzato qui potrebbe essere diverso da quello disponibile per il modello di report.

2. Il nome del file ZIP e i file del modello di report effettivo sono solo in inglese.

3. La schermata iniziale mostra il nome del file (vedere #2) e le parole "Tenant Location", "Language" e "UTC Offset" solo in inglese.

4. La schermata di aggiornamento mostra i nomi delle tabelle solo in inglese.

5. I nomi delle schede del report sono solo in inglese.

6. Il collegamento alla documentazione usa la lingua impostata nel browser, che potrebbe essere diversa dalla lingua selezionata per il report.

7. Le informazioni fornite dal cliente, come l'operatore automatico e i nomi delle code di chiamata, non sono localizzate.

8. La legenda dell'oggetto visivo Coda di chiamate - Volume delle chiamate, Chiamate abbandonate e Conteggio consenso esplicito agente è solo in inglese.

9. La parola TeamsPhoneMobile presente nella colonna Tipo di chiamata nella tabella Dettagli chiamata nella parte inferiore dei report Operatore automatico e Coda di chiamata non è localizzata.

   I problemi da 2 a 6 riguardano le limitazioni delle convenzioni di denominazione dei file, delle schermate di Power BI e del funzionamento dei browser. Questi problemi non verranno risolti.