Partager via

FAQ sur l’API des enregistrements d’appel Microsoft Graph

  • Article

Cette rubrique fournit des réponses aux questions fréquemment posées sur l’API d’enregistrements d’appels dans Microsoft Graph.

Qu’est-ce que l’API d’enregistrements d’appel Microsoft Graph ?

L’API d’enregistrements d’appels Microsoft Graph offre des insights d’utilisation et de diagnostic pour les appels et les réunions en ligne qui se produisent dans votre organization lors de l’utilisation de Microsoft Teams ou de Skype Entreprise. Les organisations, également appelées « locataires », peuvent utiliser l’API d’enregistrements d’appel pour s’abonner, répertorier, récupérer des enregistrements d’appels par ID d’appel et rechercher des appels pour un participant. Pour plus d’informations, consultez Utilisation de l’API d’enregistrements d’appel dans Microsoft Graph.

Quelle autorisation est requise pour utiliser l’API d’enregistrements d’appel ?

Votre application a besoin de l’autorisation CallRecords.Read.All pour accéder aux enregistrements d’appels dans Microsoft Graph. Un administrateur doit accorder cette autorisation à l’application. Pour plus d’informations, reportez-vous à l’article relatif aux Autorisations Microsoft Graph.

Puis-je utiliser des autorisations déléguées avec l’API d’enregistrements d’appel ?

Non, l’API d’enregistrements d’appel ne prend pas en charge les autorisations déléguées.

Pourquoi ne puis-je pas utiliser des autorisations déléguées avec l’API d’enregistrements d’appel ?

Vous ne pouvez pas utiliser d’autorisations déléguées, car il n’existe aucun moyen de limiter l’autorisation CallRecords.Read.All à des appels ou des utilisateurs spécifiques. L’autorisation d’application est accordée au niveau organization, et non au niveau de l’utilisateur individuel.

Comment faire demander un enregistrement d’appel à l’aide de l’API d’enregistrements d’appel ?

Pour demander un enregistrement d’appel, vous devez effectuer une GET demande au /communications/callRecords/{id} point de terminaison, où {id} est l’identificateur unique de votre appel. Vérifiez que vous disposez de l’autorisation CallRecords.Read.All et incluez l’en-tête Authorization avec un jeton du porteur valide. Pour plus d’informations, consultez la documentation Obtenir callRecord.

Où puis-je trouver les ID d’appel des appels qui se sont produits dans mon organization ?

Vous pouvez rechercher et collecter les ID d’appel des manières suivantes :

  • S’abonner aux notifications : Abonnez-vous au flux de notifications de modification et recevez des notifications contenant des ID d’appel chaque fois qu’un enregistrement d’appel est créé.
  • Répertorier les enregistrements d’appel : obtenez une liste d’ID d’appel en la demandant à partir de l’API List callRecords.
  • Recherche manuelle : si vous avez accès à l’analyse des appels dans le Centre Administration Teams pour Microsoft Teams, vous pouvez rechercher manuellement un ID d’appel dans l’historique d’un utilisateur. Toutefois, aucun système automatisé n’est disponible pour récupérer tous les ID d’appel à partir d’Analyse des appels.
  • Utiliser callChainId : recherchez l’ID d’appel à l’aide de à callChainId partir de l’API Get call une fois l’appel terminé. Utilisez cette approche lorsque l’appel est créé par programmation et que vous travaillez avec le type de ressource d’appel. En outre, le peut différer de l’ID d’enregistrement d’appel dans certains scénarios, tels que les callChainId appels de transfert, en raison des spécificités de l’architecture. Par conséquent, utilisez les autres méthodes de cette liste si possible.

Quand un enregistrement d’appel est-il disponible ?

Une première version d’un enregistrement d’appel est généralement générée et une notification est envoyée dans les 15 minutes suivant la fin d’un appel. Toutefois, jusqu’à 60 minutes peuvent être nécessaires pour que le service rende l’enregistrement d’appel disponible. Pour plus d’informations, consultez la page Latence .

Combien de temps les enregistrements d’appels sont-ils conservés ?

Les enregistrements d’appel sont conservés pendant 30 jours après la fin de l’appel.

Puis-je récupérer des enregistrements d’appels datant de plus de 30 jours ?

Non, l’API d’enregistrements d’appel ne retourne pas les enregistrements d’appels antérieurs à 30 jours. Les demandes de ces enregistrements entraînent une 404 Not Found réponse d’erreur.

Pourquoi ma première notification d’enregistrement d’appel est-elle retardée ?

Votre notification d’enregistrement d’appel peut être retardée, car la mise à disposition de la première version d’un enregistrement d’appel peut prendre jusqu’à 60 minutes. Si vous rencontrez un délai plus long pour la remise de la première version d’enregistrement d’appel, case activée pour les pannes signalées par l’équipe de l’API d’enregistrements d’appel dans l’onglet Intégrité du portail Administration Teams. En outre, vous pouvez ouvrir un ticket de support avec l’équipe de l’API des enregistrements d’appel.

