Freigeben über

Häufig gestellte Fragen zur Api für Aufrufdatensätze von Microsoft Graph

  • Artikel

Dieses Thema enthält Antworten auf häufig gestellte Fragen zur Aufrufdatensatz-API in Microsoft Graph.

Was ist die Api für Microsoft Graph-Aufrufdatensätze?

Die Microsoft Graph-Aufrufdatensätze-API bietet Nutzungs- und Diagnoseerkenntnisse für Anrufe und Onlinebesprechungen, die in Ihrem organization stattfinden, wenn Sie Microsoft Teams oder Skype for Business verwenden. Organisationen, die auch als "Mandanten" bezeichnet werden, können die Anrufdatensätze-API verwenden, um Anrufdatensätze nach Anruf-IDs zu abonnieren, aufzulisten, abzurufen und Anrufe für einen Teilnehmer nachzuschlagen. Weitere Informationen finden Sie unter Arbeiten mit der Aufrufdatensatz-API in Microsoft Graph.

Welche Berechtigung ist erforderlich, um die Aufrufdatensätze-API zu verwenden?

Ihre Anwendung benötigt die Berechtigung CallRecords.Read.All , um auf Anrufdatensätze in Microsoft Graph zuzugreifen. Ein Administrator muss der Anwendung diese Berechtigung erteilen. Weitere Informationen finden Sie in der Referenz zu den Microsoft Graph-Berechtigungen.

Kann ich delegierte Berechtigungen mit der Aufrufdatensatz-API verwenden?

Nein, die Api für Aufrufdatensätze unterstützt keine delegierten Berechtigungen.

Warum kann ich delegierte Berechtigungen nicht mit der Aufrufdatensatz-API verwenden?

Delegierte Berechtigungen können nicht verwendet werden, da es keine Möglichkeit gibt, die Berechtigung CallRecords.Read.All auf bestimmte Anrufe oder Benutzer zu beschränken. Die Anwendungsberechtigung wird auf organization Ebene gewährt, nicht auf der Ebene einzelner Benutzer.

Gewusst wie einen Anrufdatensatz mithilfe der Aufrufdatensätze-API anfordern?

Um einen Anrufdatensatz anzufordern, müssen Sie eine GET Anforderung an den /communications/callRecords/{id} Endpunkt senden, wobei {id} der eindeutige Bezeichner Ihres Anrufs ist. Stellen Sie sicher, dass Sie über die Berechtigung CallRecords.Read.All verfügen und den Autorisierungsheader mit einem gültigen Bearertoken einschließen. Weitere Informationen finden Sie in der Dokumentation zum Abrufen von CallRecord.

Wo finde ich die Anruf-IDs der Anrufe, die in meinem organization aufgetreten sind?

Sie können Anruf-IDs auf folgende Weise suchen und sammeln:

  • Abonnieren von Benachrichtigungen: Abonnieren Sie den Änderungsbenachrichtigungsfeed , und erhalten Sie Benachrichtigungen mit Anruf-IDs, wenn ein neuer Anrufdatensatz erstellt wird.
  • Aufrufdatensätze auflisten: Rufen Sie eine Liste der Anruf-IDs ab, indem Sie sie über die Api zum Auflisten von Aufrufdatensätzen anfordern.
  • Manuelle Suche: Wenn Sie Zugriff auf Die Anrufanalyse im Teams Admin Center für Microsoft Teams haben, können Sie manuell nach einer Anruf-ID im Verlauf eines Benutzers suchen. Es steht jedoch kein automatisiertes System zum Abrufen aller Anruf-IDs aus der Anrufanalyse zur Verfügung.
  • Use callChainId:: Look up the call ID using from callChainId the Get call API after the call is completed. Verwenden Sie diesen Ansatz, wenn der Aufruf programmgesteuert erstellt wird und Sie mit dem Aufrufressourcentyp arbeiten. Außerdem kann sich in callChainId bestimmten Szenarien, z. B. bei Übertragungsanrufen, aufgrund von Architekturspezifischen von der Anrufdatensatz-ID unterscheiden. Verwenden Sie daher nach Möglichkeit die anderen Methoden in dieser Liste.

