Überlegungen zur Microsoft Teams-Integration
Sie können Web-Apps für die sozialen und kollaborativen Features von Microsoft Teams geeignet machen, indem Sie sie ordnungsgemäß in Teams integrieren.
Die verschiedenen Arten von Apps, die Sie in Teams integrieren können, sind wie folgt:
- Eigenständige Apps: Eine eigenständige App ist eine einzelseitige oder große und komplexe App. Der Benutzer kann einige Aspekte davon in Teams verwenden.
- Apps für die Zusammenarbeit: Eine App, die bereits für die sozialen und kollaborativen Features von Microsoft Teams entwickelt wurde.
- Microsoft SharePoint: Eine SharePoint-Seite, die in Teams angezeigt werden soll.
Sie können die für Ihr Integrationsszenario geeignete Richtlinie zuordnen und befolgen. Dieses Dokument bietet eine Übersicht über Teams-Funktionen, SharePoint-Anforderungen für die Datei- und Datenspeicherung, API-Anforderungen, Authentifizierung und Deep Linking Ihrer App mit Teams.
Lernen Sie die Funktionen der Microsoft Teams-Plattform kennen
Integrationsszenarien: Eigenständige Apps, Apps für die Zusammenarbeit, SharePoint
Ihre Microsoft Teams-App muss erforderliche und erwartete Features für die Zusammenarbeit enthalten. Für die App-Integration ist es wichtig, sich mit der Teams-Entwicklungsterminologie vertraut zu machen.
| Allgemeine App-Features | Funktionen der Microsoft Teams-Plattform |
|---|---|
| Eingebettete Webseite, Homepage oder Webview |
Registerkarten In Microsoft 365 erweiterte Registerkarten |
| Freigabetastenkombinationen und -erweiterungen |
Nachrichtenerweiterungen Nachrichtenerweiterungen für Outlook |
| Aktionstastenkombinationen und -erweiterungen | Nachrichtenerweiterungen |
| Chatbots | Bots |
| Kanalbenachrichtigungen |
Bots Eingehende Webhooks Connectors für Microsoft 365-Gruppen |
| Externe Nachrichtendienste |
Bots Ausgehende Webhooks |
| Modale Elemente | Dialoge (in TeamsJS v1.x als Aufgabenmodule bezeichnet) |
| Inhaltsreiche Karten | Adaptive Karten |
Bestimmen Sie eine Teilmenge von Funktionen
Integrationsszenarien: Eigenständige Apps
Die Integration aller Features einer vorhandenen Anwendung in Microsoft Teams führt häufig zu einer erzwungenen oder unnatürlichen Benutzererfahrung, insbesondere in größeren Apps. Beginnen Sie mit den wirkungsvollsten Features und solchen, die sich natürlicher in Microsoft Teams integrieren. Sie können Benutzern erlauben, die Haupt-App zu starten und auf den vollständigen Featuresatz zuzugreifen.
Im Folgenden sind die Voraussetzungen für die Integration Ihrer App in Microsoft Teams aufgeführt.
- Ordnen Sie die Anwendungsfälle Ihrer App zu Funktionen der Microsoft Teams-Plattform zu.
- Bestimmen Sie die Einstiegspunkte Ihrer App. Ist sie für den persönlichen Gebrauch, für die Zusammenarbeit oder für beides bestimmt?
Grundlegendes zu SharePoint-Anforderungen und -Optionen
Integrationsszenarien: SharePoint
Um eine vorhandene SharePoint-Seite als Microsoft Teams-Registerkarte zu integrieren, müssen Sie Folgendes berücksichtigen:
- Es muss eine moderne SharePoint-Onlineseite sein.
- Derzeit werden nur persönliche Registerkarten unterstützt. Sie können Ihre Seite nicht als Kanalregisterkarte integrieren.
Alternativ können Sie eine Microsoft Teams-Registerkarte mit dem SharePoint-Framework erstellen.
Streben Sie Mehrinstanzenfähigkeit an.
Integrationsszenarien: Eigenständige Apps, Apps für die Zusammenarbeit, SharePoint
Wenn Ihre App von mehreren Organisationen verwendet wird, sollten Sie mehrinstanzenfähiges Hosting in Betracht ziehen. Es macht Ihr Produkt skalierbar und vereinfacht die Verteilung.
Überprüfen Ihrer APIs
Integrationsszenarien: Eigenständige Apps, Apps für die Zusammenarbeit
Die APIs und Datenstrukturen Ihrer App müssen die App bei der Integration in Microsoft Teams unterstützen. Um die Unterstützung zu erweitern, müssen Sie die APIs und Datenstrukturen mit Kontextinformationen zu Microsoft Teams für Identitätszuordnung, Deep-Link-Unterstützung und Integration von Microsoft Graph erweitern.
Erfahren Sie, wie Sie Kontext für Ihre Microsoft Teams-Registerkarte oder Ihren Bot abrufen.
Grundlegendes zu Authentifizierungsoptionen
Integrationsszenarien: Eigenständige Apps, Apps für die Zusammenarbeit, SharePoint
Microsoft Entra ID ist der Identitätsanbieter für Teams. Wenn Ihre App einen anderen Identitätsanbieter verwendet, müssen Sie entweder eine Identitätszuordnungsübung durchführen oder mit Microsoft Entra ID kombinieren.
Teams verfügt über Mechanismen für einmaliges Anmelden (Single Sign-On, SSO) mit Microsoft Entra ID für Drittanbieter-Apps. Darüber hinaus enthält sie Anleitungen für Authentifizierungsflüsse zu anderen Identitätsanbietern mithilfe von Standards wie OAuth und OpenID Connect, die als OIDC bezeichnet werden.
Wichtig
Die Drittanbieter-Apps sind in government community cloud (GCC) verfügbar, aber nicht für GCC-High und Department of Defense (DOD). Drittanbieter-Apps sind für GCC standardmäßig deaktiviert. Informationen zum Aktivieren von Drittanbieter-Apps für GCC finden Sie unter Verwalten von App-Berechtigungsrichtlinien und Verwalten von Apps.
Für SharePoint-Seiten können Sie nur SSO verwenden und keine weitere Microsoft Entra-ID hinzufügen, wenn SSO für eine andere App funktioniert, da die ID die SharePoint-App ist.
Erfahren Sie mehr über die Authentifizierung in Microsoft Teams.
Befolgen der Designrichtlinien für Microsoft Teams
Integrationsszenarien: Eigenständige Apps, Apps für die Zusammenarbeit
Achten Sie darauf, die Microsoft Teams-Designrichtlinien zu befolgen, um native Apps für Microsoft Teams zu erstellen. Sie können keine vorhandenen App-Inhalte zu einer Teams-Registerkarte migrieren. Weitere Informationen zum App-Design finden Sie unter Fluent Design System.
Maximieren von Deep Linking
Integrationsszenarien: Eigenständige Apps, Apps für die Zusammenarbeit, SharePoint
Sie können Links zu Informationen und Features in Teams erstellen. Verwenden Sie Deep-Links, um Ihre App mit Microsoft Teams zu verknüpfen, da so mehrere Teile einer App miteinander verknüpft werden, um eine nativere Microsoft Teams-Erfahrung zu ermöglichen.
Gehen Sie beim Senden von Nachrichten an Benutzer intelligent vor.
Integrationsszenarien: Eigenständige Apps, Apps für die Zusammenarbeit, SharePoint
Verwenden Sie in Ihrer Microsoft Teams-App für Multithreadunterhaltungen einen Bot, da dieser mehr Flexibilität als ein Webhook bietet.
Bots ermöglichen Ihnen auch , proaktive Nachrichten an einzelne Benutzer oder Kanäle zu senden. Bei den proaktiven Nachrichten handelt es sich um nicht angeforderte Nachrichten, die durch ein externes Ereignis ausgelöst werden, und nicht um Nachrichten, die an einen Bot gesendet werden. Ihr Bot sendet beispielsweise eine Begrüßungsnachricht, wenn er installiert ist oder ein neuer Benutzer einem Kanal beitritt.
Das Senden proaktiver Nachrichten erfordert Microsoft Teams-spezifische Bezeichner. Sie können die Informationen erfassen, indem Sie Listen- oder Benutzerprofildaten abrufen, Unterhaltungsereignisse abonnieren oder Microsoft Graph verwenden.
Spamen Sie benutzer nicht mit übermäßigen Nachrichten. Wenn die Microsoft Teams-Funktion dies unterstützt, können die Benutzer Benachrichtigungseinstellungen für Ihre App konfigurieren. Es folgt ein Beispiel für eine Benachrichtigung: Senden Sie mir keine nicht angeforderten Nachrichten.
Verwenden von SharePoint für Datei- und Datenspeicherung
Integrationsszenarien: Eigenständige Apps, Apps für die Zusammenarbeit, SharePoint-Seiten
Bei der Erstellung eines Teams wird auch eine SharePoint-Websitesammlung bereitgestellt, um die Speicherung von Dateien und Daten für dieses Team zu unterstützen. Ihre App muss dieses Feature nutzen, wenn mit Dateien interagiert wird. Verwenden Sie die Websitesammlung, um Rohdaten in SharePoint-Listen und Microsoft Excel zu speichern.