Was sind Microsoft Teams-Apps?

  • 10 Minuten

Eine App, die auf der Microsoft Teams-Plattform basiert, erweitert den Microsoft Teams-Client (Web, Mobil und Desktop) um Web-Apps und Dienste, die Sie hosten. Die Teams-Plattform bietet eine umfassende und flexible Palette an Erweiterungspunkten, Benutzeroberflächen-Konstrukten und APIs, die Sie für das Erstellen Ihrer App nutzen können. Bei Ihrer App kann es sich um etwas derart einfaches wie das Einbetten Ihrer vorhandenen Website in eine Registerkarte für Ihr Team handeln oder um eine vielseitige App mit vollem Funktionsumfang, die Ihre Benutzer über die gesamte Bandbreite des Teams-Clients einbindet. Sie können zwischen der Integration einer vorhandenen App oder dem Erstellen einer neuen, vollständig auf Teams ausgerichteten Benutzeroberfläche wählen.

Mithilfe der Microsoft Teams-Plattform können Sie Ihre Dienste durch kontextspezifische Informationen ergänzen, die von den verschiedenen Microsoft Teams-APIs bereitgestellt werden, beispielsweise Informationen zu dem jeweiligen Team oder Kanal, in dem Ihre App installiert ist, oder zu Nachrichten, die als Auslöser für Ihre App gedient haben. Sie können Apps für einen einzelnen Benutzer, ein Team oder Ihre gesamte Organisation erstellen oder Ihre App im öffentlichen App-Store veröffentlichen, damit jeder sie verwenden kann.

Was macht eine Microsoft Teams-App aus?

Apps, die auf der Microsoft Teams-Plattform basieren, bestehen aus drei Hauptkomponenten:

  • Der Microsoft Teams-Client stellt die Erweiterungspunkte und Benutzeroberflächenelemente zur Verfügung, die von Ihrer App zur Beteiligung der Benutzer verwendet werden.
  • Ihr Teams-App-Paket wird in Microsoft Teams installiert. Es beinhaltet ein kleines Symbol, ein großes Symbol und eine JSON-Manifestdatei. Die Manifestdatei beinhaltet die Metadaten zu Ihrer App (wie den Namen der App, den Namen des Entwicklers usw.), die von Ihrer App verwendeten Erweiterbarkeitspunkte (wie Registerkarten und Messaging-Erweiterungen) sowie Verweise auf Ihre Webdienste, die Ihre App leistungsfähig machen (wie die ID für Ihren Bot oder die URL Ihrer Registerkarte).
  • Ihre Webdienste, die Sie hosten, stellen die APIs und die Logik bereit, die Ihre App unterstützen.

Es gilt zu berücksichtigen, dass die Microsoft Teams-Plattform kein Hosting-Dienst ist. Die Webdienste, die im Rahmen Ihrer App bereitgestellt werden, müssen von Ihnen gehostet werden und mittels HTTPS über das Internet zugänglich sein.

Wo kann ich den Teams-Client erweitern?

Es gibt mehrere Orte, an denen der Microsoft Teams-Client erweitert werden kann, damit Benutzer mit Ihrer App interagieren können. Je nach Szenario können Sie den Fokus auf einen einzelnen Erweiterungspunkt legen (beispielsweise einen persönlichen Unterhaltungs-Bot) oder mehrere Erweiterungspunkte kombinieren.

Teams, Kanäle und Gruppenchats

Über Teams, Kanäle und Gruppenchats können mehrere Personen zusammenarbeiten. Apps, die Kontext erweitern, stellen sich allen Mitgliedern einer Gruppe oder Teilnehmern einer Unterhaltung zur Verfügung, wobei ihr Fokus in der Regel auf der Aktivierung weiterer Workflows für die Zusammenarbeit oder das Entsperren neuer sozialer Interaktionen liegt. Ihrer App wird der Zugriff auf APIs erlaubt, die es Ihnen ermöglichen, Informationen zu den Teilnehmern einer Unterhaltung, zu den Kanälen eines Teams sowie Metadaten zu einem Team oder einer Unterhaltung abzurufen.

