Berichterstellung – Verlaufsberichte für VoIP-Anwendungen

Der Bericht "Cloud Teams Telefon-Agent-Analyse" zeigt Analysen für Anrufe an, die in Ihren Teams Telefon-Agenten eingehen.

Der Bericht zur Analyse der automatischen Cloud-Telefonzentrale zeigt Analysen für Anrufe an, die in Ihre automatischen Telefonzentralen eingehen.

Der Bericht zur Analyse der Cloudanrufwarteschleife zeigt Analysen für Anrufe an, die in Ihre Anruf-Warteschlangen eingehen.

Der Bericht Cloud Agent Timeline Analytics zeigt eine Zeitleiste der Vertreter (Agents), die in Anrufen der Anrufwarteschleife aktiv sind.

Führen Sie die folgenden Schritte durch:

1. Laden Sie die Datei " Teams Auto Attendant & Call Queue Historical Reports V3.3.1.pbit " herunter, und speichern Sie sie auf Ihrem Computer.

2. Öffnen Sie die Teams Auto Attendant & Call Queue Historical Reports V3.3.1.pbit Vorlagendatei. Power BI Desktop sollte gestartet werden.

3. Wählen Sie den Standort, die Sprache und den UTC-Offset des Mandanten aus.

   

   • Standort des Mandanten: Wählen Sie den Standort der Mandanten-Cloud aus.
     • Die Public Cloud umfasst Government Community Cloud (GCC)-Mandanten.
   • Sprache: Wählen Sie die Sprache und die Berichtsebene aus.
     • Wählen Sie diese Option Per Call aus, um alle einzelnen Anrufdatensätze abzurufen.
     • Wählen Sie diese Option Per Day aus, um eine aggregierte Summe für jeden Tag abzurufen.
   • UTC-Offset: Wählen Sie den UTC-Offset aus, der die Zeitzone darstellt, in der die Berichte angezeigt werden. Nur gültig, wenn die Berichtsebene ist Per Call.

   Wichtig

   Kunden des Teams Phone Agent finden Sie unter bekannte Probleme mit der Analyse des Teams-Telefon-Agents.

   Pro Tag vs. pro Anruf

   • Die Berichterstellung pro Anruf ruft die einzelnen Anrufdatensätze für jede automatische Telefonzentrale, Anrufwarteschleife und jeden Vertreter (Agent) ab, für die der Benutzer autorisiert ist, und stellt sie im Power BI-Client zur Verfügung. Die Berichterstellung pro Anruf ermöglicht auch die Anzeige von Anrufdatensätzen in der vom Benutzer ausgewählten lokalen Zeitzone. Bei einigen Kunden, insbesondere bei Kunden, die die AQD-Zugriffsrolle zur Steuerung des Zugriffs verwenden, kann die Berichterstellung pro Anruf dazu führen, dass der Standardgrenzwert von 150.000 pro Abfragedatensatz erreicht wird. Siehe Datenlimits.

   • Bei der Berichterstellung pro Tag wird ein täglicher Zusammenfassungsdatensatz für jede automatische Telefonzentrale, jede Anrufwarteschleife und jeden Vertreter (Agent) abgerufen. Diese Berichterstellung führt dazu, dass weniger Datensätze an den Client zurückgegeben werden, wodurch die Wahrscheinlichkeit verringert wird, dass der Grenzwert von 150.000 Standarddatensätzen pro Abfrage erreicht wird. Die Berichterstellung pro Tag basiert nur auf einem UTC-00:00-Tag (00:00:00-23:59:59 UTC). Alle vom Benutzer angegebenen UTC-Offsets werden ignoriert.

Die Schritte 4 bis 7 werden nur einmal ausgeführt, nämlich beim ersten Laden der Vorlage.

4. Konfigurieren Sie die Datenquellenauthentifizierung.

   1. Wählen Sie Datei, dann Optionen und Einstellungen und dann Datenquelleneinstellungen aus.

   

