Arbeiten mit der Cloudkommunikations-API in Microsoft Graph

  • Artikel

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
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
Anrufdatensätze CallRecords.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
Anwesenheit Anwesenheit Methoden für Anwesenheit
Abrufen von Anrufdatensätzen callRecord Webhook-Abonnements

Allgemeine Eigenschaften

Ressource Eigenschaften
call call-Eigenschaften
participant participant-Eigenschaften
onlineMeeting onlineMeeting-Eigenschaften
Anwesenheit Anwesenheitseigenschaften
callRecord callRecord-Eigenschaften

Verwandte Inhalte