Arbeiten mit den Anrufdelegierungs-APIs in Microsoft Graph (Vorschau)

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.

Erfahren Sie, wie Sie die Anrufdelegierungs-APIs verwenden können, um Kommunikationsworkflows in benutzerdefinierten Anwendungen zu optimieren. Diese APIs ermöglichen das Abfragen und Verwalten von Delegaten und Delegatoren, um gemeinsame Anrufszenarien zu verbessern, z. B. das Erscheinungsbild gemeinsam genutzter Leitungen und Proxyanrufe.

Voraussetzungen

Für den Zugriff auf diese APIs sind die folgenden Konfigurationen erforderlich:

  • Berechtigungen: Weisen Sie Ihrer Anwendung delegierte Bereiche für den Zugriff zu. Verwenden Sie die folgende URL, um sich mit einem Administratorkonto anzumelden und Berechtigungen zuzuweisen:

    https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id={Client-App-ID}&response_type=code&scope=https://graph.microsoft.com/CallDelegation.Read
    
  • Richtlinien: Weisen Sie die Richtlinie in Microsoft Teams mithilfe von AllowDelegationPowerShell zu:

    Set-CsTeamsCallingPolicy -AllowDelegation $true
    

Einführung in die Teams-Delegation

Die Microsoft Teams-Delegierung ermöglicht es Benutzern, die Anrufverantwortung zu teilen, indem sie Stellvertretungen zuweisen. Stellvertretungen können Aktionen wie das Annehmen von Anrufen, das Tätigen von Anrufen im Namen anderer und das Verwalten von Anrufeinstellungen ausführen. Dieses Feature ist in Szenarien nützlich, in denen ein Assistent oder ein Teammitglied die Kommunikation für einen anderen Benutzer übernimmt.

Microsoft Graph ermöglicht Entwicklern die programmgesteuerte Verwaltung von Delegatoren und Delegaten. Zu den gängigen Szenarien gehören:

  • Einrichten von Darstellungen gemeinsam genutzter Linien.
  • Verwalten von Berechtigungen für ein- und ausgehende Anrufe.
  • Optimierung der Kommunikationsworkflows innerhalb von Teams.

Wer ist ein Delegator?

Ein Delegator ist ein Benutzer, der einem anderen Benutzer (Delegaten) die Möglichkeit gibt, bestimmte Aktionen in seinem Namen auszuführen. Diese Aktionen können das Tätigen und Annehmen von Anrufen, das Verwalten von Anrufeinstellungen oder das Teilnehmen an aktiven Anrufen umfassen. Delegatoren sind in der Regel Benutzer, die Unterstützung bei der Bewältigung ihrer Kommunikationsaufgaben benötigen.

Wer ist ein Stellvertreter?

Ein Delegat ist ein Benutzer, dem von einem Delegator Verantwortlichkeiten zugewiesen werden. Delegaten können bestimmte Aktionen wie das Annehmen von Anrufen, das Initiieren von Anrufen und das Verwalten von Anrufeinstellungen im Namen des Delegators ausführen. Diese Rolle wird häufig von Assistenten oder Teammitgliedern verwendet, um nahtlose Kommunikationsworkflows zu ermöglichen.

Allgemeine Anwendungsfälle

Vorgang Rückgabetyp Beschreibung
Alle Delegaten auflisten delegationSettings-Sammlung Rufen Sie eine Liste aller Stellvertretungen für einen Benutzer ab.
Delegat nach ID abrufen delegationSettings Abrufen von Details zu einem bestimmten Stellvertreter.
Auflisten aller Delegatoren delegationSettings-Sammlung Rufen Sie eine Liste aller Delegatoren für einen Benutzer ab.
Delegator nach ID abrufen delegationSettings Abrufen von Details zu einem bestimmten Delegator.

Nächste Schritte

Verwenden Sie die Anrufdelegierungs-API in Microsoft Graph, um Stellvertretungen und Delegatoren in Teams abzufragen und zu verwalten. So erhalten Sie weitere Informationen:

  • Erfahren Sie, welche Ressourcen und Methoden für Ihr Szenario am besten geeignet sind.
  • Probieren Sie die API im Graph-Tester aus.