Verbringt ein Benutzer seinen Tag in Teams, genügt es, Geschäftsanwendungen wie Urlaubsanträge, Bestellfreigaben oder Servicetickets in einem separaten Browser-Tab öffnen zu lassen, damit diese Anwendung nicht genutzt wird. Aber „zu Teams hinzufügen“ ist kein einzelner Vorgang. Registerkarte, Bot, Nachrichtenerweiterung und Benachrichtigungsmechanismen lösen unterschiedliche Probleme und bringen unterschiedlichen Entwicklungs- und Verwaltungsaufwand mit sich. Wird die falsche Oberfläche gewählt, entsteht entweder unnötige Bot-Infrastruktur, oder der Benutzer muss für die Freigabe doch wieder in die Anwendung. Im Folgenden beschreiben wir, welche Oberfläche Sie bei der Integration einer bestehenden Webanwendung oder Power App in Teams wählen, welche Punkte in der Praxis am häufigsten brechen und wie Sie die Bereitstellung steuern.
App-Oberflächen in Teams
Eine Teams-App ist eigentlich ein App-Paket: ein ZIP aus der Datei manifest.json und zwei Icons (farbig und Kontur). Das Manifest definiert, welche Oberflächen die App nutzt; dasselbe Paket kann mehrere Oberflächen gemeinsam tragen, etwa eine persönliche Registerkarte und einen Bot.
- Persönliche Registerkarte (Static Tab): Eine benutzerspezifische Webseite, die über die linke App-Leiste geöffnet wird. Für Ansichten wie „Meine Anforderungen“ oder „Ausstehende Freigaben“.
- Kanal-/Gruppenregisterkarte (Configurable Tab): Eine Registerkarte, die einem Kanal, Chat oder Meeting hinzugefügt wird und deren Kontext über eine Konfigurationsseite gewählt wird. Für ein gemeinsames Team-Dashboard oder eine Projektansicht.
- Bot: Ein Dienst, der über den Chat Nachrichten empfängt und sendet. Stark bei proaktiven Benachrichtigungen und Aktionen direkt per Adaptive Card.
- Nachrichtenerweiterung (Message Extension): Wird aus dem Nachrichteneingabefeld oder aus dem Menü einer Nachricht aufgerufen. Die suchbasierte Variante wandelt einen Datensatz der App in eine Karte um und fügt sie in den Chat ein; die aktionsbasierte legt aus einer Nachricht einen Datensatz an. Auch die Linkvorschau (Link Unfurling) gehört zu dieser Oberfläche.
- Webhook- und Workflow-Benachrichtigungen: Nachrichten an einen Kanal ohne App-Paket. Für klassische Office-365-Connectors (einschließlich eingehender Webhooks) hat Microsoft einen Abkündigungsprozess angekündigt; bevorzugen Sie bei neuen Vorhaben Webhooks, die mit der App Workflows in Teams (auf Basis von Power Automate) erstellt werden, und prüfen Sie den aktuellen Zeitplan in der Microsoft-Dokumentation. Benachrichtigungen, die am alten Connector hängen, stoppen eines Tages stillschweigend.
Registerkarte, Bot und Nachrichtenerweiterung im Vergleich
| Oberfläche | Am besten geeignetes Szenario | Entwicklungsaufwand | Worauf zu achten ist |
|---|---|---|---|
| Persönliche Registerkarte | Bestehende Webanwendung in Teams öffnen | Niedrig | Frame-Berechtigungen (iframe), SSO |
| Kanalregisterkarte | Gemeinsame Ansicht im Teamkontext | Niedrig bis mittel | Konfigurationsseite, Daten nach Kontext |
| Bot | Benachrichtigung + Freigabe über Karte | Mittel–hoch | Bot-Registrierung, Messaging-Endpunkt, Zustandsverwaltung |
| Nachrichtenerweiterung | Datensatz im Chat teilen, Datensatz aus Nachricht anlegen | Mittel | Erfordert Bot-Infrastruktur |
| Workflows-Webhook | Einseitige Benachrichtigung an einen Kanal | Sehr gering | Rückmeldung nur eingeschränkt möglich |
Die Entscheidungsreihenfolge ist einfach. Arbeitet der Benutzer in der Anwendung, oder informiert die Anwendung den Benutzer über ein Ereignis? Ersteres braucht eine Registerkarte, Letzteres einen Benachrichtigungskanal. Erwartet die Benachrichtigung eine Entscheidung vom Benutzer (freigeben/ablehnen), bieten Bot und Adaptive Card zusammen das Erlebnis mit den wenigsten Klicks. Genügt es, einem Team „neuer Datensatz angelegt“ mitzuteilen, reicht ein Webhook; ein Bot ist unnötig. Eine Nachrichtenerweiterung erfüllt einen echten Zweck in Teams, in denen ständig Vorgangsnummern im Chat zirkulieren (Support, Vertrieb). In anderen Teams wird sie meist nicht genutzt.
Bestehende Webanwendung als Registerkarte hinzufügen
Eine Registerkarte ist eine gewöhnliche Webseite, die im Teams-Client in einem iframe geladen wird. Die häufigste Beschwerde in der Praxis ist „Die Registerkarte öffnet leer“, und die Ursache ist fast immer dieselbe: Die Anwendung verweigert das Öffnen im Frame. Eine Anwendung, die den Header X-Frame-Options: DENY oder SAMEORIGIN sendet, zeigt in Teams einen weißen Bildschirm. Stattdessen werden Teams- und Microsoft-365-Client-Domains über die Direktive frame-ancestors im Header Content-Security-Policy erlaubt. Übernehmen Sie die Domainliste nicht aus dem Gedächtnis, sondern aus der Teams-Entwicklerdokumentation; sie wächst mit den Microsoft-365-Apps. Prüfen Sie bei Anwendungen hinter Reverse Proxy oder WAF auch, ob der Header nicht von der Anwendung, sondern von der Zwischenschicht kommt.
Der zweite Schritt ist, dass die Seite die Teams-JavaScript-Clientbibliothek (@microsoft/teams-js) lädt und app.initialize() aufruft. Danach werden mit app.getContext() Kontextinformationen wie Design, Sprache, aktuelles Team und Kanal abgerufen. Mit diesem Kontext kann die Anwendung etwa in einer Kanalregisterkarte nur die Datensätze dieses Projekts zeigen. Ohne Initialize-Aufruf kommt kein Kontext.
Im Manifest sieht die Definition einer persönlichen Registerkarte etwa so aus. Die Werte sind Beispiele; der Kürze halber wurden Pflichtfelder wie developer, description, icons, accentColor weggelassen. Wählen Sie für manifestVersion die aktuelle Schemaversion, die Ihre Toolchain unterstützt, und lassen Sie das Paket die Validierung im Developer Portal durchlaufen.
{
"manifestVersion": "1.17",
"id": "00000000-0000-0000-0000-000000000000",
"version": "1.0.0",
"name": { "short": "Anfragezentrum", "full": "Anfragezentrum" },
"staticTabs": [
{
"entityId": "meine-anfragen",
"name": "Meine Anfragen",
"contentUrl": "https://anfragen.beispiel.de/teams/meine-anfragen",
"scopes": [ "personal" ]
}
],
"validDomains": [ "anfragen.beispiel.de" ],
"webApplicationInfo": {
"id": "<entra-app-client-id>",
"resource": "api://anfragen.beispiel.de/<entra-app-client-id>"
}
}
Auf Power-Apps-Seite laufen die meisten dieser Schritte automatisch: Die Option Zu Teams hinzufügen im App-Menü des Power-Apps-Portals fügt die App direkt hinzu oder lädt sie als Paket für den Administrator herunter. SharePoint-Seiten und -Listen werden ohne Code über die eingebaute SharePoint-Registerkarte von Teams hinzugefügt. Bei Eigenentwicklungen erleichtern Microsofts Werkzeuge (Teams Toolkit, neu Microsoft 365 Agents Toolkit) und das Teams Developer Portal die Bearbeitung und Validierung des Manifests.
SSO und Identität in Teams
Den Benutzer in einer Registerkarte ein zweites Mal zur Anmeldung aufzufordern, bedeutet Popup-Probleme im iframe und Beschwerden. Teams-Registerkarten-SSO löst das: Die Registerkarte ruft authentication.getAuthToken() auf, und der Teams-Client erzeugt mit der Entra-ID-Sitzung des Benutzers ein Zugriffstoken für Ihre App. Die Einrichtung umfasst fünf Schritte, und die meisten Fehler entstehen in den ersten drei.
- Legen Sie in Entra ID eine App-Registrierung an und definieren Sie den Application ID URI in der Form
api://<domain>/<client-id>. - Veröffentlichen Sie einen Bereich (Scope), meist
access_as_user. - Fügen Sie die Client-IDs der Teams-Desktop-/Mobil- und Teams-Web-Clients für diesen Bereich als vorautorisierte Clients hinzu; kopieren Sie die ID-Werte aus der Microsoft-Dokumentation, tippen Sie sie nicht ab.
- Tragen Sie dieselbe Client-ID und URI in das Feld
webApplicationInfodes Manifests ein. Ein einziges abweichendes Zeichen bricht SSO. - Prüfen Sie das Token serverseitig. Müssen Sie im Namen des Benutzers auf Microsoft Graph zugreifen, tauschen Sie dieses Token im On-Behalf-Of-Flow gegen ein Graph-Token; senden Sie das im Client empfangene Token nicht direkt an Graph.
Graph-Berechtigungen im engstmöglichen Umfang zu halten, verkürzt auch den Zustimmungsprozess; dieses Design beschreiben wir ausführlich im Leitfaden Microsoft-Graph-API-Berechtigungen. Soll die Anwendung auch außerhalb von Teams geöffnet werden, lesen Sie zur Nutzung derselben App-Registrierung mit OIDC den Beitrag OIDC-Anmeldung mit Entra ID.
App-Upload, Freigabe und Bereitstellungsrichtlinien
Interne Apps werden in Teams als „benutzerdefinierte App“ (Custom App) veröffentlicht und über das Teams Admin Center verwaltet. Das Paket vorzubereiten, ist die halbe Arbeit; wer es sieht, bestimmen Richtlinien.
- Upload: Das Paket wird im Teams Admin Center unter Teams-Apps > Apps verwalten in den Organisationskatalog hochgeladen. Ein Paket, das der Entwickler aus dem Teams-Client sendet, erzeugt dagegen eine Veröffentlichungsanfrage, die auf Freigabe durch den Administrator wartet.
- Zugriff: Wer die App nutzen darf, bestimmen App-Berechtigungsrichtlinien oder, falls in Ihrem Mandanten aktiv, die Einstellungen der app-zentrierten Verwaltung. Beginnen Sie mit einer Pilotgruppe; Probleme fangen Sie so in einem begrenzten Kreis ab.
- Anheften: App-Einrichtungsrichtlinien (Setup Policies) heften die App in der App-Leiste bestimmter Benutzer an und installieren sie vorab. Bei Apps mit Bot ist die Vorinstallation zusätzlich nötig; hat der Benutzer die App nie geöffnet, kommt keine proaktive Benachrichtigung an.
- Recht zum Hochladen benutzerdefinierter Apps: Ob ein Entwickler zum Testen ein Paket hochladen kann, hängt von der Einstellung zum Hochladen benutzerdefinierter Apps in der Einrichtungsrichtlinie ab. Vergeben Sie dieses Recht nicht allen Benutzern, sondern der Entwicklergruppe.
- Versionsupdate: Ein Paket, das ohne erhöhten Wert
versionim Manifest hochgeladen wird, wird nicht als Update erkannt. Ein Update mit geändertem Umfang oder geänderten Berechtigungen kann eine erneute Zustimmung des Benutzers anfordern.
Benachrichtigungsszenarien und Einschränkungen
Ein Großteil des Werts einer Geschäftsanwendung in Teams kommt aus Benachrichtigungen. Es gibt drei Hauptwege, und jeder beantwortet einen anderen Bedarf:
| Methode | Ziel | Anforderung |
|---|---|---|
| Workflows-Webhook | Kanal oder Chat | Power-Automate-Flow, Webhook-URL |
| Proaktive Bot-Nachricht | Person, Chat, Kanal | Bot-Registrierung, App muss beim Ziel installiert sein |
| Benachrichtigung im Aktivitätsfeed | Teams-Aktivitätsfeed des Benutzers | Graph sendActivityNotification, App muss beim Benutzer installiert sein |
Eine Webhook-URL ist ein Geheimnis: Jeder, der die URL kennt, kann Nachrichten an den Kanal senden. Halten Sie sie nicht im Klartext im Quellcode oder in einer Konfigurationsdatei, sondern in einem Schlüsseltresor. Klickt ein Benutzer in einer per Bot gesendeten Adaptive Card auf „Freigeben“, erfolgt der Vorgang in Ihrem Bot-Dienst. Prüfen Sie die Berechtigung der Person, die die Kartenaktion ausführt, serverseitig erneut; gehen Sie nicht davon aus, dass jeder Empfänger der Karte freigeben darf. Karten lassen sich weiterleiten.
Berücksichtigen Sie bekannte Einschränkungen von Anfang an im Design:
- Im mobilen Teams-Client ist der Platz für Registerkarten knapp; testen Sie die mobile Ansicht der Registerkartenseite separat.
- Eine Anwendung im iframe muss für Dateidownloads, neue Fenster und Authentifizierungs-Popups die Methoden des Teams JS SDK nutzen; sie verhält sich nicht wie im Browser.
- Gäste und externe Benutzer sehen die App nur, wenn die Richtlinien ihres eigenen Mandanten und Ihre App-Richtlinien es erlauben.
- Für Bot- und Webhook-Nachrichten gelten Ratenbegrenzungen von Microsoft; bei Massenbenachrichtigungen sind Warteschlange und Wiederholungslogik Pflicht.
Ein umgesetztes Modell, bei dem Anfragemanagement mit Teams verbunden ist, zeigt der Beitrag Helpdesk mit Microsoft 365 einrichten. Für die Übertragung interner Anwendungen nach Teams und die Benachrichtigungsarchitektur sehen Sie sich unsere Leistung Teams- und Unternehmensintegrationen an. Referenz für Manifest-Schema und aktuelle Fähigkeiten der Oberflächen ist die Microsoft-Teams-Entwicklerdokumentation.
Häufig gestellte Fragen
Ist für das Hinzufügen einer Power App zu Teams Entwicklung nötig?
Meist nicht. Die Option „Zu Teams hinzufügen“ im Power-Apps-Portal fügt die App als persönliche App hinzu oder erzeugt ein Paket, das der Administrator in den Organisationskatalog hochlädt. Werden eigene Benachrichtigungen, ein Bot oder eine Nachrichtenerweiterung gewünscht, ist zusätzliche Entwicklung nötig.
Meine Registerkarte erscheint in Teams leer – was sollte ich zuerst prüfen?
Prüfen Sie zuerst, ob die App einen X-Frame-Options-Header sendet und ob die Direktive frame-ancestors der Content-Security-Policy Teams-Domains zulässt. Prüfen Sie dann, ob die Seite die Teams-JS-Bibliothek lädt und app.initialize() aufruft und ob die Domain in der Liste validDomains des Manifests steht.
Sollte ich für Benachrichtigungen einen Bot oder einen Webhook verwenden?
Genügt eine einseitige Kanalbenachrichtigung, ist ein Workflows-basierter Webhook die schnellste Lösung. Sind personalisierte Benachrichtigungen, Freigaben über eine Karte oder Interaktion im Chat nötig, braucht es einen Bot. Ein Bot erfordert mehr Infrastruktur, aber der Benutzer erledigt den Vorgang, ohne Teams zu verlassen.
Was sieht der Benutzer, wenn SSO in einer Teams-Registerkarte nicht funktioniert?
Der Aufruf getAuthToken liefert einen Fehler. Die App sollte den Benutzer dann über die Authentifizierungsfenster-Methode von Teams zu einer interaktiven Anmeldung leiten. Häufigste Ursachen sind, dass Application ID URI und der Wert resource im Manifest nicht übereinstimmen und dass die Teams-Clients nicht vorautorisiert wurden.