Apps können mithilfe der folgenden Elemente erweitert werden:

  • Konversations-, Anruf- und Online-Medienbots, die mit Gesprächsteilnehmern per Chat interagieren und auf Ereignisse reagieren (z. B. wenn ein neues Mitglied hinzugefügt oder ein Kanal umbenannt wird). Alle in diesem Kontext mit einem Bot geführten Unterhaltungen sind für alle Mitglieder eines Kanals oder einer Gruppe sichtbar, weshalb Sie sicherstellen müssen, dass die Unterhaltung für jeden relevant ist.
  • Kanal- und Gruppenchat-Registerkarten bieten eine eingebettete Vollbild-Weboberfläche, die für den Kanal oder Gruppenchat konfiguriert ist, in dem er installiert ist. Alle Mitglieder interagieren über dieselbe freigegebenen Web-App, weshalb eine zustandslose Einzelseiten-App-Oberfläche üblich ist.
  • Webhooks und Connectors , die es externen Diensten ermöglichen, Nachrichten an die Konversation zu senden. Sie können die Vorteile von Karten und Kartenaktionen nutzen, um umfangreiche, Aktionen erfordernde Nachrichten zu erstellen. Webhooks bieten eine einfache, nicht authentifizierte Einweg-Möglichkeit zum Veröffentlichen von Nachrichten in einem Kanal, während Connectors eine etwas stabilere Oberfläche für Unterhaltungen in beide Richtungen bieten.

Persönliche Apps

Persönliche Apps sind diejenigen Ihrer Teams-Apps, die sich auf Interaktionen mit einem einzelnen Benutzer konzentriert. Die Benutzererfahrung ist für jeden Benutzer einzigartig. Dieser Teil Ihrer App lässt sich an der linken Navigationsleiste anheften, sodass Ihre Benutzer mit einem einzigen Klick darauf zugreifen können.

Sie können folgende Elemente beinhalten:

  • Konversations-, Anruf- und Onlinemedienbots, die eine 1:1-Konversation mit dem Benutzer führen. Da es sich dabei um eine private Unterhaltung handelt, empfiehlt es sich, diese Interaktion dann in einer persönlichen App umzusetzen, wenn Ihre App mit einem Benutzer eine Unterhaltung zu mehreren Themen führen muss, oder eine Benachrichtigung bereitstellen muss, die lediglich für einen einzelnen Benutzer relevant ist.
  • Persönliche Registerkarten bieten eine eingebettete Web-Benutzeroberfläche im Vollbildmodus.

Nachrichten

Nachrichten bilden das Herzstück der Zusammenarbeit in Teams. Mit einer Messaging-Erweiterung für Aktionsbefehle kann Ihre App Benutzern gestatten, die API Ihrer App aus einer Nachricht aufzurufen, sodass der Inhalt der Nachricht zur Verarbeitung oder das Durchführen einer Aktion an Ihre App gesendet wird. Ihre App kann antworten, indem sie dem Benutzer ein Formular (ein Aufgabenmodul) vorlegt, um weitere Informationen zu sammeln, eine Antwort auf die ursprüngliche Nachricht zu senden oder eine Nachricht direkt an den Benutzer zu senden.

Schreiben von Nachrichten

Ihre App kann Benutzern dabei helfen, effektivere Nachrichten zu erstellen, indem sie in einem externen System suchen oder Maßnahmen ergreifen und die Ergebnisse in ein umfangreiches System einfügen können.

Es gibt drei Möglichkeiten, wie Ihre App Benutzer dabei unterstützen kann, bessere Nachrichten zu erstellen:

  • Die Messaging-Erweiterung – Aktionsbefehle präsentiert Ihrem Benutzer ein modales Formular (ein Aufgabenmodul), übermittelt die im Formular erfassten Ergebnisse an Ihre App und fügt dann entweder eine Nachricht direkt in die Unterhaltung ein oder erstellt einen Teil einer Nachricht, die der Benutzer vor dem Senden an die Unterhaltung bearbeiten kann.
  • Die Messaging-Erweiterung – Suchbefehle ermöglicht Benutzern das schnelle Durchsuchen eines externen Systems, eine Vorschau auf Ergebnisse dieser Suche und das anschließende Einfügen von Ergebnissen in den Chat als umfangreiche Karte.
  • Die Messaging-Erweiterung – Verbreiten von Links ermöglicht Ihrer App das Überwachen der Webdomänen, an denen Sie interessiert sind. Wenn eine URL, die diese Domäne enthält, in das Feld „Nachricht verfassen“ eingefügt wird, wird die-API Ihrer App aufgerufen, sodass Sie der Nachricht eine umfangreiche Karte mit zusätzlichen Informationen zu dem verknüpften Element hinzufügen können.

Besprechungs-Apps

