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.

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.

  1. Öffnen Sie Visual Studio Code.

  2. Wählen Sie befehlspalette... unter der Option Ansicht oder STRG+UMSCHALT+P aus.

  3. Wählen Sie Teams: Neue App erstellen aus.

  4. Wählen Sie in der angezeigten Dropdownliste Nachrichtenerweiterung aus.

  5. 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.

    Screenshot: Befehlspalette zum Erstellen einer neuen Teams-App in VS Code zum Auflisten von Teams-Beispieloptionen

    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.

    Screenshot: NPM-Suchconnector-Beispiel im Katalog mit Beispielen für das Teams-Toolkit.

  6. Wählen Sie die bevorzugte Programmiersprache aus.

  7. Wählen Sie einen Speicherort auf Ihrem lokalen Computer für den Arbeitsbereichsordner aus, und geben Sie ihren Anwendungsnamen ein.

  8. Wählen Sie befehlspalette... unter der Option Ansicht oder STRG+UMSCHALT+P aus.

  9. 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.

  10. Wählen Sie ein Abonnement und eine Ressourcengruppe aus.

  11. Wählen Sie Bereitstellen aus. Alternativ können Sie im Abschnitt LIFECYCLE der Erweiterung bereitstellen auswählen.

  12. Wählen Sie befehlspalette... unter der Option Ansicht oder STRG+UMSCHALT+P aus.

  13. 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.

  14. 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:

  1. Wählen Sie befehlspalette... unter der Option Ansicht oder STRG+UMSCHALT+P aus.
  2. 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:

  1. Navigieren Sie von Microsoft Azure-Portal (oder bot Framework-Portal, wenn Sie sich zuvor dort registriert haben) zu Ihrer Botressource.

  2. Wählen Sie unter Einstellungen die Option Kanäle.

  3. Wählen Sie unter Verfügbare Kanäle die Option Microsoft 365-Kanal aus.

    Screenshot: Vorschaukanal für Microsoft 365-Erweiterungen für Ihren Bot im Bereich

  4. Wählen Sie Anwenden aus.

    Screenshot des Microsoft 365-Nachrichtenerweiterungskanals für Ihren Bot aus dem Bereich

  5. 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.

  1. Melden Sie sich mit Ihrem Sandkastenmandantenkonto beim Azure-Portal an.

  2. Öffnen Sie App-Registrierungen.

  3. Wählen Sie den Namen Ihrer Anwendung aus, um die entsprechende App-Registrierung zu öffnen.

  4. Wählen Sie Eine API verfügbar machen aus (unter Verwalten).

  5. 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.

  1. 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.

    Screenshot: Option

  2. Wechseln Sie zu Microsoft Teams, und melden Sie sich mit Ihrem Sandbox-Mandantenkonto an.

  3. Wählen Sie Apps aus, um den Bereich Apps verwalten zu öffnen. Wählen Sie dann App hochladen aus.

    Screenshot: Option

  4. 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.

    Screenshot: Option

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:

  1. Melden Sie sich mit Ihren Testmandantenanmeldeinformationen bei outlook.com an.

  2. Wählen Sie Neue Nachricht aus.

  3. Wählen Sie im Menüband Apps aus.

    Screenshot: Menü

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:

  1. Starten Sie Outlook, und melden Sie sich mit Ihren Testmandantenanmeldeinformationen an.

  2. Wählen Sie Neue E-Mail aus.

  3. Wählen Sie im Menüband Alle Apps aus.

    Screenshot: Menü

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, invokeund signin werden für eingefügte Karten nicht unterstützt. Die Unterstützung ist auf openURLbeschrä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-ActivityObjekt. Eine der Eigenschaften im Activity-Objekt ist channelId, das den Wert von msteams oder outlookaufweist, 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: