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’appels pour vous abonner à des enregistrements d’appels et rechercher des 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 Get callRecord
session Get callRecord
Répertorier les sessions
segment Get callRecord
Répertorier les sessions
pstnCallLogRow getPstnCalls
directRoutingLogRow. getDirectRoutingCalls

Structure d’enregistrement d’appel

L’entité callRecord représente un appel d’égal à égal 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.