Teilen über

Überlegungen zur Microsoft Teams-Integration

  • Artikel

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

Wichtig

Microsoft 365-Connectors (früher Office 365 Connectors genannt) werden bald eingestellt, und die Erstellung neuer Microsoft 365-Connectors wird bald blockiert. Weitere Informationen zum Zeitplan und dazu, wie die Workflows-App eine flexiblere und sicherere Erfahrung bietet, finden Sie unter Einstellung von Microsoft 365-Connectors in Microsoft Teams.

Wie können Sie einen Webhook in Teams erstellen?

Wenn Sie bereits Office 365 Connectors erstellt haben:

  • Erstellen eines Power Automate-Connectors: Power Automate verbessert die weit verbreiteten Workflows-Apps in Teams. Dies ist der skalierbare und sichere Ansatz zum programmgesteuerten Übertragen von Daten in und aus Teams. Wenn Sie diese Methode verwenden, können Sie Workflowvorlagen zum Veröffentlichen von Warnungen aus Ihrem Produkt in Teams-Kanälen erstellen. Dieser Ansatz vereinfacht die Benutzereinführung der neuen Methode. Weitere Informationen finden Sie unter Power Automate für Unternehmensentwickler, ISVs und Partner.

  • Aktualisieren Ihrer Teams-App: Sie können Ihre aktuelle Teams-App verbessern. Beispielsweise können Sie Benutzern ermöglichen, proaktive Nachrichten basierend auf Triggerereignissen in Ihrem System einzurichten. Weitere Informationen finden Sie unter Wie Bots über proaktive Nachrichten in Kanälen posten können.

Bekannte Probleme

  • Die Workflows-App kann keine Beiträge in privaten Kanälen als Flow-Bot bereitstellen. Es kann jedoch im Namen eines Benutzers posten.
  • Workflows unterstützen nur adaptive Karten. Das ältere Nachrichtenformat Karte, das Office 365 Connectors verwenden, wird nicht unterstützt. Workflows unterstützen die Verwendung des Nachrichtenformats Karte nicht. Weitere Informationen finden Sie unter Konvertieren von Connectornachrichten Karte Format in adaptive Karte.
  • Workflows bieten keine Connectors von Drittanbietern wie DataDog und Jenkins an.
  • Workflows können nur in Ihrer Standardumgebung erstellt werden.

Einschränkungen

Workflows sind nur mit bestimmten Benutzern (als Besitzer des Workflows bezeichnet) und nicht mit einem Teams-Team oder -Kanal verknüpft. Workflows können verwaiste Flows werden, wenn kein Besitzer vorhanden ist, wenn keine Mitbesitzer zugewiesen sind. Um die Kontinuität im durch den Flow automatisierten Geschäftsprozess zu gewährleisten, können Administratoren einen oder mehrere Mitbesitzer hinzufügen und ihnen die vollständige Kontrolle über den Workflow gewähren. Sie können ggf. auch die Authentifizierung für Verbindungen hinzufügen und den Flow aktivieren, wenn er deaktiviert wurde. Weitere Informationen finden Sie unter Verwalten verwaister Flows.

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

Apps von Drittanbietern sind in Government Community Cloud (GCC) verfügbar, aber nicht für GCC High, Department of Defense (DoD) und Teams, die von 21Vianet betrieben werden. 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.

Siehe auch