Arbeiten mit der Cloudkommunikations-API in Microsoft Graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
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, Besprechungskoordinaten erstellen und abrufen sowie die Anwesenheitsinformationen der Benutzer überprüfen.
Sie können die Cloud-Kommunikations-API verwenden, um Serviceanwendungen (Bots) zu erstellen, die sich wie Teilnehmer eines Anrufs verhalten und im Namen von Benutzern Besprechungen erstellen und abrufen sowie deren Verfügbarkeit und Aktivität überprüfen. 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 |
| Anwesenheit | Presence.Read, Presence.Read.All |
| Virtuelles Ereignis | VirtualEvent.Read, VirtualEvent.ReadWrite |
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) | participant | |
| Besprechungen | onlineMeeting | Methoden für Besprechungen |
| Anwesenheit | Anwesenheit | Methoden für Anwesenheit |
| Abrufen von Anrufdatensätzen | callRecord | Webhook-Abonnements |
| Virtuelle Ereignisse | virtualEvent | Methoden für virtualEventTownhall, Methoden für virtualEventWebinar |
Allgemeine Eigenschaften
| Ressource | Eigenschaften |
|---|---|
| call | call-Eigenschaften |
| participant | participant-Eigenschaften |
| onlineMeeting | onlineMeeting-Eigenschaften |
| Anwesenheit | Anwesenheitseigenschaften |
| callRecord | callRecord-Eigenschaften |