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 |