Wann ist ein Anrufdatensatz verfügbar?

In der Regel wird eine erste Version eines Anrufdatensatzes generiert, und innerhalb von 15 Minuten nach Beendigung eines Anrufs wird eine Benachrichtigung gesendet. Es kann jedoch bis zu 60 Minuten dauern, bis der Dienst den Anrufdatensatz verfügbar macht. Weitere Informationen finden Sie auf der Seite Latenz .

Wie lange werden Anrufdatensätze aufbewahrt?

Anrufdatensätze werden 30 Tage nach Ende des Anrufs aufbewahrt.

Kann ich Anrufdatensätze abrufen, die älter als 30 Tage sind?

Nein, die Aufrufdatensätze-API gibt keine Aufrufdatensätze zurück, die älter als 30 Tage sind. Anforderungen für solche Datensätze führen zu einer 404 Not Found Fehlerantwort.

Warum wird die Benachrichtigung meines ersten Anrufdatensatzes verzögert?

Ihre Anrufdatensatzbenachrichtigung kann verzögert werden, da es bis zu 60 Minuten dauern kann, bis der Dienst die erste Version eines Anrufdatensatzes verfügbar macht. Wenn die Übermittlung der ersten Version des Anrufdatensatzes länger verzögert ist, überprüfen Sie auf der Registerkarte Integrität des Teams Admin Portal auf Ausfälle, die vom API-Team für Anrufdatensätze gemeldet wurden. Außerdem können Sie ein Supportticket beim API-Team für Anrufdatensätze öffnen.

Warum werden nachfolgende Versionen meines Anrufdatensatzes verzögert?

Nachfolgende Versionen eines Anrufdatensatzes können nach der anfänglichen Latenz von 60 Minuten übermittelt werden. Dies bedeutet, dass die erste Version zwar innerhalb von 60 Minuten verfügbar ist, spätere Aktualisierungen des Anrufdatensatzes aufgrund verzögerter Telemetriedaten vom Client und anderer Faktoren später eintreffen können.

Warum fehlen felder in einem Anrufdatensatz?

Ein Anrufdatensatz kann aufgrund verzögerter Telemetriedaten von einem Client fehlende Felder aufweisen. Wenn neue Telemetriedaten verfügbar werden, generiert das System einen neuen Anrufdatensatz mit aktualisierten Informationen, erhöht den version Eigenschaftswert und sendet den aktualisierten Anrufdatensatz an Sie. Wenn ihrem Anrufdatensatz Eigenschaften fehlen, warten Sie auf die nächste Anrufdatensatzversion.

Es ist jedoch wichtig zu beachten, dass einige Felder entwurfsbedingt leer bleiben können oder weil die Clienttelemetriedaten nie eingetroffen sind, z. B. Medienstreamwerte.

Wenn kritische oder zuvor übermittelte Felder fehlen, öffnen Sie ein Supportticket beim API-Team für Anrufdatensätze.

Wie kann ich alle Teilnehmer auflisten, die an einem Anruf teilgenommen haben?

