Partager via


Utilisation de l’API de communication cloud dans Microsoft Graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

L’API de communication cloud Microsoft Graph ajoute une nouvelle dimension à la façon dont vous ou votre organisation pouvez interagir avec d’autres utilisateurs en activant les fonctionnalités de communication de base dans vos applications et services. Vous pouvez utiliser cette API pour passer et recevoir des appels, créer et récupérer des coordonnées de réunion, et vérifier la présence des utilisateurs.

Vous pouvez utiliser l’API de communication dans le cloud pour créer des applications de service (bots) qui agissent comme des participants à un appel et qui créent et récupèrent des réunions au nom des utilisateurs. Vous pouvez également utiliser cette api pour vérifier leur présence, leur disponibilité et leur activité. Cette API offre des fonctionnalités d’appel, ainsi que la possibilité de créer et de récupérer des réunions en ligne. Vous pouvez utiliser les applications de service (bots) avec cette API, où le bot peut agir comme un participant à vos appels VoIP ou réunions Microsoft Teams, par exemple.

Importante

Vous ne pouvez PAS utiliser les API de communications cloud pour enregistrer ou conserver du contenu multimédia à partir d’appels ou de réunions auxquels votre application accède, ou de données dérivées de ce contenu multimédia. S’assurer que vous respectez les lois et réglementations de votre région en matière de protection des données et de confidentialité des communications. Pour plus d’informations, consultez les Conditions d’utilisation et contactez votre conseiller juridique.

Autorisation

L’une des autorisations suivantes est requise pour accéder à l’API de communication cloud. Ces autorisations doivent être accordées par l’administrateur.

Scénario Autorisations
Enregistrements d’appels CallRecords.Read.All
Appel Calls.JoinGroupCallAsGuest.All, Calls.JoinGroupCall.All, Calls.Initiate.All, Calls.InitiateGroupCall.All, Calls.AccessMedia.All
Réunions OnlineMeetings.ReadWrite.All, OnlineMeetings.Read.All
Présence Presence.Read, Presence.Read.All
Événement virtuel VirtualEvent.Read, VirtualEvent.ReadWrite

Cas d’utilisation courants

Le tableau suivant répertorie certaines des utilisations courantes de l’API de communication cloud.

Cas d’utilisation Ressources REST Voir aussi
Création d’appels de groupe et entre 2 participants, et participation à ceux-ci Appel Méthodes pour les appels
Appels avec réponse vocale interactive Appel Méthodes pour les réponses vocales interactives
Contrôles d’appel (participant) participant
Réunions onlineMeeting Méthodes pour des réunions
Présence présence Méthodes de présence
Récupération des enregistrements d’appels callRecord Abonnements webhook
Événements virtuels virtualEvent Méthodes pour virtualEventTownhall, Méthodes pour virtualEventWebinar

Propriétés courantes

Ressource Propriétés
appeler propriétés d’appel
participant propriétés du participant
onlineMeeting propriétés onlineMeeting
présence propriétés de présence
callRecord propriétés callRecord