Registrieren eines anrufenden bot für Microsoft TeamsRegister a calling bot for Microsoft Teams

Ein bot, der an Audio/Video-anrufen und Onlinebesprechungen teilnimmt, ist ein gewöhnlicher Microsoft Teams-bot mit einigen zusätzlichen Features:A bot that participates in audio/video calls and online meetings is an ordinary Microsoft Teams bot with a few extra features:

  • Es gibt eine neue Version des Teams-App-Manifests mit zwei zusätzlichen Einstellungen supportsCalling und supportsVideo .There's a new version of the Teams app manifest with two additional settings, supportsCalling and supportsVideo. Diese Einstellungen sind in der Entwicklervorschau -Version des Microsoft Teams-App-Manifests enthalten.These settings are included in the Developer Preview version of the Microsoft Teams app manifest.
  • Microsoft Graph-Berechtigungen müssen für die Microsoft-App-ID Ihres bot konfiguriert werden.Microsoft Graph permissions must be configured for your bot's Microsoft App ID.
  • Die Berechtigungen für Microsoft Graph-und Online Besprechungs-APIs erfordern mandantenadministrator Zustimmung.The Microsoft Graph calls and online meetings APIs permissions require tenant admin consent.

Lassen Sie uns das oben beschriebene näher erläutern.Let's discuss the above in more detail.

Neue manifesteinstellungenNew manifest settings

Bots für Anrufe und Onlinebesprechungen weisen zwei zusätzliche Einstellungen im manifest.jsauf, die Audio/Video für Ihren bot in Microsoft Teams aktivieren.Calling and online meetings bots have two additional settings in the manifest.json that enable audio/video for your bot in Teams.

  • bots[0].supportsCalling.bots[0].supportsCalling. Wenn diese Option vorhanden und auf festgelegt true ist, können Teams ihren bot an anrufen und Onlinebesprechungen teilnehmen.If present and set to true, Teams will allow your bot to participate in calls and online meetings.
  • bots[0].supportsVideo.bots[0].supportsVideo. Wenn es vorhanden und auf festgelegt true ist, wissen Teams, dass Ihr bot Video unterstützt.If present and set to true, Teams knows that your bot supports video.

Wenn Sie möchten, dass die IDE die manifest.jsdes Schemas für Ihren anrufenden und Besprechungs-bot für diese Werte ordnungsgemäß überprüft, können Sie das $schema Attribut wie folgt ändern:If you want your IDE to properly validate the manifest.json schema for your calling and meeting bot for these values, you can change the $schema attribute as follows:

"$schema": "https://raw.githubusercontent.com/OfficeDev/microsoft-teams-app-schema/preview/DevPreview/MicrosoftTeams.schema.json",

Erstellen eines neuen bot oder Hinzufügen von Anruffunktionen zu einem vorhandenen botCreating a new bot or adding calling capabilities to an existing bot

Das Erstellen eines neuen bot wird im Thema Erstellen eines bot für Microsoft Teams ausführlicher behandelt, aber wir werden hier einiges wiederholen:Creating a new bot is covered in more detail in the Create a bot for Microsoft Teams topic, but we'll repeat some of it here:

  1. Verwenden Sie diesen Link, um einen neuen bot zu erstellen: https://dev.botframework.com/bots/new .Use this link to create a new bot: https://dev.botframework.com/bots/new. Wenn Sie stattdessen die Schaltfläche " bot erstellen " im bot-Framework-Portal auswählen, erstellen Sie Ihren bot in Microsoft Azure, für die Sie ein Azure-Konto benötigen.If, instead, you select the Create a bot button in the Bot Framework portal, you will create your bot in Microsoft Azure, for which you'll need an Azure account.
  2. Fügen Sie den Microsoft Teams-Kanal hinzu.Add the Microsoft Teams channel. Klicken Sie auf der Microsoft Teams-Kanalseite auf die Registerkarte "anrufen", und wählen Sie Anruf aktivierenaus, und aktualisieren Sie dann webhook (zum Aufrufen) mit ihrer HTTPS-URL, über die Sie eingehende Benachrichtigungen erhalten, Beispiels https://contoso.com/teamsapp/api/calling Weise.Click on the "Calling" tab on the Microsoft Teams channel page and select Enable calling, and then update Webhook (for calling) with your HTTPS URL where you will receive incoming notifications, e.g.https://contoso.com/teamsapp/api/calling. Weitere Informationen zum Konfigurieren von Kanälen erhalten Sie unter Configuring Channels .Refer to Configuring Channels for more information on how to configure channels. Konfigurieren von Microsoft Teams-KanalinformationenConfigure Microsoft Teams channel information

