Erweitern einer Teams-Nachrichtenerweiterung in Microsoft 365

Nachrichtenerweiterungen ermöglichen Benutzern die Interaktion mit Ihrem Webdienst über Schaltflächen und Formulare. Benutzer können Aktionen in einem externen System von Microsoft Teams und Outlook durchsuchen oder initiieren, indem Sie Ihre Teams-Apps auf Microsoft 365 erweitern. Es gibt zwei Arten von Nachrichtenerweiterungen:

• Suchbasierte Nachrichtenerweiterungen: Ermöglichen Es Benutzern, ein externes System zu durchsuchen und Ergebnisse über den Nachrichtenerstellungsbereich des Clients freizugeben.

• Aktionsbasierte Nachrichtenerweiterungen: Ermöglichen Es Benutzern mit einem modalen Popupfenster, Informationen zu sammeln oder anzuzeigen, die Interaktion zu verarbeiten und die Informationen als umfangreiche Karte zurück an den Client zu senden.

Hinweis

Suchbasierte Nachrichtenerweiterungen für Teams sind allgemein für Outlook verfügbar, und aktionsbasierte Nachrichtenerweiterungen sind in der Vorschau für Outlook verfügbar.

Mobile Outlook-Benutzer unter Android und iOS können Karten von Ihren Apps empfangen und aktionen ausführen, die von Benutzern auf Outlook im Web und Outlook für Windows an sie gesendet wurden.

Die Teams-Nachrichtenerweiterung in Microsoft 365 unterstützt auch das Entpacken von Links , die Karten anzeigen, um Stageview und Dialoge zu starten.

Voraussetzungen

Um Ihre Teams-Nachrichtenerweiterung auf Outlook zu erweitern, stellen Sie Folgendes sicher:

• Suchen Sie nach Unterstützung für Nachrichtenerweiterungen in Outlook für Windows Desktop, Web und Mobilgeräte. Weitere Informationen finden Sie in der Supporttabelle unter Erweitern von Teams-Apps in Microsoft 365.
• Einen Sandkastenmandanten für das Microsoft 365-Entwicklerprogramm. Registrieren Sie für aktionsbasierte Nachrichtenerweiterungen Ihren Entwicklermandanten für gezielte Microsoft 365-Releases.
• 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.

Erstellen oder Erweitern einer Nachrichtenerweiterung

Um Ihre Teams-Nachrichtenerweiterung auf Outlook zu erweitern, können Sie entweder eine neue Nachrichtenerweiterungs-App mit dem Teams-Toolkit erstellen oder eine vorhandene Teams-Nachrichtenerweiterungs-App auf Outlook erweitern.

Erstellen einer Nachrichtenerweiterungs-App für Outlook

Sie können eine Teams-Nachrichtenerweiterungs-App für Outlook über die Teams Toolkit-Erweiterung für Visual Studio Code erstellen. Stellen Sie Folgendes sicher, um eine Nachrichtenerweiterungs-App für Outlook zu erstellen:

• Hochladen Ihrer App in Teams
• Anzeigen einer Vorschau ihrer Nachrichtenerweiterung in Outlook

Sie können entweder eine suchbasierte oder eine aktionsbasierte Nachrichtenerweiterung erstellen.

Suchbasierte Nachrichtenerweiterung

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 Dropdownliste die Option Nachrichtenerweiterung aus.

5. Wählen Sie Benutzerdefinierte Suchergebnisse aus, um den Beispielcode für eine suchbasierte Teams-Nachrichtenerweiterung mithilfe des neuesten App-Manifests (zuvor als Teams-App-Manifest bezeichnet) herunterzuladen.

   

   Sie können den Beispielcode auch im linken Bereich herunterladen, und wählen Sie unter ENTWICKLUNGdie Option Beispiele anzeigen aus. Die Registerkarte Beispiele wird angezeigt, und geben Sie im Suchfeld NPM-Suchconnector ein.

   

6. Wählen Sie eine 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.

Aktionsbasierte Nachrichtenerweiterung

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 Dropdownliste die Option Nachrichtenerweiterung aus.

5. Wählen Sie Formulareingaben sammeln und Daten verarbeiten aus, um den Beispielcode für eine aktionsbasierte Microsoft Teams-Nachrichtenerweiterung mithilfe des neuesten App-Manifests (zuvor als Teams-App-Manifest bezeichnet) herunterzuladen.

   

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.

Jetzt können Sie Ihre App in Teams hochladen und eine Vorschau Ihrer Nachrichtenerweiterung in Outlook anzeigen. Informationen zum Erstellen Ihres App-Pakets über das Teams-Toolkit finden Sie unter Erstellen eines App-Pakets.