5. Führen Sie die folgenden Schritte für jede der beiden Datenquellen aus, die in der Gruppe basierend auf Ihrem Mandantenstandort angezeigt werden:

   • Gruppe 1: Verteidigungsministerium (DoD)
   • Gruppe 2: Government Community Cloud High (GCCH)
   • Gruppe 3: Public Cloud (einschließlich Government Community Cloud (GCC)-Mandanten)

   1. Wählen Sie die Datenquelle aus.

   2. Wählen Sie Berechtigungen bearbeiten und dann Bearbeiten aus.

   3. Wählen Sie Organisationskonto und dann Anmelden (oder Als anderer Benutzer anmelden).

      

   4. Melden Sie sich mit Ihrem Teams-Konto an.

6. Wählen Sie Speichern, dann OK und dann Schließen aus.

7. Wählen Sie in der Menübandleiste "Aktualisieren " aus, und die Daten werden aktualisiert.

   Abhängig von Ihren Power BI Desktop-Einstellungen kann auch das folgende Popupfenster angezeigt werden:

   

   Aktivieren Sie das Kontrollkästchen "Datenschutzstufen ignorieren ". Alle Daten stammen aus der historischen Berichtsdatenbank, und es findet keine unerwünschte Datenübertragung statt.

Führen Sie nach der Veröffentlichung die folgenden Schritte im Power BI-Dienst aus:

1. Wechseln Sie zu den Dataseteinstellungen.

2. Erweitern Sie den Abschnitt "Datenquellen-Anmeldeinformationen ".

   

   • Gruppe 1: Public Cloud (einschließlich Government Community Cloud (GCC)-Mandanten)
   • Gruppe 2: Government Community Cloud High (GCCH)
   • Gruppe 3: Verteidigungsministerium (DoD)

3. Führen Sie die folgenden Schritte für die beiden Datenquellen in der Gruppe basierend auf Ihrem Mandantenstandort aus:

   • Wählen Sie Anmeldeinformationen bearbeiten aus.
   • Legen Sie die Authentifizierungsmethode auf fest.OAuth2
   • Legen Sie die Datenschutzebene für diese Datenquelle auf Organizationalfest.
   • Stellen Sie sicher, dass "Testverbindung überspringen" aktiviert ist.
   • Wählen Sie Anmelden aus, und geben Sie Ihre Anmeldeinformationen ein.

   

4. Führen Sie die folgenden Schritte für die Datenquellen in den beiden anderen Gruppen aus:

   • Wählen Sie Anmeldeinformationen bearbeiten aus.
   • Legen Sie die Authentifizierungsmethode auf fest.Anonymous
   • Legen Sie die Datenschutzebene für diese Datenquelle auf Organizationalfest.
   • Stellen Sie sicher, dass "Testverbindung überspringen" aktiviert ist.
   • Wählen Sie Anmelden aus.

   

Nach Abschluss des Vorgangs können Sie eine geplante Aktualisierung des Datasets konfigurieren.

Analysenotizen des Teams Telefon-Agents

1. Administratoren ohne Richtlinie für VoIP-Anwendungen oder Administratoren mit einer Richtlinie für VoIP-Anwendungen, bei denen die Berechtigungen für die Verlaufsberichterstellung für die automatische Telefonzentrale festgelegt sind auf NoneOnly authorized auto attendants: ↩

• Die Berichterstellung erfolgt nach dem Namen des Ressourcenkontos.
• Geschachtelte automatische Telefonzentralen, die Anrufe über eine Voice App Übertragung erhalten, melden diese Anrufe unter der GUID der automatischen Telefonzentrale.
• Um die Anrufe für einen bestimmten Teams Telefon-Agenten anzuzeigen, wählen Sie die Ressourcenkonten aus, die diesem Teams Telefon-Agenten zugewiesen sind.
  • Beispiel: Wenn der vollständige Ressourcenkontoname tpa_test@microsoft.comlautet, lautet dieser Wert: tpa_test.

