Arbeiten mit der Cloudkommunikations-API in Microsoft Graph
Die Microsoft Graph Cloudkommunikations-API fügt der Art und Weise, wie Sie oder Ihr Unternehmen mit anderen Benutzer*innen interagieren können, eine neue Dimension hinzu, indem sie zentrale Kommunikationsfunktionen und Features in Ihren Apps und Diensten ermöglicht. Mit dieser API können Sie Anrufe tätigen und empfangen sowie Besprechungskoordinaten erstellen und abrufen.
Sie können die Cloudkommunikations-API verwenden, um Serviceanwendungen (Bots) zu erstellen, die sich wie Teilnehmende an einem Anruf verhalten und Besprechungen im Namen von Benutzer*innen erstellen und abrufen. Diese API bietet Anruffunktionen sowie die Möglichkeit, Onlinebesprechungen zu erstellen und abzurufen. Sie können Dienstanwendungen (Bots) mit dieser API verwenden, und der Bot kann beispielsweise als Teilnehmer Ihrer VoIP-Anrufe fungieren oder an Besprechungen in Microsoft Teams teilnehmen.
Wichtig
Sie dürfen die Cloudkommunikations-APIs NICHT verwenden, um Medieninhalte von Anrufen oder Besprechungen, auf die Ihre Anwendung zugreift, oder daten, die von diesen Medieninhalten abgeleitet wurden, aufzuzeichnen oder anderweitig beizubehalten. Stellen Sie sicher, dass alle für Ihren Bereich geltenden Gesetze und Bestimmungen hinsichtlich Datenschutz und Vertraulichkeit von Kommunikationen eingehalten werden. Bitte lesen Sie die Nutzungsbedingungen, und wenden Sie sich für weitere Informationen an Ihren Rechtsbeistand.
Autorisierung
Eine der folgenden Berechtigungen ist für den Zugriff auf die Cloudkommunikations-API erforderlich. Diese Berechtigungen müssen vom Administrator erteilt werden.
| Szenario | Berechtigungen |
|---|---|
| Anrufdatensätze | CallRecords.Read.All |
| Anrufe | Calls.JoinGroupCallAsGuest.All, Calls.JoinGroupCall.All, Calls.Initiate.All, Calls.InitiateGroupCall.All, Calls.AccessMedia.All |
| Besprechungen | OnlineMeetings.ReadWrite.All, OnlineMeetings.Read.All |
| Anwesenheiten | Presence.Read, Presence.Read.All |
Allgemeine Anwendungsfälle
In der folgenden Tabelle finden Sie einige der häufigsten Verwendungszwecke für die Cloudkommunikations-API.
| Anwendungsfälle | REST-Ressourcen | Siehe auch |
|---|---|---|
| Erstellen und Verknüpfen von 1:1- und Gruppenanrufen | call | Methoden für Anrufe |
| IVR-Anrufe | call | Methoden für IVR |
| Anrufsteuerelemente (Teilnehmer) | Teilnehmer | |
| Besprechungen | onlineMeeting | Methoden für Besprechungen |
| Abrufen von Anrufdatensätzen | callRecord | Webhook-Abonnements |
| Anwesenheiten | Anwesenheit |
Allgemeine Eigenschaften
| Ressource | Eigenschaften |
|---|---|
| call | call-Eigenschaften |
| participant | participant-Eigenschaften |
| onlineMeeting | onlineMeeting-Eigenschaften |
| callRecord | callRecord-Eigenschaften |
| Anwesenheit | Anwesenheit |