Microsoft Teams-Teamschaltung

In diesem Artikel wird beschrieben, wie Sie die Microsoft Teams-Teamschaltung (Shared Line Appearance) in Azure Communication Services implementieren. Die Teamschaltung ermöglicht es den Benutzenden, eine Stellvertretung auszuwählen, um Anrufe in ihrem Namen zu tätigen oder zu empfangen. Dieses Feature ist hilfreich, wenn Benutzende Verwaltungsassistenten haben, die regelmäßig Anrufe der Benutzenden bearbeiten.

Im Kontext der Teamschaltung handelt es sich bei managenden Personen um Teams-Benutzende, die eine Stellvertretung autorisieren, Anrufe in ihrem Namen zu tätigen oder zu empfangen. Stellvertretungen sind Microsoft 365-Benutzende, die Anrufe im Auftrag der delegierenden Personen tätigen oder empfangen können. Weitere Informationen finden Sie unter Teilen der Leitung.

Voraussetzungen

Support

SDKs

Die folgende Tabelle zeigt die Unterstützung für das Feature "Gemeinsame Leitungsdarstellung" in einzelnen Azure Communication Services-SDKs.

Status der Unterstützung das Internet Web-Benutzeroberfläche Ios iOS-Benutzeroberfläche Android Android-Benutzeroberfläche Fenster
Unterstützt ✔️

Hinweis

Dieses API-Feature ist mit dem Azure Communication Services Calling Web SDK (1.35.1 oder höher) verfügbar.

Installieren des SDKs

Verwenden Sie den Befehl npm install, um das Azure Communication Services Calling SDK sowie allgemeine SDKs für JavaScript zu installieren.

npm install @azure/communication-common --save
npm install @azure/communication-calling --save

Initialisieren erforderlicher Objekte

Erstellen Sie eine CallClient-Instanz, um den Anrufstapel zu initiieren. Sie können die Protokollierung der SDK-Aufrufe mit der AzureLogger-Instanz und der setLogLevel-Methode konfigurieren. Zugriff auf den deviceManager für das Betriebssystem erhalten Sie über die Methode getDeviceManager.

Verwenden Sie dann die Methode createTeamsCallAgent, um asynchron eine TeamsCallAgent-Instanz zu erstellen, die eingehende und ausgehende Anrufe für einen Teams-Benutzer verwaltet. Die Methode akzeptiert CommunicationTokenCredential als Argument, das Zugriffstoken für Teams-Benutzer darstellt.

const { CallClient } = require('@azure/communication-calling');
const { AzureCommunicationTokenCredential} = require('@azure/communication-common');
const { AzureLogger, setLogLevel } = require("@azure/logger");

// Set the logger's log level
setLogLevel('verbose');

// Redirect log output to wherever desired. To console, file, buffer, REST API, etc...
AzureLogger.log = (...args) => {
    console.log(...args); // Redirect log output to console
};

const userToken = '<USER_TOKEN>';
callClient = new CallClient();
const tokenCredential = new AzureCommunicationTokenCredential(userToken);
const teamsCallAgent = await callClient.createTeamsCallAgent(tokenCredential);
const deviceManager = await callClient.getDeviceManager();

Tätigen eines Anrufs im Namen von Microsoft Teams-Benutzenden

Stellen Sie vor einem Anruf im Namen einer delegierenden Person sicher, dass die Stellvertretung, die den Anruf tätigt, über die make calls-Berechtigung über die Anrufeinstellungen für delegierende Personen in Microsoft Teams verfügt.

Geben Sie während des Startanrufs OnBehalfOfOptions an, um einen Anruf im Namen von Microsoft Teams-Benutzenden zu tätigen. Ersetzen Sie xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx durch die „userId“ der delegierenden Person und yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy durch die „userId“ der angerufenen Person.

const onBehalfOfOptions = { userId: { microsoftTeamsUserId: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" } }
const teamsCallOptions = { onBehalfOfOptions: onBehalfOfOptions };
const call = teamsCallAgent.startCall([{ microsoftTeamsUserId: "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy" }], teamsCallOptions);

Wenn Sie einen Anruf an einen PstN-Benutzer (Pubic Switched Telephone Network) im Namen eines Microsoft Teams-Teilnehmers tätigen möchten, verwenden Sie dies PhoneNumberIdentifier für Anrufteilnehmer.

const call = teamsCallAgent.startCall([{ phoneNumber: "+1xxxxxxxxxx" }], teamsCallOptions);

Empfangen eines Anrufs im Namen von Microsoft Teams-Benutzenden

So empfangen Sie Anrufe im Auftrag eines Delegators:

Nächste Schritte

  • Last updated on