2. Administratoren mit einer VoIP-Anwendungsrichtlinie, bei der die Berechtigungen für die Verlaufsberichterstellung der automatischen Telefonzentrale festgelegt sind auf All , oder Autorisierte Benutzer: ↩

• Die Berichterstellung erfolgt nach Teams Telefon-Agent-Name.

• Warteschlangen für App-Benutzer:

  • Dieser Bericht ist derzeit für Benutzer von Warteschlangen-Apps nicht verfügbar.

Teams Phone Agent-Analyse: Bekannte Probleme

1. Die Datumsauswahl zeigt manchmal Datumsangaben außerhalb des Bereichs verfügbarer Daten an, was zu einem leeren Bericht führt. Ändern Sie die Datumsangaben so, dass sie innerhalb des unterstützten Datumsbereichs liegen, um das Problem zu beheben. ↩

2. Der Bericht wird nur in den folgenden Sprachen/Gebietsschemas unterstützt: ↩

• Englisch (Australien)
• Englisch (Vereinigtes Königreich)
• Englisch (USA)

Wenn eine andere Sprache/ein anderes Gebietsschema als diese ausgewählt ist, wird standardmäßig Englisch (USA) verwendet.

3. Der Bericht unterstützt nur die Berichterstellung auf Anrufebene. Wenn "Pro Tag " ausgewählt ist, wird im Bericht standardmäßig "Pro Anruf" verwendet. ↩

Analysenotizen der automatischen Telefonzentrale

1. Administratoren ohne Richtlinie für VoIP-Anwendungen oder Administratoren mit einer Richtlinie für VoIP-Anwendungen, bei denen die Berechtigungen für die Verlaufsberichterstellung für die automatische Telefonzentrale festgelegt sind auf NoneOnly authorized auto attendants: ↩

• Die Berichterstellung erfolgt nach dem Namen des Ressourcenkontos.
• Geschachtelte automatische Telefonzentralen, die Anrufe über eine Voice App Übertragung erhalten, melden diese Anrufe unter der GUID der automatischen Telefonzentrale.
• Um die Anrufe für eine bestimmte automatische Telefonzentrale anzuzeigen, wählen Sie die Ressourcenkonten aus, die dieser automatischen Telefonzentrale zugewiesen sind.
  • Beispiel: Wenn der vollständige Ressourcenkontoname aa_test@microsoft.comlautet, lautet dieser Wert: aa_test.

2. Administratoren mit einer VoIP-Anwendungsrichtlinie, bei der die Berechtigungen für die Verlaufsberichterstellung der automatischen Telefonzentrale festgelegt sind auf All , oder Autorisierte Benutzer: ↩

• Die Berichterstellung erfolgt nach dem Namen der automatischen Telefonzentrale.

• Warteschlangen für App-Benutzer:

  • Die Berichterstellung erfolgt nach dem Namen des Ressourcenkontos.
  • Berichte sind in UTC.

Analyse der automatischen Telefonzentrale Bekannte Probleme

1. Die Datumsauswahl zeigt manchmal Datumsangaben außerhalb des Bereichs verfügbarer Daten an, was zu einem leeren Bericht führt. Ändern Sie die Datumsangaben so, dass sie innerhalb des unterstützten Datumsbereichs liegen, um das Problem zu beheben. ↩

Notizen zu Analysedaten der Anrufwarteschleife

1. Administratoren ohne Richtlinie für VoIP-Anwendungen oder Administratoren mit einer Richtlinie für VoIP-Anwendungen, bei denen die Berechtigungen für die Berichterstellung des Anrufwarteschleifenverlaufs festgelegt sind auf NoneOnly authorized auto attendants: ↩

• Die Berichterstellung erfolgt nach dem Namen des Ressourcenkontos.
• Verschachtelte Anrufwarteschlangen, die Anrufe über eine Voice App Übertragung erhalten, melden diese Anrufe unter dem Benutzernamen des Ressourcenkontos, der die Übertragung durchführt.
• Um die Anrufe für eine bestimmte Anrufwarteschleife anzuzeigen, wählen Sie die Ressourcenkonten aus, die dieser Anrufwarteschleife zugewiesen sind, oder, falls verschachtelt, die Ressourcenkonten, die die Übertragungen durchführen.
  • Beispiel: Wenn der vollständige Ressourcenkontoname aa_test@microsoft.comlautet, lautet dieser Wert: aa_test.