Sie können die folgenden Methoden verwenden, um alle teilnehmenden Anrufteilnehmer aufzulisten:

  1. Auflisten der participants_v2-API

    Verwenden Sie die List participants_v2-API , um die vollständige Liste der Teilnehmer für eine angeforderte Anruf-ID zu sammeln.

  2. Verwenden Sie den OData-Abfrageparameter $expand für das callRecords-Objekt, um die eigenschaft participants_v2 zu erweitern.

    Sie können aufrufen GET communications/callRecords/{id}?$expand=participants_v2 , um allgemeine Anrufdetails zusammen mit der Teilnehmerliste abzurufen.

  3. Erstellen einer benutzerdefinierten Teilnehmerliste

    Um alle Teilnehmer anzuzeigen, implementieren Sie eine benutzerdefinierte Lösung, um die Teilnehmerliste aus den Anrufdatensätzen zu erstellen:

    1. Rufen Sie die Get callRecord-API auf, und erweitern Sie die sessions -Eigenschaft: GET /communications/callRecords/{id}?$expand=sessions.
    2. Lesen Sie für Peer-to-Peer-Aufrufe (P2P) sowohl die -Eigenschaft als auch die callercallee -Eigenschaft aus jeder session in der empfangenen sessions Liste. Lesen Sie bei Besprechungsanrufen nur die caller -Eigenschaft.
    3. Erstellen Sie Ihre benutzerdefinierte Teilnehmerliste basierend auf der callerEndpunktidentität. Schließen Sie für P2P-Aufrufe auch die calleeEndpunktidentität ein. Sammeln Sie die idEigenschaften , displayNameund , die Sie für jeden Teilnehmer benötigen.

Warum sehe ich nicht alle Teilnehmer, die an einem Anruf teilgenommen haben, während der Anrufliste participants_v2 API?

Möglicherweise werden nicht alle Teilnehmer angezeigt, da die List participants_v2-API Paginierung unterstützt und die Anzahl der Teilnehmer in der Antwort auf 130 pro Seite begrenzt. Wenn mehr als 130 Benutzer an dem Anruf teilnahmen, enthält die erste Anrufdatensatzantwort 130 Teilnehmer zusammen mit einer @odata.nextLink -Eigenschaft. Diese Eigenschaft enthält die URL zum Aufrufen der API und zum Empfangen der nächsten Gruppe von Teilnehmern. Setzen Sie diesen Vorgang fort, bis der nächste Link leer ist, was darauf hinweist, dass keine weiteren Teilnehmer mehr abgerufen werden müssen.

Warum werden doppelte Sitzungen für einen Anrufdatensatz zurückgegeben?

Eine Anrufaufzeichnungssitzung stellt eindeutig eine einzelne Benutzer-Benutzer-Kommunikation in Peer-to-Peer-Anrufen oder eine einzelne Benutzerdienstkommunikation in einem Gruppenanruf oder einer Besprechung dar. In einigen Anrufszenarien kann eine einzelne Benutzer-Dienst-Kommunikation jedoch mehrere Dienstidentitäten in einer einzelnen Sitzung umfassen, z. B. eine virtuelle Übertragung zwischen einer automatischen Telefonzentrale und einer Anrufwarteschleife. In diesen Szenarien kann eine Sitzungs-ID ein oder mehrere Male dupliziert werden, um jede an der Kommunikation beteiligte Identität und die jeweilige Kommunikationsdauer ordnungsgemäß darzustellen.

Warum erhalte ich den Fehler 404 Nicht gefunden?

Im Folgenden sind einige Gründe aufgeführt, warum ein 404 Not Found Fehler auftreten kann:

  • Zuletzt aufgerufen: Wenn der Anruf innerhalb der letzten 60 Minuten erfolgt ist, wurde der Anrufdatensatz möglicherweise noch nicht generiert. Warten Sie 60 Minuten nach Beendigung des Anrufs, und versuchen Sie es erneut.
  • Alter Aufruf: Wenn der Aufruf älter als 30 Tage ist, gibt die Aufrufdatensätze-API standardmäßig einen 404 Not Found Fehler zurück.
  • Andere Probleme: Wenn keiner der Gründe zutrifft, überprüfen Sie auf der Registerkarte Integrität des Teams Admin Portal auf Ausfälle, die vom API-Team für Aufrufdatensätze gemeldet wurden. Außerdem können Sie ein Supportticket beim API-Team für Anrufdatensätze öffnen, um Unterstützung zu erhalten.