Besprechungen ermöglichen Zusammenarbeit, Partnerschaft, informierte Kommunikation und geteiltes Feedback. Die Besprechungs-App kann eine Benutzererfahrung für jede Phase des Besprechungslebenszyklus bereitstellen.

Der Besprechungslebenszyklus umfasst die App-Erfahrung vor der Besprechung, während der Besprechung und nach der Besprechung, abhängig vom Status des Teilnehmers.

Elemente der Benutzeroberfläche

Neben Erweiterungspunkten bietet die Microsoft Teams-Plattform auch flexible Benutzeroberflächenelemente für Apps, die von diesen genutzt werden können. Mit diesen Elementen können Sie umfassende Benutzeroberflächen erstellen, die dem Teams-Client wie systemeigene Oberflächen erscheinen.

Karten- und Kartenaktionen

Karten sind Benutzeroberflächencontainer, die von schematisierten JSON definiert wurden, die mehrere Eigenschaften und Anlagen beinhalten können. Sie können formatierten Text, Medien, Steuerelemente (z. B. Dropdownfelder und Optionsfelder) sowie Schaltflächen, die Kartenaktionen auslösen, beinhalten. Kartenaktionen können Nutzlasten zur API Ihrer App senden, einen Link öffnen, Authentifizierungsabläufe starten oder Nachrichten an Unterhaltungen senden. Die Microsoft Teams-Plattform unterstützt zahlreiche unterschiedliche Kartentypen, unter anderem adaptive Karten, Hero-Karten und Miniaturbild-Karten. Diese können zu Kartensammlungen kombiniert und in Form einer Liste oder eines Karussells angezeigt werden.

Aufgabenmodule (Dialogfelder)

Aufgabenmodule ermöglichen Ihnen das Erstellen von modalen Popup-Oberflächen in Ihrer Teams-Anwendung. Innerhalb des Popups können Sie Ihren eigenen benutzerdefinierten HTML/JavaScript-Code ausführen und einen <iframe> wie ein YouTube- oder Microsoft Stream-Video oder eine adaptive Karte anzeigen. Sie sind besonders hilfreich beim Starten und Abschließen von Aufgaben oder beim Anzeigen umfassender Informationen wie Videos oder Power BI-Dashboards. Eine Popup-Oberfläche ist für Benutzer, die Aufgaben starten und erledigen, im Vergleich zu einer Registerkarte oder einer auf Unterhaltungen basierenden Bot-Umgebung häufig natürlicher.

Ihre App kann URL für Deep-Links erstellen, die Ihren Benutzer und den Teams-Client beim Navigieren in Ihrer App unterstützen. Sie können für die meisten Entitäten innerhalb von Teams Deep-Links erstellen, von denen einige (z. B. eine neue Besprechungsanfrage) Ihnen ermöglichen, Informationen mithilfe von Abfragezeichenfolgen in der URL im Voraus auszufüllen. So könnte beispielsweise Ihr Unterhaltungs-Bot eine Nachricht an einen Kanal mit einem Deep-Link für ein Aufgabenmodul senden, was dazu führt, dass eine Karte als 1:1-Nachricht an einen Benutzer gesendet wird, die wiederum einen Deep-Link für das Erstellen einer neuen Besprechung mit einem bestimmten Benutzer zu einem bestimmten Datum/einer bestimmten Uhrzeit beinhaltet. Verwenden Sie Deep-Links, um Verbindungen mit den verschiedenen Erweiterungspunkten herzustellen, die für Ihre App verfügbar sind, und so Ihre Benutzer im richtigen Kontext zu halten.

Web-Inhaltsseiten

Bei einer Web-Inhaltsseite handelt es sich um eine Webseite, die Sie hosten und die in eine Registerkarte oder ein Aufgabenmodul eingebettet werden kann. Damit Ihre Webseite in einen Microsoft Teams-Client eingebettet werden kann, müssen folgende Voraussetzungen erfüllt sein:

  • Auf einem HTTPS-Endpunkt gehostet werden.
  • Unterstützung, die vom Teams-Client in eine <iframe> eingebettet wird.
  • Sie muss das Microsoft Teams JavaScript-Client-SDK beinhalten und beim Laden der Seite dieinitialize()-Methode des SDK aufrufen.

Zusammenfassung

Eine Microsoft Teams-App ist dann eine Sammlung von Webdiensten, die extern in Microsoft Teams gehostet werden und die Erweiterungspunkte und BENUTZEROBERFLÄCHENelemente nutzt, die über die Microsoft Teams-Plattform zur Verfügung gestellt werden.