Erweitern einer vorhandenen Teams-Nachrichtenerweiterungs-App auf Outlook

Um Ihre vorhandene Teams-Nachrichtenerweiterungs-App auf Outlook zu erweitern, stellen Sie Folgendes sicher:

• Aktualisieren Sie Ihr App-Manifest.
• Fügen Sie den Microsoft 365-Kanal für Ihre App hinzu.
• Aktualisieren sie Microsoft Entra App-Registrierung für SSO.
• Laden Sie Ihre aktualisierte App in Teams hoch.
• Anzeigen einer Vorschau ihrer Nachrichtenerweiterung in Outlook

Aktualisieren Ihres App-Manifests

Aktualisieren Sie die Schemaversion 1.13 des App-Manifests (früher Teams-App-Manifest genannt) oder höher, damit Ihre Teams-Nachrichtenerweiterung in Outlook ausgeführt werden kann.

Öffnen Sie Ihr App-Manifest, und aktualisieren Sie und $schemamanifestVersion mit den folgenden Werten:

{
"$schema" : "https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
"manifestVersion" : "1.16"
}

Sie können das Teams-Toolkit verwenden, um Ihr App-Manifest zu überprüfen und Fehler zu identifizieren.

Angeben der Hostruntime-Anforderungen (Entwicklervorschau)

Um sicherzustellen, dass Ihre App Kunden immer hochwertige Erfahrungen bietet, können Sie das Verhalten Ihrer App in den entsprechenden Microsoft 365-Hosts anpassen oder sie in Kontexten auslassen, die Sie nicht unterstützen möchten. Verwenden Sie das App-Manifest, um Abhängigkeitsbeziehungen zwischen den Funktionen Ihrer App und bestimmte Laufzeitanforderungen Ihrer statischen Registerkarten, Nachrichtenerweiterungen und Bots anzugeben.

Weitere Informationen finden Sie unter Angeben von Microsoft 365-Hostruntime-Anforderungen in Ihrem App-Manifest.

Hinzufügen eines Microsoft 365-Kanals für Ihre App

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-Messagingschema 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 den Microsoft 365-Kanal für Ihre Azure-Botressource der Nachrichtenerweiterungs-App aktivieren.

Hinweis

Wenn Sie zuvor den Outlook-Kanal für Ihren Bot aktiviert haben, müssen Sie den Microsoft 365-Kanal aktivieren, damit Ihre Nachrichtenerweiterung in Microsoft Outlook ordnungsgemäß funktioniert. Der Outlook-Kanal wird nicht mehr für Nachrichtenerweiterungen verwendet, die in Outlook ausgeführt werden, und kann deaktiviert werden.

1. Wechseln Sie zum Microsoft Azure-Portal- oder Bot Framework-Portal (sofern Sie sich zuvor dort registriert haben), und wechseln Sie zu Ihrer Botressource.

2. Über Einstellungskanäle>.

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

   

4. Wählen Sie Anwenden aus.

   

5. Vergewissern Sie sich, dass Ihr Microsoft 365-Kanal zusammen mit Microsoft Teams im Bereich Kanäle Ihres Bots aufgeführt ist.

Aktualisieren Microsoft Entra App-Registrierung für SSO

Hinweis

Sie können diesen Schritt überspringen, wenn Sie eine App für Outlook mithilfe des Teams-Toolkits erstellen, da das Szenario nicht Microsoft Entra Authentifizierung mit einmaligem Anmelden umfasst.

Microsoft Entra einmaliges Anmelden (Single Sign-On, SSO) für Nachrichtenerweiterungen funktioniert in Outlook genauso wie in Teams. Sie müssen jedoch mehrere Clientanwendungs-IDs zur Microsoft Entra App-Registrierung Ihres Bots im App-Registrierungen-Portal Ihres Mandanten hinzufügen.

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

2. Wählen Sie App-Registrierungen aus.

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

4. Wählen Sie Verwalten>Api verfügbar machen aus.

5. Stellen Sie sicher, dass im Abschnitt Autorisierte Clientanwendungen 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
   Microsoft 365 Web	4765445b-32c6-49b0-83e6-1d93765276ca
   Microsoft 365 Desktop	0ec893e0-5785-4de6-99da-4ed124e5296c
   Microsoft 365 Mobile	d3590ed6-52b3-4102-aeff-aad2292ab01c
   Outlook Desktop	d3590ed6-52b3-4102-aeff-aad2292ab01c
   Outlook Web Access	bc59ab01-8403-45c6-8796-ac3ef710b3e3
   Outlook Mobile	27922004-5251-4030-b22d-91ecd9a37ea4

