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 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