2. Administratoren mit einer VoIP-Anwendungsrichtlinie, bei denen die Berechtigungen zur Berichterstellung des Anrufwarteschleifenverlaufs festgelegt All sind, oder Autorisierte Benutzer: ↩

• Die Berichterstellung erfolgt nach Name der Anrufwarteschleife.

• Warteschlangen für App-Benutzer:

  • Die Berichterstellung erfolgt nach dem Namen des Ressourcenkontos.
  • Berichte sind in UTC.

Analyse der Anrufwarteschleife: Bekannte Probleme

1. Die Datumsauswahl zeigt manchmal Datumsangaben außerhalb des Bereichs verfügbarer Daten an, was zu einem leeren Bericht führt. Ändern Sie die Datumsangaben so, dass sie innerhalb des unterstützten Datumsbereichs liegen, um das Problem zu beheben. ↩

Notizen zur Analyse der Agent-Zeitachse

1. Administratoren ohne Richtlinie für VoIP-Anwendungen oder Administratoren mit einer Richtlinie für VoIP-Anwendungen, bei denen die Berechtigungen für die Berichterstellung des Anrufwarteschleifenverlaufs festgelegt sind auf NoneOnly authorized auto attendants: ↩

• Die Berichterstellung erfolgt nach dem Namen des Ressourcenkontos.
• Verschachtelte Anrufwarteschlangen, die Anrufe über eine Voice App Übertragung erhalten, melden diese Anrufe unter dem Benutzernamen des Ressourcenkontos, der die Übertragung durchführt.
• Um die Anrufe für eine bestimmte Anrufwarteschleife anzuzeigen, wählen Sie die Ressourcenkonten aus, die dieser Anrufwarteschleife zugewiesen sind, oder, falls verschachtelt, die Ressourcenkonten, die die Übertragungen durchführen.
  • Beispiel: Wenn der vollständige Ressourcenkontoname aa_test@microsoft.comlautet, lautet dieser Wert: aa_test.

2. Administratoren mit einer VoIP-Anwendungsrichtlinie, bei denen die Berechtigungen zur Berichterstellung des Anrufwarteschleifenverlaufs festgelegt All sind, oder Autorisierte Benutzer: ↩

• Die Berichterstellung erfolgt nach Name der Anrufwarteschleife.

• Warteschlangen für App-Benutzer:

  • Die Berichterstellung erfolgt nach dem Namen des Ressourcenkontos.
  • Berichte sind in UTC.

Analyse der Agent-Zeitachse Bekannte Probleme

1. Die Datumsauswahl zeigt manchmal Datumsangaben außerhalb des Bereichs verfügbarer Daten an, was zu einem leeren Bericht führt. Ändern Sie die Datumsangaben so, dass sie innerhalb des unterstützten Datumsbereichs liegen, um das Problem zu beheben. ↩

2. Der UPN-Name des Agenten anstelle seines Namens wird angezeigt. ↩

3. Wenn ein Mitarbeiter (Agent) einen umgeleiteten Anruf aus einer anderen Warteschleife aufgrund eines Anrufüberlaufs beantwortet, wird der Anruf der ursprünglichen Warteschleife zugerechnet, in der der Überlauf aufgetreten ist, nicht der Warteschlange, in der er beantwortet wurde.

4. Rückrufanrufe, die von Vertretern (Agents) bearbeitet werden, werden nicht nachverfolgt, daher zeigen der Anrufwarteschleifenbericht und der Agentzeitachsenbericht eine unterschiedliche Anzahl beantworteter Anrufe an.

Bei diesen Anweisungen wird davon ausgegangen, dass Sie die Vorlagen für AA/CQ-Verlaufsberichte auf Ihrem Desktop installiert haben und verwenden.

