Überlegungen zur Microsoft Teams-Integration

  • Artikel

Sie können Webanwendungen mit den sozialen und kollaborativen Funktionen von Microsoft Teams ausstatten, indem Sie sie richtig in Microsoft 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.
  • SharePoint: Eine SharePoint-Seite, die in Microsoft Teams angezeigt werden soll.

Sie können die für Ihr Integrationsszenario geeignete Richtlinie zuordnen und befolgen. Dieses Dokument bietet einen Überblick über Microsoft Teams-Funktionen, Share-Point-Anforderungen für die Datei- und Datenspeicherung, API-Anforderungen, Authentifizierung und Deep-Linking Ihrer App mit Microsoft 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.

  1. Ordnen Sie die Anwendungsfälle Ihrer App zu Funktionen der Microsoft Teams-Plattform zu.
  2. 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 Apps von Drittanbietern. 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

Derzeit sind Drittanbieter-Apps 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 einmaliges Anmelden verwenden und keine weitere Microsoft Entra-ID hinzufügen, wenn einmaliges Anmelden 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.

Siehe auch