Hinzufügen von Microsoft Graph-BerechtigungenAdd Microsoft Graph permissions

Microsoft Graph macht granulare Berechtigungen verfügbar, die den Zugriff steuern, den apps auf Ressourcen haben.Microsoft Graph exposes granular permissions controlling the access that apps have to resources. Als Entwickler entscheiden Sie, welche Berechtigungen für Microsoft Graph Ihre App anfordert.As a developer, you decide which permissions for Microsoft Graph your app requests. Die Microsoft Graph-Aufruf-APIs unterstützen Anwendungsberechtigungen, die von apps verwendet werden, die ohne angemeldeten Benutzer ausgeführt werden.The Microsoft Graph Calling APIs support Application permissions, which are used by apps that run without a signed-in user present. Ein mandantenadministrator muss die Zustimmung zu den Anwendungsberechtigungen erteilen.A tenant administrator must grant consent to application permissions. Im folgenden finden Sie eine Liste dieser Berechtigungen:Below is a list of those permissions:

Anwendungsberechtigungen: AnrufeApplication permissions: calls

BerechtigungPermission AnzeigezeichenfolgeDisplay String BeschreibungDescription Administratorzustimmung erforderlichAdmin Consent Required
Calls.Initiate.AllCalls.Initiate.All Ausgehende 1:1-Anrufe aus der App initiieren (Vorschau)Initiate outgoing 1:1 calls from the app (preview) Ermöglicht der App, ausgehende Anrufe an einen einzelnen Benutzer zu tätigen und Anrufe an Benutzer im Organisationsverzeichnis zu übertragen (ohne angemeldeten Benutzer).Allows the app to place outbound calls to a single user and transfer calls to users in your organization’s directory, without a signed-in user. JaYes
Calls.InitiateGroupCall.AllCalls.InitiateGroupCall.All Ausgehende Gruppenanrufe aus der App initiieren (Vorschau)Initiate outgoing group calls from the app (preview) Ermöglicht der App, ausgehende Anrufe an mehrere Benutzer zu tätigen und Teilnehmer in Ihrer Organisation zu Besprechungen hinzufügen (ohne angemeldeten Benutzer).Allows the app to place outbound calls to multiple users and add participants to meetings in your organization, without a signed-in user. JaYes
Calls.JoinGroupCall.AllCalls.JoinGroupCall.All Gruppenanrufe und Besprechungen als App verknüpfen (Vorschau)Join Group Calls and Meetings as an app (preview) Ermöglicht der App, Gruppenanrufe und geplante Besprechungen in Ihrer Organisation ohne einen angemeldeten Benutzer zu verknüpfen.Allows the app to join group calls and scheduled meetings in your organization, without a signed-in user. Die App wird mit den Berechtigungen eines Verzeichnisbenutzers und Besprechungen in Ihrem Mandanten verknüpft.The app will be joined with the privileges of a directory user to meetings in your tenant. JaYes
Calls.JoinGroupCallasGuest.AllCalls.JoinGroupCallasGuest.All Verknüpfen von Gruppenanrufen und Besprechungen als Gast (Vorschau)Join Group Calls and Meetings as a guest (preview) Ermöglicht der App, Gruppenanrufe und geplante Besprechungen in Ihrer Organisation ohne einen angemeldeten Benutzer anonym zu verknüpfen.Allows the app to anonymously join group calls and scheduled meetings in your organization, without a signed-in user. Die App wird als Gast mit Besprechungen in Ihrem Mandanten verknüpft.The app will be joined as a guest to meetings in your tenant. JaYes
Calls. AccessMedia. all siehe untenCalls.AccessMedia.All see below Auf Medienstreams in einem Anruf als App zugreifen (Vorschau)Access media streams in a call as an app (preview) Ermöglicht der App, direkten Zugriff auf Medienstreams in einem Anruf ohne einen angemeldeten Benutzer zu erhalten.Allows the app to get direct access to media streams in a call, without a signed-in user. JaYes

Wichtig

Sie können die Microsoft. Graph. Calls. Media-API nicht verwenden, um Medieninhalte aus anrufen oder Besprechungen, auf die ihr bot zugreift, aufzuzeichnen oder anderweitig beizubehalten.You cannot use the Microsoft.Graph.Calls.Media API to record or otherwise persist media content from calls or meetings that your bot accesses.

Anwendungsberechtigungen: OnlinebesprechungenApplication permissions: online meetings