Registrieren einer Entra ID-Anwendung

Im Azure-Portal:

1. Wechseln Sie zu Microsoft Entra ID>:App-Registrierungen.
2. Wählen Sie Neue Registrierung aus.
3. Kopieren Sie die folgenden Werte:
   • Mandanten-ID
   • Client-ID
4. Einen geheimen Clientschlüssel erstellen.
   • Stellen Sie sicher, dass Sie diesen geheimen Clientschlüssel sofort nach der Erstellung kopieren, da es keine Möglichkeit gibt, ihn abzurufen, sobald Sie die Erstellungsseite verlassen haben.
5. Erteilen Sie Microsoft Graph Berechtigungen wie:
   • User.Read.All
   • Group.Read.All
6. Administratoreinwilligung erteilen.

Einrichten des Power BI-Berichts

1. Öffnen Sie die Berichte.
2. Wählen Sie Daten transformieren aus.
3. Unter Abfragen:
   • Wählen Sie TenantID aus, und fügen Sie den Wert aus Schritt 3 oben ein.
   • Wählen Sie "ClientID" aus, und fügen Sie den Wert aus Schritt 3 oben ein.
   • Wählen Sie ClientSecret aus, und fügen Sie den Wert aus Schritt 4 oben ein.
4. Wählen Sie TeamsUsers aus.
5. Wählen Sie Erweiterter Editor aus.
6. Löschen Sie den gesamten Text, der angezeigt wird.
7. Kopieren Sie den folgenden Text.
8. Fügen Sie es in den Power BI Editor ein.

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

Unterstützte Gebietsschemas

Bekannte Probleme bei der Lokalisierung

1. Die ausgewählte Sprache gilt nur für die Berichte und nicht für die Power BI-Komponenten oder QuickInfos. Power BI verwendet standardmäßig dieselbe Sprache wie der Windows-Desktop.

   Um die Power BI-Sprache zu ändern, wählen Sie Folgendes aus:

   • Datei
   • Optionen und Einstellungen
   • Optionen
   • Regionale Einstellungen
   • Anwendungssprache
     • Der Standardwert ist auf "Windows-Standardanzeigesprache verwenden" festgelegt.
     • Wählen Sie in der Dropdownliste die gewünschte Sprache aus.

       Hinweis

       Die Liste der hier angezeigten Sprachen kann sich von den Sprachen unterscheiden, die für die Berichtsvorlage verfügbar sind.

2. Der Name der ZIP-Datei und die eigentlichen Berichtsvorlagendateien sind nur in Englisch verfügbar.

3. Der Begrüßungsbildschirm zeigt den Dateinamen (siehe #2) und die Wörter "Tenant Location", "Language" und "UTC Offset" nur in Englisch an.

4. Auf dem Aktualisierungsbildschirm werden die Tabellennamen nur in Englisch angezeigt.

5. Die Namen der Berichtsregisterkarten sind nur in Englisch verfügbar.

6. Der Dokumentationslink verwendet die in Ihrem Browser festgelegte Sprache, die sich von der für den Bericht ausgewählten Sprache unterscheiden kann.

7. Vom Kunden bereitgestellte Informationen wie die Namen der automatischen Telefonzentrale und der Anrufwarteschleife sind nicht lokalisiert.

8. Die Legende zum Visual "Anrufwarteschleife: Anrufvolumen, abgebrochene Anrufe und Anzahl der Opt-in-Agents " ist nur in Englisch verfügbar.

9. Das Wort TeamsPhoneMobile in der Spalte "Anruftyp " in der Tabelle "Anrufdetails" unten in den Berichten für die automatische Telefonzentrale und die Anrufwarteschleife ist nicht lokalisiert.

   Die Probleme 2 bis 6 sind Einschränkungen von Dateibenennungskonventionen, Bildschirmen in Power BI und der Funktionsweise von Browsern. Diese Probleme werden nicht behoben.