Utilisation de l’API de communication cloud dans Microsoft Graph
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, ainsi que pour créer et récupérer des coordonnées de réunion.
Vous pouvez utiliser l’API de communication 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 pour le compte des utilisateurs. 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 |
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 |
| Récupération des enregistrements d’appels | callRecord | Abonnements webhook |
| Présence | présence |
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 |
| callRecord | propriétés callRecord |
| présence | présence |