Pourquoi les versions suivantes de mon enregistrement d’appel sont-elles retardées ?

Les versions ultérieures d’un enregistrement d’appel peuvent être remises après la latence initiale de 60 minutes. Cela signifie que même si la première version est disponible dans les 60 minutes, les mises à jour ultérieures de l’enregistrement d’appel peuvent arriver plus tard en raison de données de télémétrie retardées du client et d’autres facteurs.

Pourquoi un enregistrement d’appel contient-il des champs manquants ?

Un enregistrement d’appel peut avoir des champs manquants en raison de données de télémétrie retardées d’un client. Lorsque de nouvelles données de télémétrie deviennent disponibles, le système génère un nouvel enregistrement d’appel avec des informations mises à jour, incrémente la valeur de propriété version et vous envoie l’enregistrement d’appel mis à jour. Si les propriétés de votre enregistrement d’appel sont manquantes, attendez la version suivante de l’enregistrement d’appel.

Toutefois, il est important de noter que certains champs peuvent rester vides par conception ou parce que les données de télémétrie du client ne sont jamais arrivées, telles que les valeurs de flux multimédia.

Si des champs critiques ou précédemment remis sont manquants, ouvrez un ticket de support avec l’équipe de l’API des enregistrements d’appel.

Comment puis-je répertorier tous les participants qui ont participé à un appel ?

Vous pouvez utiliser les méthodes suivantes pour répertorier tous les participants à l’appel :

  1. LISTEr l’API participants_v2

    Utilisez l’API List participants_v2 pour collecter la liste complète des participants pour un ID d’appel demandé.

  2. Utilisez le paramètre de requête OData $expand sur l’objet callRecords pour développer la propriété participants_v2

    Vous pouvez appeler GET communications/callRecords/{id}?$expand=participants_v2 pour récupérer les détails généraux de l’appel ainsi que la liste des participants.

  3. Créer une liste de participants personnalisée

    Pour voir tous les participants, implémentez une solution personnalisée pour créer la liste des participants à partir des données des enregistrements d’appel :

    1. Appelez l’API Get callRecord et développez la sessions propriété : GET /communications/callRecords/{id}?$expand=sessions.
    2. Pour les appels P2P (peer-to-peer), lisez les caller propriétés et callee de chacune session d’elles dans la liste des reçus sessions . Pour les appels de réunion, lisez uniquement la caller propriété .
    3. Créez votre liste de participants personnalisée en fonction de l’identité du caller point de terminaison. Pour les appels P2P, incluez également l’identité du callee point de terminaison. Collectez les idpropriétés , displayNameet autres dont vous avez besoin pour chaque participant.

Pourquoi ne vois-je pas tous les participants qui ont assisté à un appel tout en appelant liste participants_v2 API ?

Vous ne voyez peut-être pas tous les participants, car l’API List participants_v2 prend en charge la pagination, ce qui limite le nombre de participants dans la réponse à 130 par page. Si l’appel comptait plus de 130 utilisateurs, la première réponse d’enregistrement d’appel contient 130 participants ainsi qu’une @odata.nextLink propriété. Cette propriété inclut l’URL permettant d’appeler l’API et de recevoir l’ensemble de participants suivant. Poursuivez ce processus jusqu’à ce que le lien suivant soit vide, ce qui indique qu’il n’y a plus de participants à récupérer.

Pourquoi des sessions en double sont-elles retournées pour un enregistrement d’appel ?

Une session d’enregistrement d’appel représente de manière unique une communication utilisateur-utilisateur unique dans les appels pair à pair ou une communication utilisateur-service unique dans un appel de groupe ou une réunion. Toutefois, dans certains scénarios d’appel, une communication utilisateur-service unique peut impliquer plusieurs identités de service dans une même session, comme un transfert virtuel entre un standard automatique et une file d’attente d’appels. Dans ces scénarios, un ID de session peut être dupliqué une ou plusieurs fois afin de représenter correctement chaque identité impliquée dans la communication et la durée de communication respective.

Pourquoi est-ce que je reçois une erreur 404 Introuvable ?

Voici quelques raisons pour lesquelles vous pouvez rencontrer une 404 Not Found erreur :

  • Appel récent : si l’appel a été effectué au cours des 60 dernières minutes, l’enregistrement de l’appel n’est peut-être pas encore généré. Patientez 60 minutes après la fin de l’appel, puis réessayez.
  • Ancien appel : si l’appel date de plus de 30 jours, l’API d’enregistrements d’appel retourne une 404 Not Found erreur par défaut.
  • Autres problèmes : si aucune des raisons ne s’applique, case activée pour les pannes signalées par l’équipe d’API d’enregistrements d’appel dans l’onglet Intégrité du portail Administration Teams. En outre, vous pouvez ouvrir un ticket de support avec l’équipe de l’API des enregistrements d’appels pour obtenir de l’aide.