BerechtigungPermission AnzeigezeichenfolgeDisplay String BeschreibungDescription Administratorzustimmung erforderlichAdmin Consent Required
OnlineMeetings.Read.AllOnlineMeetings.Read.All Lesen von Onlinebesprechungsdetails aus der App (Vorschau)Read Online Meeting details from the app (preview) Ermöglicht der App, Onlinebesprechungsdetails in Ihrer Organisation ohne einen angemeldeten Benutzer zu lesen.Allows the app to read Online Meeting details in your organization, without a signed-in user. JaYes
OnlineMeetings.ReadWrite.AllOnlineMeetings.ReadWrite.All Lesen und Erstellen von Onlinebesprechungen aus der App (Vorschau) im Namen eines BenutzersRead and Create Online Meetings from the app (preview) on behalf of a user Ermöglicht der App, Onlinebesprechungen in Ihrer Organisation im Namen eines Benutzers ohne einen angemeldeten Benutzer zu lesen.Allows the app to create Online Meetings in your organization on behalf of a user, without a signed-in user. JaYes

Zuweisen von BerechtigungenAssigning permissions

Sie müssen die Anwendungsberechtigungen für Ihren bot im Voraus konfigurieren.You must configure the application permissions for your bot in advance. Wir empfehlen die Verwendung des Microsoft-App-Registrierungs Portals , wie hier beschrieben, da Ihr bot konfiguriert wurde; Sie können jedoch weiterhin das Azure- Portal verwenden, wenn Sie den Azure AD v1-Endpunktverwenden möchten.We recommend using the Microsoft App Registration Portal as described here because that's where your bot was configured; however, you can still use the Azure portal if you prefer to use the Azure AD V1 endpoint.

Für apps, die den Azure AD v1-Endpunkt verwenden, kann ein mandantenadministrator die Berechtigungen der Anwendung mithilfe des Azure-Portals einwilligen, wenn Ihre APP in Ihrer Organisation installiert ist, oder Sie können eine Anmelde Erfahrung in Ihrer APP bereitstellen, über die Administratoren den von Ihnen konfigurierten Berechtigungen zustimmen können.For apps using the Azure AD V1 endpoint, a tenant administrator can consent to the application permissions using the Azure portal when your app is installed in their organization, or you can provide a sign-up experience in your app through which administrators can consent to the permissions you configured. Sobald die Zustimmung des Administrators von Azure AD aufgezeichnet wurde, kann Ihre APP Token anfordern, ohne erneut eine Zustimmung anfordern zu müssen.Once administrator consent is recorded by Azure AD, your app can request tokens without having to request consent again.

Sie können sich darauf verlassen, dass ein Administrator die Berechtigungen, die Ihre APP benötigt, im Azure-Portalerteilt. häufig ist es jedoch besser, eine Anmelde Erfahrung für Administratoren mithilfe des Azure AD v2- /adminconsent Endpunkts bereitzustellen.You can rely on an administrator to grant the permissions your app needs at the Azure portal; though, often a better option is to provide a sign-up experience for administrators by using the Azure AD V2 /adminconsent endpoint. Weitere Informationen finden Sie in den Anweisungen zum Erstellen einer URL für die Administrator Zustimmung .Please refer to the instructions on constructing an Admin Consent URL for more information.

Hinweis

Zum Erstellen der Zustimmungs-URL des Mandanten Administrators ist eine konfigurierte Umleitungs-URI/Antwort-URL im App-Registrierungs Portalerforderlich.Constructing the Tenant Admin Consent URL requires a configured Redirect URI/Reply URL in the App Registration Portal. Wenn Sie Antwort-URLs für Ihren bot hinzufügen möchten, greifen Sie auf Ihre bot-Registrierung zu, wählen Sie erweiterte Optionen – > Anwendungs Manifest bearbeiten.To add reply URLs for your bot, access your bot registration, choose Advanced Options -> Edit Application Manifest. Fügen Sie der Auflistung ihre Umleitungs-URL hinzu replyUrls .Add your Redirect URL to the replyUrls collection.

Wichtig

Wenn Sie eine Änderung an den Berechtigungen Ihrer Anwendung vornehmen, müssen Sie auch den Administrator Zustimmungsprozess wiederholen.Anytime you make a change to your application's permissions, you must also repeat the Admin Consent process. Im App-Registrierungsportal vorgenommene Änderungen werden nicht wiedergegeben, bis die Zustimmung des Mandantenadministrators erneut erteilt wurde.Changes made in the app registration portal will not be reflected until consent has been reapplied by the tenant's administrator.