Partager via


Utilisation de l’API d’enregistrements d’appels dans Microsoft Graph

Les enregistrements d’appels fournissent des informations d’utilisation et de diagnostic sur les appels et les réunions en ligne qui se produisent au sein de votre organisation lorsque vous utilisez Microsoft Teams ou Skype Entreprise. Vous pouvez utiliser les API d’enregistrements d’appel pour vous abonner aux enregistrements d’appel, répertorier les enregistrements d’appels et rechercher les enregistrements d’appels par ID. Un enregistrement d’appel est créé après la fin d’un appel ou d’une réunion et l’enregistrement est conservé pendant 30 jours.

L’API d’enregistrements d’appel est définie dans le sous-espace de noms OData, microsoft.graph.callRecords.

Types de ressources clés

Resource Méthodes
callRecord Répertorier les callRecords
Get callRecord
directRoutingLogRow. getDirectRoutingCalls
participant Lister les participants_v2
pstnCallLogRow getPstnCalls
segment Répertorier les sessions
Get callRecord
session Répertorier les sessions
Get callRecord

Structure d’enregistrement d’appel

L’entité callRecord représente un seul appel pair à pair ou un appel de groupe entre plusieurs participants, parfois appelé réunion en ligne.

Un appel d’égal à égal contient une session unique entre les deux participants à l’appel. Les appels de groupe contiennent une ou plusieurs entités de session. Dans un appel de groupe, chaque session se situe entre le participant et un point de terminaison de service.

Chaque session contient une ou plusieurs entités de segment. Un segment représente un lien multimédia entre deux points de terminaison. Pour la plupart des appels, un seul segment est présent pour chaque session, mais il peut arriver qu’il y ait un ou plusieurs points de terminaison intermédiaires.

Image d’une structure de données représentant un enregistrement d’appel complet

Dans le diagramme ci-dessus, les chiffres indiquent le nombre d’enfants de chaque type qui peuvent être présents. Par exemple, une relation 1..N entre une méthode callRecord et une session signifie qu’une instance callRecord peut contenir une ou plusieurs instances de session. De même, une relation 1..N entre un segment et un média signifie qu’une instance de segment peut contenir un ou plusieurs flux de média.