Hochladen Ihrer benutzerdefinierten App in Teams

Laden Sie Ihre aktualisierte Nachrichtenerweiterung (App-Paket) in Teams hoch. Nachdem Sie den Vorgang abgeschlossen haben, wird die Nachrichtenerweiterung in Ihren installierten Apps im Nachrichtenbereich zum Verfassen angezeigt.

1. Erstellen Sie eine .zip-Datei mit App-Manifest und App-Symbolen.

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

3. Wählen Sie Apps>Apps verwalten>Apps verwalten aus.

   

4. Wählen Sie die Option Benutzerdefinierte App hochladen aus, wählen Sie Ihre .zip-Datei aus, und installieren Sie sie (hinzufügen) auf Ihrem Teams-Client.

   

Nachdem sie über Teams hochgeladen wurde, ist Ihre Nachrichtenerweiterung in Outlook für Windows Desktop und Web verfügbar.

Anzeigen einer Vorschau ihrer Nachrichtenerweiterung in Outlook

Hier erfahren Sie, wie Sie Ihre Nachrichtenerweiterung testen, die in Outlook im Web ausgeführt wird. Führen Sie die folgenden Schritte aus, um eine Vorschau Ihrer App anzuzeigen, 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.

   

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.

Debugging

Während Sie Ihre Nachrichtenerweiterung debuggen, können Sie die Quelle (die von Teams im Vergleich zu Outlook stammt) von Botanforderungen anhand des Felds 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 m365extensionsaufweist, je nachdem, wo die Botanforderung stammt. Weitere Informationen finden Sie unter suchbasiertes Nachrichtenerweiterungs-SDK und aktionsbasiertes Messagingerweiterungs-SDK.

Begrenzungen

Während Ihre aktualisierte Nachrichtenerweiterung weiterhin in Teams ausgeführt wird, müssen Sie die folgenden Einschränkungen beachten:

• Nachrichtenerweiterungen in Outlook werden nur im compose Kontext unterstützt. Im Teams-App-Manifest werden Nachrichtenerweiterungskontexte wie commandBox und message in Outlook nicht unterstützt.

• Aktionsbasierte Nachrichtenerweiterungen, die Karten in das Verfassenfeld senden , werden in Outlook unterstützt. Die Verwendung von Bots zum Übermitteln von Karten wird jedoch nicht unterstützt. In diesem Szenario können Sie Ihre Nachrichtenerweiterung konvertieren, um Karten in das Feld "Verfassen" in Outlook zu senden.

• Sie können nicht mehr als fünf adaptive Karten in eine E-Mail einfügen.

• Kartenaktionen vom Typ messageBack, imBack, invokeund signin werden nicht unterstützt. openURList die einzige unterstützte Karte Aktion.

• Aktionen für adaptive Karten werden unterstützt. Für Action.Submitnur stageview und taskmodule wird das Starten unterstützt.

Hinweis

Wenn Sie eine App mit Linkentfernung testen, stellen Sie sicher, dass Sie die App nach dem Testen manuell entfernen. Wenn mehrere Apps dieselbe Domäne überwachen, wird die zuletzt installierte App möglicherweise nicht aufgerufen, um den Link in Outlook wie in Teams zu entpacken.

Verwenden Sie die Kanäle der Microsoft Teams-Entwicklercommunity, um Probleme zu melden und Feedback zu geben.

Codebeispiel

Beispielname	Beschreibung	Node.js
NPM-Suchconnector	Teams Toolkit-Beispiel-App zum Erstellen einer Nachrichtenerweiterungs-App. Funktioniert in Teams und Outlook.	View
Teams Link Unfurling	Einfache Teams-App zur Veranschaulichung der Link-Entflechtung. Funktioniert in Teams, Outlook.	Anzeigen
Registerkarte in Stageview	Microsoft Teams-Tab-Beispiel-App zum Veranschaulichung einer Registerkarte in Stageview. Funktioniert in Teams, Outlook, Microsoft 365-App.	View
Aktionsbasierte Nachrichtenerweiterung für Teams für Microsoft 365	Teams Toolkit-Beispiel-App zum Erstellen einer Nachrichtenerweiterungs-App. Funktioniert in Teams und Outlook.	View

Nächster Schritt

Veröffentlichen von Teams-Apps für Outlook und Microsoft 365-Apps