Erweitern einer Teams-Nachrichtenerweiterung in Microsoft 365
Hinweis
Wenn Sie Ihren Nachrichtenerweiterungsbot mit einem Outlook-Kanal verbunden haben, müssen Sie zum Microsoft 365-Kanal migrieren.
Suchbasierte Nachrichtenerweiterungen ermöglichen es Benutzern, ein externes System zu durchsuchen und die Ergebnisse über den Bereich des Microsoft Teams-Clients zum Verfassen von Nachrichten freizugeben. Sie können jetzt suchbasierte Teams-Nachrichtenerweiterungen für die Produktion für Vorschaugruppen in Outlook für Windows Desktop und outlook.com nutzen, indem Sie Ihre Teams-Apps auf Microsoft 365 erweitern.
Der Prozess zum Aktualisieren Ihrer suchbasierten Teams-Nachrichtenerweiterung umfasst die folgenden Schritte:
- Aktualisieren Sie Ihr App-Manifest (zuvor als Teams-App-Manifest bezeichnet).
- Fügen Sie den Microsoft 365-Kanal für Ihren Bot hinzu.
- Laden Sie Ihre aktualisierte App in Teams quer.
Der Rest dieses Leitfadens führt Sie durch diese Schritte und zeigt, wie Sie eine Vorschau Ihrer Nachrichtenerweiterung in Outlook für Windows Desktop und Web anzeigen.
Voraussetzungen
Für dieses Tutorial benötigen Sie Folgendes:
- Einen Sandkastenmandanten für das Microsoft 365-Entwicklerprogramm.
- Eine Testumgebung mit Microsoft 365-Apps, die über den Microsoft 365 Apps Aktuellen Kanal installiert sind.
- (Optional) Microsoft Visual Studio Code mit der Teams Toolkit-Erweiterung.
Verbreiten von Links
Wenn Ihre suchbasierte Nachrichtenerweiterung das Entflechten von Links in Teams unterstützt, führen Sie die Schritte in diesem Artikel aus, um das Entpacken von Links in Outlook im Web und Windows-Desktopumgebungen zu aktivieren. Der Codebeispielabschnitt enthält eine App zum Entpacken von Links zum Testen.
Bühnenansicht
Wenn Ihre suchbasierte Nachrichtenerweiterung Links entpackt, die Karten anzeigen, um die Phasenansicht in Teams zu starten, führen Sie die Schritte in diesem Artikel aus, mit denen Ihre Benutzer in Outlook im Web und Windows-Desktop Links senden können, die in Outlook auf die gleiche Weise funktionieren.
Mobile Outlook-Benutzer unter Android und Microsoft Outlook Beta TestFlight iOS-Ringe können jetzt Karten von Ihren Apps empfangen und ausführen, die von Benutzern in Outlook im Web und Windows-Desktop an sie gesendet wurden.
Der Codebeispielabschnitt enthält eine App für die Phasenansicht zum Testen.
Vorbereiten Ihrer Nachrichtenerweiterung für das Upgrade
Wenn Sie über eine vorhandene Nachrichtenerweiterung in der Produktion verfügen, erstellen Sie eine Kopie oder einen Zweig Ihres Projekts zum Testen, und aktualisieren Ihre App-ID im App-Manifest, um einen neuen Bezeichner (unterschiedlich von der Produktions-App-ID, für Testzwecke) zu verwenden.
Wenn Sie dieses Lernprogramm zum Aktualisieren einer vorhandenen Microsoft Teams-App mithilfe von Beispielcode absolvieren möchten, führen Sie die Setupschritte unter Suchbeispiel für Microsoft Teams-Nachrichtenerweiterungen aus, um schnell eine suchbasierte Microsoft Teams-Nachrichtenerweiterung zu erstellen.
Alternativ können Sie die fertige Outlook-fähige App im folgenden Abschnitt verwenden und den Teil dieses Lernprogramms zum Aktualisieren des App-Manifests überspringen.
Schnellstart
Verwenden Sie die Microsoft Teams Toolkit-Erweiterung für Visual Studio Code, um mit einer Beispielnachrichtenerweiterung zu beginnen, die bereits für die Ausführung in Outlook aktiviert ist.
Öffnen Sie Visual Studio Code.
Wählen Sie befehlspalette... unter der Option Ansicht oder STRG+UMSCHALT+P aus.
Wählen Sie Teams: Neue App erstellen aus.
Wählen Sie in der angezeigten Dropdownliste Nachrichtenerweiterung aus.
Wählen Sie Benutzerdefinierte Suchergebnisse aus, um den Beispielcode für eine Teams-Nachrichtenerweiterung mithilfe des neuesten App-Manifests herunterzuladen. Weitere Informationen finden Sie unter App-Manifest.
Das Beispiel ist auch als NPM-Suchconnector im Microsoft Teams Toolkit-Beispielkatalog verfügbar. Wählen Sie im Microsoft Teams Toolkit-Bereich die Option Entwicklung>Beispiele anzeigen>NPM-Suchconnector aus.
Wählen Sie die bevorzugte Programmiersprache aus.
Wählen Sie einen Speicherort auf Ihrem lokalen Computer für den Arbeitsbereichsordner aus, und geben Sie ihren Anwendungsnamen ein.
Wählen Sie befehlspalette... unter der Option Ansicht oder STRG+UMSCHALT+P aus.
Geben Sie Teams: Bereitstellen ein, um die relevanten App-Ressourcen wie Azure App Service, App Service Plan, Azure Bot und verwaltete Identität in Ihrem Azure-Konto zu erstellen.
Wählen Sie ein Abonnement und eine Ressourcengruppe aus.
Wählen Sie Bereitstellen aus. Alternativ können Sie im Abschnitt LIFECYCLE der Erweiterung bereitstellen auswählen.
Wählen Sie befehlspalette... unter der Option Ansicht oder STRG+UMSCHALT+P aus.
Geben Sie Teams: Deploy ein, um den Beispielcode für die bereitgestellten Ressourcen in Azure bereitzustellen, und starten Sie die App. Alternativ können Sie im Abschnitt LIFECYCLE der Erweiterung bereitstellen auswählen.
Wählen Sie Bereitstellen.
Von hier aus können Sie mit Hinzufügen des Microsoft 365-Kanals für Ihren Bot fortfahren, um den letzten Schritt zum Aktivieren der Teams-Nachrichtenerweiterung für die Verwendung in Outlook abzuschließen. Das App-Manifest verweist bereits auf die richtige Version, sodass keine Updates erforderlich sind.
Aktualisieren des App-Manifests
Sie müssen die App-Manifestschemaversion 1.13
(oder höher) verwenden, damit Ihre Teams-Nachrichtenerweiterung in Outlook ausgeführt werden kann. Weitere Informationen zur Schemaversion finden Sie unter App-Manifest.
Sie haben zwei Möglichkeiten zum Aktualisieren Ihres App-Manifests:
- Wählen Sie befehlspalette... unter der Option Ansicht oder STRG+UMSCHALT+P aus.
- Führen Sie den
Teams: Upgrade app manifest
-Befehl aus, und wählen Sie Ihre App-Manifestdatei aus. Ihre App-Manifestdateien werden mit den neuesten Änderungen aktualisiert.
Wenn Sie das Teams Toolkit zum Erstellen Ihrer Nachrichtenerweiterungs-App verwendet haben, können Sie damit die Änderungen an Ihrer App-Manifestdatei überprüfen und Fehler identifizieren. Öffnen Sie die Befehlspalette (Ctrl+Shift+P
), und suchen Sie nach Teams: Manifestdatei überprüfen.
Hinzufügen eines Microsoft 365-Kanals für Ihren Bot
In Microsoft Teams besteht eine Nachrichtenerweiterung aus einem Webdienst, den Sie hosten, und einem App-Manifest, das definiert, wo Ihr Webdienst gehostet wird. Der Webdienst nutzt das Bot Framework SDK-Nachrichtenschema und das sichere Kommunikationsprotokoll über einen Teams-Kanal, der für Ihren Bot registriert ist.
Damit Benutzer mit Ihrer Nachrichtenerweiterung aus Outlook interagieren können, müssen Sie Ihrem Bot den Microsoft 365-Kanal hinzufügen:
Navigieren Sie von Microsoft Azure-Portal (oder bot Framework-Portal, wenn Sie sich zuvor dort registriert haben) zu Ihrer Botressource.
Wählen Sie unter Einstellungen die Option Kanäle.
Wählen Sie unter Verfügbare Kanäle die Option Microsoft 365-Kanal aus.
Wählen Sie Anwenden aus.
Vergewissern Sie sich, dass Ihr Microsoft 365-Kanal zusammen mit Teams im Bereich Kanäle Ihres Bots aufgeführt ist.
Aktualisieren der Microsoft Azure Active Directory (Azure AD)-App-Registrierung für SSO
Hinweis
Sie können diesen Schritt überspringen, wenn Sie die in diesem Tutorial bereitgestellte Beispiel-App verwenden, da das Szenario keine Authentifizierung mit dem einmaligen Anmelden von Azure Active Directory (AAD) umfasst.
Das einmalige Anmelden (Single Sign-On, SSO) von Azure Active Directory (AD) für Nachrichtenerweiterungen funktioniert in Outlook genauso wie in Teams. Sie müssen der Azure AD-App-Registrierung Ihres Bots im App-Registrierungen-Portal Ihres Mandanten jedoch mehrere Clientanwendungs-IDs hinzufügen.
Melden Sie sich mit Ihrem Sandkastenmandantenkonto beim Azure-Portal an.
Öffnen Sie App-Registrierungen.
Wählen Sie den Namen Ihrer Anwendung aus, um die entsprechende App-Registrierung zu öffnen.
Wählen Sie Eine API verfügbar machen aus (unter Verwalten).
Stellen Sie im Abschnitt Autorisierte Clientanwendungen sicher, dass alle folgenden
Client Id
Werte aufgeführt sind:Microsoft 365-Clientanwendung Client-ID Teams-Desktop und mobiles Gerät 1fec8e78-bce4-4aaf-ab1b-5451cc387264 Teams-Web 5e3ce6c0-2b1f-4285-8d4b-75ee78787346 Outlook Desktop d3590ed6-52b3-4102-aeff-aad2292ab01c Outlook Web Access bc59ab01-8403-45c6-8796-ac3ef710b3e3 Outlook Mobile 27922004-5251-4030-b22d-91ecd9a37ea4
Querladen Ihrer aktualisierten Nachrichtenerweiterung in Teams
Der letzte Schritt besteht darin, Ihre aktualisierte Nachrichtenerweiterung (App-Paket) in Teams querzuladen. Nachdem Sie den Vorgang abgeschlossen haben, wird die Nachrichtenerweiterung in Ihren installierten Apps im Nachrichtenbereich zum Verfassen angezeigt.
Verpacken Sie Ihre Teams-Anwendung (Manifest- und App-Symbole) in einer ZIP-Datei. Wenn Sie teams Toolkit zum Erstellen Ihrer App verwendet haben, können Sie dies ganz einfach mithilfe der Option Zip Teams App Package im Abschnitt UTILITY des Teams Toolkits tun. Wählen Sie die
manifest.json
Datei für Ihre App und die entsprechende Umgebung aus.Wechseln Sie zu Microsoft Teams, und melden Sie sich mit Ihrem Sandbox-Mandantenkonto an.
Wählen Sie Apps aus, um den Bereich Apps verwalten zu öffnen. Wählen Sie dann App hochladen aus.
Wählen Sie die Option Benutzerdefinierte App hochladen aus, wählen Sie Ihr App-Paket aus, und installieren Sie es (Hinzufügen) auf Ihrem Teams-Client.
Nachdem sie über Teams quergeladen wurde, ist Ihre Nachrichtenerweiterung in Outlook für Windows Desktop und Web verfügbar.
Anzeigen einer Vorschau ihrer Nachrichtenerweiterung in Outlook
So können Sie Ihre Nachrichtenerweiterung zur Ausführung in Outlook auf Desktop- und Weboberflächen unter Windows testen.
Outlook im Web
So zeigen Sie eine Vorschau Ihrer App an, die in Outlook im Web ausgeführt wird:
Melden Sie sich mit Ihren Testmandantenanmeldeinformationen bei outlook.com an.
Wählen Sie Neue Nachricht aus.
Wählen Sie im Menüband Apps aus.
Ihre Nachrichtenerweiterung wird aufgelistet. Sie können sie von dort aus aufrufen und genauso verwenden, wie Sie es beim Verfassen einer Nachricht in Teams tun würden.
Outlook
So zeigen Sie eine Vorschau Ihrer App an, die in Outlook auf Windows-Desktop ausgeführt wird:
Starten Sie Outlook, und melden Sie sich mit Ihren Testmandantenanmeldeinformationen an.
Wählen Sie Neue E-Mail aus.
Wählen Sie im Menüband Alle Apps aus.
Ihre Nachrichtenerweiterung wird aufgelistet. Sie öffnet einen angrenzenden Bereich, in dem Suchergebnisse angezeigt werden.
Problembehandlung
Während Ihre aktualisierte Nachrichtenerweiterung weiterhin in Teams mit vollständiger Funktionsunterstützung für Nachrichtenerweiterungen ausgeführt wird, gibt es Einschränkungen in dieser frühen Vorschau der Outlook-fähigen Benutzeroberfläche, die Sie beachten müssen:
- Nachrichtenerweiterungen in Outlook sind auf den Kontext zum Verfassen von E-Mails beschränkt. Auch wenn Ihre Teams-Nachrichtenerweiterung als Kontext im App-Manifest enthalten
commandBox
ist, ist die aktuelle Vorschau auf die Option E-Mail-Komposition (compose
) beschränkt. Das Aufrufen einer Nachrichtenerweiterung aus dem globalen Outlook-Feld Suchen wird nicht unterstützt. - Aktionsbasierte Nachrichtenerweiterungsbefehle werden in Outlook nicht unterstützt. Wenn Ihre App sowohl such- als auch aktionsbasierte Befehle enthält, wird sie in Outlook angezeigt, aber das Aktionsmenü ist nicht verfügbar.
- Das Einfügen von mehr als fünf adaptiven Karten in eine E-Mail wird nicht unterstützt. Adaptive Karten v1.5 und höher werden nicht unterstützt.
- Kartenaktionen vom Typ
messageBack
,imBack
,invoke
undsignin
werden für eingefügte Karten nicht unterstützt. Die Unterstützung ist aufopenURL
beschränkt: Wenn diese Option ausgewählt ist, wird der Benutzer auf einer neuen Registerkarte an die angegebene URL umgeleitet.
Verwenden Sie die Kanäle der Microsoft Teams-Entwicklercommunity, um Probleme zu melden und Feedback zu geben.
Debugging
Beim Testen Ihrer Nachrichtenerweiterung können Sie die Quelle (aus Teams und nicht aus Outlook stammend) von Bot-Anforderungen anhand der Eigenschaft channelId des Activity-Objekts identifizieren. Wenn ein Benutzer eine Abfrage ausführt, erhält Ihr Dienst ein standardmäßiges Bot Framework-Activity
Objekt. Eine der Eigenschaften im Activity-Objekt ist channelId
, das den Wert von msteams
oder outlook
aufweist, je nachdem, wo die Botanforderung stammt. Weitere Informationen finden Sie unter suchbasiertes Nachrichtenerweiterungs-SDK.
Codebeispiel
Beispielname | Beschreibung | Node.js |
---|---|---|
NPM-Suchconnector | Verwenden Sie Teams Toolkit, um eine Nachrichtenerweiterungs-App zu erstellen. Funktioniert in Teams, Outlook. | Anzeigen |
Teams Link Unfurling | Einfache Teams-App zur Veranschaulichung der Link-Entflechtung. Funktioniert in Teams, Outlook. | Anzeigen |
Registerkarte in der Phasenansicht | Beispiel-App für microsoft Teams-Registerkarten zum Veranschaulichung einer Registerkarte in der Phasenansicht. Funktioniert in Teams, Outlook, Microsoft 365-App. | View |
Nächster Schritt
Veröffentlichen Sie Ihre App, damit sie in Teams, Outlook und Microsoft 365-Apps erkannt werden kann: