Teams-Anruf- und Besprechungsbot
Der Anruf- und Besprechungsbot von Microsoft Teams bietet grundlegende Funktionen wie das Erstellen eines Anrufs, die Teilnahme an einem Anruf, das Weiterleiten oder Umleiten eines Anrufs, die Teilnahme an einer geplanten Besprechung und das Einladen der Teilnehmer durch integration der Cloudkommunikation Graph-API.
Bots können mithilfe von Sprach-, Video- und Bildschirmfreigabe in Echtzeit mit Teams-Anrufen und -Besprechungen interagieren. Teams-Apps können mithilfe von Sprach- und Videofunktionen mit Benutzern interagieren, um deren Erfahrung mit Microsoft Graph-APIs für Anrufe und Onlinebesprechungen zu verbessern. Mit diesen APIs können Sie die folgenden neuen Features hinzufügen:
- Verwenden Sie Interactive Voice Response (IVR).
- Verwenden Sie die Anrufsteuerung.
- Bieten Sie Zugriff auf Echtzeit-Audio- und Videostreams, einschließlich Desktop- und App-Freigabe.
Erstellen Sie einen Bot, und geben Sie zusätzliche Informationen und Berechtigungen für die Verwendung dieser Graph-APIs in einer Teams-App an.
Diese Schritt-für-Schritt-Anleitung hilft Ihnen beim Einrichten eines Teams-Anruf- und Besprechungsbots. Die folgende Ausgabe wird angezeigt:
Voraussetzungen
Stellen Sie sicher, dass Sie die folgenden Tools installieren und Ihre Entwicklungsumgebung einrichten:
| Installieren | Zum Benutzen... | |
|---|---|---|
| Microsoft 365-Entwicklerkonto | Zugriff auf das Teams-Konto mit den entsprechenden Berechtigungen zum Installieren einer App. | |
| Visual Studio 2022 | Sie können die Unternehmensversion in Visual Studio 2022 und die Workloads ASP.NET und Webentwicklung installieren. Verwenden Sie die neueste Version. | |
| .NET Core SDK | Angepasste Bindungen für lokales Debuggen und Azure Functions App-Bereitstellungen. Verwenden Sie die neueste Version, oder installieren Sie die portable Version. | |
| Microsoft Teams | Microsoft Teams für die Zusammenarbeit mit allen, mit denen Sie arbeiten, über Apps für Chats, Besprechungen und Anrufe an einem Ort. | |
| Windows PowerShell | Installieren Sie, indem Sie alle Befehle ausführen. | |
| Entwicklungstunnel | Teams-App-Features (Konversationsbots, Nachrichtenerweiterungen und eingehende Webhooks) erfordern eingehende Verbindungen. Ein Tunnel verbindet Ihr Entwicklungssystem mit Teams. Dev Tunnel ist ein leistungsstarkes Tool, um Ihren Localhost sicher für das Internet zu öffnen und zu steuern, wer Zugriff hat. Dev Tunnel ist in Visual Studio 2022 Version 17.7.0 oder höher verfügbar. Sie können auch ngrok als Tunnel verwenden, um Ihr Entwicklungssystem mit Teams zu verbinden. Dies ist nicht für Apps erforderlich, die nur Registerkarten enthalten. Dieses Paket wird im Projektverzeichnis installiert (mithilfe von npm devDependencies). |
Hinweis
Nachdem Sie ngrok heruntergeladen haben, registrieren Sie sich, und installieren Sie authtoken.
Einrichten einer lokalen Umgebung
Öffnen Sie Microsoft-Teams-Samples.
Wählen Sie Code aus.
Wählen Sie im Dropdownmenü Mit GitHub Desktop öffnen aus.
Wählen Sie Klonen aus.
Registrieren Microsoft Entra App
Führen Sie die folgenden Schritte aus, um eine Anwendung mithilfe des Microsoft-Azure-Portal für die Integration Ihrer App in die Microsoft Identity Platform zu registrieren und Microsoft Graph-API aufzurufen:
- Erstellen Sie einen ngrok-Tunnel zu den Endpunkten Ihres Webservers.
- Erstellen Einer Azure-Botressource zum Registrieren eines Bots beim Azure-Botdienst
- Erstellen Sie einen geheimen Clientschlüssel, der die SSO-Authentifizierung (Single Sign-On, einmaliges Anmelden) des Bots ermöglicht.
- Erstellen Sie eine Richtlinie für einen Demomandantenbenutzer zum Erstellen von Onlinebesprechungen mithilfe von PowerShell.
- Fügen Sie API-Berechtigungen für downstream-Aufrufe hinzu.
- Erstellen sie die Botkanalregistrierung im Azure-Konto.
- Fügen Sie den Microsoft Teams-Kanal hinzu, um den Bot in einem Teams-Kanal bereitzustellen.
- Fügen Sie dem erstellten ngrok-Tunnel einen Messagingendpunkt hinzu.
Hinzufügen der App-Registrierung
Navigieren Sie zum Azure-Portal.
Wählen Sie App-Registrierungen aus.
Wählen Sie + Neue Registrierung aus.
Geben Sie den Namen Ihrer App ein.
Wählen Sie Konten in einem beliebigen Organisationsverzeichnis (beliebiger Microsoft Entra ID Mandanten – mehrinstanzenfähig) aus.
Wählen Sie Registrieren aus.
Ihre App ist in Microsoft Entra ID registriert. Die App-Übersichtsseite wird angezeigt.
Hinweis
Speichern Sie die App-ID unter Anwendungs-ID (Client) und Verzeichnis-ID (Mandant) zur weiteren Verwendung.
Erstellen eines Tunnels
Öffnen Sie Visual Studio.
Wählen Sie Neues Projekt erstellen aus.
Geben Sie im Suchfeld ASP.NET ein. Wählen Sie in den Suchergebnissen ASP.NET Core-Web-App aus.
Wählen Sie Weiter aus.
Geben Sie Projektname ein , und wählen Sie Weiter aus.
Wählen Sie Erstellen aus.
Ein Übersichtsfenster wird angezeigt.
Wählen Sie in der Dropdownliste Debug die Option Dev Tunnels (kein aktiver Tunnel)>Tunnel erstellen... aus.
Ein Popupfenster wird geöffnet.
Aktualisieren Sie die folgenden Details im Popupfenster:
- Konto: Geben Sie ein Microsoft- oder GitHub-Konto ein.
- Name: Geben Sie einen Namen für Ihren Tunnel ein.
- Tunneltyp: Wählen Sie in der Dropdownliste die Option Temporär aus.
- Zugriff: Wählen Sie in der Dropdownliste Öffentlich aus.
Wählen Sie OK aus.
Ein Popupfenster wird angezeigt, in dem angezeigt wird, dass der Entwicklungstunnel erfolgreich erstellt wurde.
Wählen Sie OK aus.
Sie finden den tunnel, den Sie erstellt haben, in der Debug-Dropdownliste wie folgt:
Wählen Sie F5 aus, um die Anwendung im Debugmodus auszuführen.
Wenn ein Dialogfeld Sicherheitswarnung angezeigt wird, wählen Sie Ja aus.
Ein Popupfenster wird geöffnet.
Wählen Sie Weiter.
Die Dev Tunnel-Startseite wird in einem neuen Browserfenster geöffnet, und der Entwicklungstunnel ist jetzt aktiv.
Wechseln Sie zu Visual Studio, und wählen Sie Ausgabe anzeigen >aus.
Wählen Sie im Dropdownmenü Ausgabekonsoledie Option Dev Tunnels aus.
In der Ausgabekonsole wird die Dev Tunnel-URL angezeigt.
Hinzufügen einer Webauthentifizierung
Wählen Sie im linken Bereich unter Verwalten die Option Authentifizierung aus.
Wählen SiePlattformweb>hinzufügenaus.
Geben Sie den Umleitungs-URI für Ihre App ein, indem Sie an den vollqualifizierten Domänennamen anfügen
auth-end. Zum Beispielhttps://your-devtunnel-domain/auth-endoderhttps://your-ngrok-domain/auth-end.Aktivieren Sie unter Implizite Genehmigung und Hybridflows die Kontrollkästchen Zugriffstoken und ID-Token .
Wählen Sie Konfigurieren aus.
Wählen Sie unter Web die Option URI hinzufügen aus.
https://token.botframework.com/.auth/web/redirecteingeben.Klicken Sie auf Speichern.
Erstellen eines geheimen Clientschlüssels
Wählen Sie im linken Bereich unter Verwalten die Option Zertifikate & Geheimnisse aus.
Wählen Sie unter Geheime Clientschlüsseldie Option + Neuer geheimer Clientschlüssel aus.
Das Fenster Geheimen Clientschlüssel hinzufügen wird angezeigt.
Geben Sie Beschreibung ein.
Klicken Sie auf Hinzufügen.
Wählen Sie unter Wertdie Option In Zwischenablage kopieren aus, um den Wert des geheimen Clientschlüssels zur weiteren Verwendung zu speichern.
Hinzufügen von API-Berechtigungen für downstream-Aufrufe
Wählen Sie im linken Bereich unter Verwalten die Option API-Berechtigungen aus.
Wählen Sie + Berechtigung hinzufügen aus.
Wählen Sie Microsoft Graph aus.
Wählen Sie Anwendungsberechtigungen aus.
Wählen Sie die folgenden Berechtigungen aus:
Calls.AccessMedia.AllCalls.Initiate.AllCalls.InitiateGroupCall.AllCalls.JoinGroupCall.AllCalls.JoinGroupCallAsGuest.AllOnlineMeetings.ReadWrite.All
Wählen Sie Berechtigungen hinzufügen aus.
Hinweis
- Wenn einer App keine Zustimmung des IT-Administrators erteilt wird, müssen Benutzer bei der ersten Verwendung einer App ihre Zustimmung erteilen.
- Benutzer müssen den API-Berechtigungen nur zustimmen, wenn die Microsoft Entra App in einem anderen Mandanten registriert ist.
Hinzufügen eines Bereichs
Wählen Sie im linken Bereich unter Verwalten die Option API verfügbar machen aus.
Wählen Sie + Bereich hinzufügen aus.
Geben Sie access_as_user als Bereichsnamen ein.
Wählen Sie unter Wer kann zustimmen?die Option Administratoren und Benutzer aus.
Aktualisieren Sie die Werte für die restlichen Felder wie folgt:
Geben Sie teams can access the user's profile as Admin consent display name ein.
Geben Sie Erlaubt Teams das Aufrufen der Web-APIs der App als aktuellen Benutzer als Admin Einwilligungsbeschreibung ein.
Geben Sie Teams kann auf das Benutzerprofil zugreifen und Anforderungen im Namen des Benutzers als Anzeigename für die Benutzereinwilligung stellen ein.
Geben Sie Teams aktivieren ein, um die APIs dieser App mit den gleichen Rechten wie der Benutzer als Beschreibung der Benutzereinwilligung aufzurufen.
Stellen Sie sicher, Zustand auf Aktiviert festgelegt ist.
Klicken Sie auf Bereich hinzufügen.
Die folgende Abbildung zeigt die Felder und die Werte:
Hinweis
Der Bereichsname muss mit dem Anwendungs-ID-URI übereinstimmen, der
/access_as_useram Ende angefügt ist.
Hinzufügen einer Clientanwendung
Wählen Sie im linken Bereich unter Verwalten die Option API verfügbar machen aus.
Identifizieren Sie unter Autorisierte Clientanwendungen die Anwendungen, die Sie für die Webanwendung Ihrer App autorisieren möchten.
Wählen Sie + Clientanwendung hinzufügen aus.
Fügen Sie Teams mobile oder Desktop- und Teams-Webanwendung hinzu.
Für Teams Mobile oder Desktop: Geben Sie die Client-ID als ein
1fec8e78-bce4-4aaf-ab1b-5451cc387264.
Für Teams-Web: Geben Sie die Client-ID als ein
5e3ce6c0-2b1f-4285-8d4b-75ee78787346.
Aktivieren Sie das Kontrollkästchen Autorisierte Bereiche .
Wählen Sie Anwendung hinzufügen aus.
Die folgende Abbildung zeigt die Client-ID:
Richtlinie erstellen
Führen Sie die folgenden Schritte aus, um eine Richtlinie zu erstellen, die einem Demomandantenbenutzer das Erstellen von Onlinebesprechungen mithilfe eines PowerShell-Skripts ermöglicht:
Führen Sie Windows PowerShell PSI als Administrator aus, und führen Sie das Skript aus.
New-CsApplicationAccessPolicy -Identity "<<policy-identity/policy-name>>" -AppIds "<<azure-client-id>>" -Description "Policy-description" Grant-CsApplicationAccessPolicy -PolicyName "<<policy-identity/policy-name>>" -Identity "<<object-id-of-the-user-to-whom-policy-need-to-be-granted>>"Hinweis
Wenn Sie die Windows PowerShell PSI zum ersten Mal verwenden, führen Sie die folgenden Befehle aus:
- Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser
- Führen Sie Install-Module -Name MicrosoftTeams -Force -AllowClobber aus.
Ersetzen Sie die folgenden Felder in Windows PowerShell Skript:
Feld Beschreibung policy-identity/policy-name Name der Richtlinie. azure-client-id Microsoft App ID, die Sie beim Registrieren der App in Azure-Portal generiert haben. Richtlinienbeschreibung Beschreibung der Richtlinie. object-id-of-the-user-to-we-policy-need-to-be-granted ID des Benutzers, für den Sie die Richtlinie mithilfe des Graph-Explorers generieren müssen. Um die Objekt-ID zu generieren, melden Sie sich bei Microsoft Graph Explorer mit den Anmeldeinformationen an, denen die Richtlinie gewährt werden muss.
Wählen Sie auf der Symbolleiste Graph Explorer aus.
Wählen Sie Abfrage ausführen aus. Eine Antwort wird unter Antwortvorschau generiert.
Kopieren Sie den Wert der
idEigenschaft aus der Antwortvorschau , und ersetzen Sie durch die Objekt-ID im PowerShell-Skript.
Führen Sie das PowerShell-Skript aus.
Führen Sie aus
Connect-MicrosoftTeams, und melden Sie sich mit den Anmeldeinformationen an, denen die Richtlinie gewährt werden muss.
Führen Sie den folgenden Befehl in PowerShell aus, um zu überprüfen, ob die Richtlinie erfolgreich erstellt wurde. Ersetzen Sie den Richtliniennamen durch ihren definierten Richtliniennamen.
Get-CsApplicationAccessPolicy -Identity “<<policy-identity/policy-name>>”
Hinweis
Stellen Sie sicher, dass ausgeführte Skripts in Ihrem System nicht deaktiviert sind. Weitere Informationen finden Sie unter Ausführungsrichtlinien.
Erstellen Ihres Bots
Erstellen einer Azure-Botressource
Hinweis
Wenn Sie Ihren Bot bereits in Teams testen, melden Sie sich von dieser App und Von Teams ab. Melden Sie sich erneut an, um diese Änderung anzuzeigen.
Wechseln Sie zu Startseite.
Wählen Sie + Ressource erstellen aus.
Geben Sie in das Suchfeld Azure Bot ein.
Drücken Sie die EINGABETASTE.
Wählen Sie Azure Bot aus.
Wählen Sie Erstellen aus.
Geben Sie den Botnamen im Bothandle ein.
Wählen Sie Ihr Abonnement aus der Dropdownliste aus.
Wählen Sie Ihre Ressourcengruppe aus der Dropdownliste aus.
Wenn Sie nicht über eine vorhandene Ressourcengruppe verfügen, können Sie eine neue Ressourcengruppe erstellen. Führen Sie die folgenden Schritte aus, um eine neue Ressourcengruppe zu erstellen:
- Wählen Sie Neu erstellen aus.
- Geben Sie den Ressourcennamen ein, und wählen Sie OK aus.
- Wählen Sie in der Dropdownliste Neuer Ressourcengruppenstandort einen Standort aus.
Wählen Sie unter Preise die Option Plan ändern aus.
Wählen Sie FO Free>Select aus.
Wählen Sie unter Microsoft App-IDdie Option App-Typ als mehrinstanzenfähig aus.
Wählen Sie unter Erstellungstyp die Option Vorhandene App-Registrierung verwenden aus.
Geben Sie die App-ID ein.
Hinweis
Sie können nicht mehr als einen Bot mit derselben Microsoft-App-ID erstellen.
Wählen Sie Überprüfen + erstellen aus.
Nachdem die Überprüfung erfolgreich war, wählen Sie Erstellen aus.
Die Bereitstellung des Bots dauert einige Minuten.
Wählen Sie Zu Ressource wechseln aus.
Sie haben Ihren Azure-Bot erfolgreich erstellt.
Hinzufügen eines Teams-Kanals
Wählen Sie im linken Bereich Kanäle aus.
Wählen Sie unter Verfügbare Kanäledie Option Microsoft Teams aus.
Aktivieren Sie das Kontrollkästchen, um die Nutzungsbedingungen zu akzeptieren.
Wählen Sie Zustimmen aus.
Wählen Sie Anwenden aus.
So fügen Sie einen Messagingendpunkt hinzu
Verwenden Sie die Dev Tunnel-URL in der Ausgabekonsole als Messagingendpunkt.
Wählen Sie im linken Bereich unter Einstellungen die Option Konfiguration aus.
Aktualisieren Sie den Messagingendpunkt im Format
https://your-devtunnel-domain/api/messages.
Wählen Sie Anwenden aus.
Sie haben erfolgreich einen Bot im Azure Bot-Dienst eingerichtet.
Hinweis
Wenn der Application Insights-Instrumentierungsschlüssel einen Fehler anzeigt, aktualisieren Sie mit der App-ID.
Einrichten von App-Einstellungen und Manifestdateien
Rufen Sie oder
tenantIdUserIdaus Teams ab. Führen Sie die folgenden Schritte aus, um dietenantIdabzurufen:Wählen Sie Teams aus.
Wählen Sie Weitere Optionen (...) aus.
Wählen Sie Link zum Team abrufen aus.
Sie können und
idvon derdisplayNameWebsite abrufen:Melden Sie sich mit Ihrem Teams-Mandantenkonto bei Microsoft Graph Explorer an.
Fügen Sie
Usersam Ende der URL im Suchfeld hinzu.Wählen Sie Abfrage ausführen aus.
Die mit Ihrem Konto verknüpften Anzeigenamen und Benutzer-IDs werden generiert.
Wählen Sie drei beliebige Konten aus, und fügen Sie sie dem
DisplayNameundUserIdin der appsettings.json-Datei hinzu.
Hinweis
TenantIdoderUserIddes Teams-Kontos gibt an, von wo aus Sie den Anruf initiieren möchten, undDisplayNameundUserIdder Benutzer angeben, an wen Sie den Anruf umleiten oder weiterleiten möchten.
Aktualisieren von App-Einstellungen
Wechseln Sie zur appsettings.json-Datei im geklonten Repository.
Öffnen Sie die appsettings.json-Datei in Visual Studio, und aktualisieren Sie die folgenden Informationen:
- Ersetzen Sie
MicrosoftAppId,ClientIdundAppIddurch die Microsoft App-ID Ihres Bots. - Ersetzen Sie
MicrosoftAppPassword,ClientSecretundAppSecretin Den Wert des geheimen Clientschlüssels Ihres Bots. - Ersetzen Sie durch
BotBaseUrlden Domänennamen ngrok oder dev tunnel. - Ersetzen Sie
TenantIddurchUserId. - Ersetzen Sie
DisplayNamedurchId.
- Ersetzen Sie
Klicken Sie auf Speichern.
Aktualisieren des App-Manifests
Wechseln Sie zur manifest.json-Datei im geklonten Repository.
Öffnen Sie die manifest.json-Datei in Visual Studio, und nehmen Sie die folgenden Änderungen vor:
- Ersetzen Sie
{id}`` and{BotId} durch Ihre Microsoft-App-ID. - Ersetzen Sie alle Vorkommen von
{{domain-name}}durch den Domänennamen ngrok oder dev tunnel.
- Ersetzen Sie
Erstellen und Ausführen des Diensts
Verwenden Sie Visual Studio, um den Dienst zu erstellen und auszuführen:
Öffnen Sie Visual Studio.
Wechseln Sie zu Datei>Projekt öffnen>/Projektmappe...
Wählen Sie die CallingBotSample.sln Datei aus dem Csharp-Quellordner> aus.
Press F5 to run the project.
Eine Webseite wird mit der Meldung Ihr Bot ist bereit! geöffnet.
Hinzufügen eines Anruf- und Besprechungsbots zu Teams
Navigieren Sie in Ihrem geklonten Repository zu csharp > Source > AppManifest.
Erstellen Sie eine .zip-Datei mit den folgenden Dateien, die im Ordner AppManifest vorhanden sind:
- manifest.json
- outline.png
- color.png
Hinweis
Der
manifest.zipdarf keine zusätzlichen Ordner enthalten. Es muss eine Quelldatei,colorein Symbol undoutlineein Symbol im ZIP-Ordner enthaltenmanifest json.Wählen Sie im Teams-Client das Symbol Apps aus.
Wählen Sie Verwalten Ihrer Apps aus.
Wählen Sie App hochladen aus.
Wählen Sie im Popupfenster Benutzerdefinierte App hochladen aus. Wenn die Option angezeigt wird, ist der benutzerdefinierte App-Upload aktiviert.
Wechseln Sie zu csharp > Source > AppManifest.
Wählen Sie Öffnen aus, um die .zip Datei hochzuladen, die Sie im Ordner AppManifest erstellt haben.
Wählen Sie Hinzufügen aus, um die Anrufbot-App in Teams zu installieren.
Interagieren mit einem Anruf- und Besprechungsbot
Bot ermöglicht Ihnen den Zugriff auf Dienste und Inhalte in einem dedizierten Bereich innerhalb eines Kanals oder in einem Chat.
Lassen Sie uns mit der App in Teams interagieren!
Wählen Sie im linken Bereich der Teams die Option Weitere Apps anzeigen (...) aus, und wählen Sie Ihre App aus der Liste aus.
Bot sendet Begrüßungstext mit adaptiver Karte.
Wählen Sie Anruf erstellen aus.
Wählen Sie Anruf übertragen aus.
Sie können den Bot bitten, eine Besprechung zu planen und die Teilnehmer einzuladen.
Abschließen der Herausforderung
Haben Sie eine ausgabe wie diese?
Herzlichen Glückwunsch!
Sie haben das Tutorial zum Einstieg in die Botanruf- und Besprechungs-App für Microsoft Teams abgeschlossen.
Liegt ein Problem mit diesem Abschnitt vor? Wenn ja, senden Sie uns Feedback, damit wir den Abschnitt verbessern können.