Zum Hauptinhalt springen

Microsoft-Teams-Integration - Einrichtungsanleitung

Verbinde dein Microsoft Teams-Konto mit Goodweek, um Kanäle, Nachrichten, Chats, Besprechungen, Teams und die Schichtplanung direkt aus deinem KI-Arbeitsbereich zu verwalten.

A
Verfasst von Antoine Stempien

Verbinde dein Microsoft Teams-Konto mit Goodweek, um Kanäle, Nachrichten, Chats, Meetings, Teams und die Schichtplanung direkt aus deinem KI-Arbeitsbereich zu verwalten.

ℹ️ Hinweis zur Governance

Goodweek überschreitet niemals die Zugriffsrechte, die dem Nutzer innerhalb von Microsoft Teams gewährt wurden, und gewährleistet so die Übereinstimmung mit den Governance-Richtlinien deiner Organisation. Ergebnisse und verfügbare Funktionen können je nach den spezifischen Berechtigungen und dem authentifizierten Zugriff jedes Nutzers variieren.

📋 Voraussetzungen

Bevor ein Nutzer die Microsoft Teams-Integration sehen und verbinden kann, muss dein Organisationsadministrator sie zunächst im Goodweek Admin-Panel unter dem Reiter Integrationen aktivieren.

Admin-Einrichtung

Die Microsoft Teams-Integration verwendet Microsoft OAuth 2.0 über Microsoft Entra ID. Damit sich Nutzer verbinden können, muss ein Microsoft Entra-Mandantenadministrator die Administratoreinwilligung für die Anwendung erteilen. Ohne diesen Schritt kann während des Verbindungsvorgangs ein Berechtigungsfehler bei Nutzern auftreten.

Es gibt drei typische Szenarien, abhängig von deiner Entra-ID-Konfiguration:

  1. Die Administratoreinwilligung wurde bereits erteilt. Nutzer können sich direkt ohne zusätzliche Schritte verbinden.

  2. Die Nutzereinwilligung ist in deinem Mandanten deaktiviert. Ein Entra-Administrator muss die Einwilligung im Namen der Organisation erteilen, bevor sich Nutzer verbinden können. Gehe zu Microsoft Entra admin center → Enterprise Applications → Composio → Permissions → Grant admin consent for [deine Organisation].

  3. Der Zugriff auf Teams- oder Nachrichtendaten ist auf Ressourcenebene eingeschränkt. Je nach den Teams-Richtlinien deiner Organisation müssen möglicherweise zusätzliche Berechtigungen konfiguriert werden, bevor die Integration auf Kanal- oder Chatinhalte zugreifen kann.

⚠️ Wichtig: Sonderfall Microsoft-Admin-Sitzung

Wenn ein Microsoft Entra-Mandantenadministrator den OAuth-Verbindungsvorgang selbst durchführt, wendet Microsoft die Administratoreinwilligung möglicherweise automatisch an und verknüpft die Integration mit dem Administratorkonto statt mit dessen individuellem Nutzerkonto. Dies ist ein Microsoft-Verhalten und kann auf OAuth-Ebene nicht geändert werden.

Empfohlenes Vorgehen: Der Administrator sollte die App in Entra ID vorab genehmigen (Enterprise Applications → Composio → Permissions → Grant admin consent for your organization), bevor irgendein Nutzer — einschließlich des Administrators — den Goodweek-Verbindungsvorgang durchläuft. Nach der Vorabgenehmigung kann jeder Nutzer, einschließlich des Administrators, den Vorgang abschließen, und die Integration wird mit seinem individuellen Konto verknüpft.

Alternativ kann ein Nicht-Administrator den Verbindungsvorgang zuerst abschließen, um dieses Problem zu vermeiden.

Nutzerverbindung

  1. Gehe in Goodweek zu Integrationen.

  2. Suche Microsoft Teams und klicke auf Verbinden.

  3. Du wirst zu Microsoft weitergeleitet, wo du dich mit deinem Microsoft-Konto anmelden und den Zugriff autorisieren musst.

  4. Klicke auf Akzeptieren, um Zugriff zu gewähren und zu Goodweek zurückzukehren.

Wichtige Hinweise

  • Jeder Nutzer muss sein eigenes Konto individuell verbinden.

  • Goodweek kann nur auf die Teams, Kanäle und Chats zugreifen, für die dein individuelles Konto berechtigt ist. Private Kanäle und eingeschränkte Inhalte unterliegen den Teams-Zugriffskontrollen.

  • Du kannst den Zugriff von Goodweek jederzeit über Microsoft account → My Account → Privacy → Apps and services → Composio → Remove access widerrufen.


Verfügbare Tools

Tool

Beschreibung

Typ

List Teams

Ruft die für den authentifizierten Nutzer zugänglichen Microsoft Teams ab, mit optionaler Filterung.

Lesen

Get Team

Ruft die vollständigen Details eines bestimmten Teams anhand seiner ID ab.

Lesen

Create Team

Erstellt ein neues Microsoft Teams-Team mit optionaler Vorlage, Kanälen und Mitgliedern.

Schreiben

Update Team

Aktualisiert Teameinstellungen wie Mitglieder-, Nachrichten-, Fun- und Gastberechtigungen.

Schreiben

Archive Teams Team

Archiviert ein Microsoft Teams-Team, um es aus der aktiven Ansicht zu entfernen, während seine Daten erhalten bleiben.

Schreiben

Unarchive Teams Team

Stellt ein archiviertes Microsoft Teams-Team wieder in den aktiven Zustand zurück.

Schreiben

Clone Team

Erstellt eine Kopie eines vorhandenen Microsoft Teams-Teams.

Lesen

List Team Channels

Ruft die Kanäle eines angegebenen Microsoft Teams-Teams ab, mit optionaler Filterung.

Lesen

Get Team Channel

Ruft die Details eines bestimmten Kanals innerhalb eines Teams ab.

Lesen

Create a Channel

Erstellt einen neuen Standard-, privaten oder freigegebenen Kanal innerhalb eines Microsoft Teams-Teams.

Schreiben

Update Teams Channel

Aktualisiert Kanaleigenschaften wie Anzeigename und Beschreibung.

Schreiben

Archive Channel

Archiviert einen Kanal innerhalb eines Microsoft Teams-Teams.

Schreiben

Unarchive Channel

Stellt einen archivierten Kanal wieder in den aktiven Zustand zurück.

Schreiben

List Channel Messages

Listet Nachrichten in einem Teams-Kanal auf, wenn Team-ID und Kanal-ID bekannt sind.

Lesen

Get Teams Channel Message

Ruft eine bestimmte Nachricht aus einem Microsoft Teams-Kanal anhand von Team-, Kanal- und Nachrichten-IDs ab.

Lesen

Send Channel Message

Veröffentlicht eine neue Top-Level-Nachricht in einem Microsoft Teams-Kanal.

Schreiben

Reply to Teams Channel Message

Sendet eine Antwort auf eine vorhandene Nachricht innerhalb eines bestimmten Kanals.

Schreiben

List Channel Message Replies

Listet alle Antworten auf eine bestimmte Nachricht in einem Teams-Kanal auf.

Lesen

Search Teams Messages

Durchsucht Microsoft Teams-Nachrichten mithilfe der KQL-Syntax, einschließlich Filtern für Absender, Datum und Anhang.

Lesen

Get All Chats

Listet die Microsoft Teams-Chats eines angegebenen Nutzers auf, mit optionaler Filterung.

Lesen

Get Chat

Ruft die Details eines bestimmten Chats anhand seiner ID ab.

Lesen

Create Chat

Erstellt einen neuen Chat. Wenn bereits ein Einzelchat mit den angegebenen Mitgliedern existiert, werden dessen Details zurückgegeben.

Schreiben

Send Message to Teams Chat

Sendet eine Nachricht (Text oder HTML) an einen vorhandenen Microsoft Teams-Chat.

Schreiben

List User Chat Messages

Ruft Nachrichten aus einem bestimmten Chat für einen angegebenen Nutzer ab.

Lesen

List Pinned Messages

Ruft die Liste der angehefteten Nachrichten in einem Microsoft Teams-Chat ab.

Lesen

Pin Message in Chat

Heftet eine Nachricht in einem Microsoft Teams-Chat für den schnellen Zugriff an.

Lesen

List Team Members

Listet die Mitglieder eines bestimmten Microsoft Teams-Teams auf.

Lesen

Get Team Member

Ruft die Details eines bestimmten Teammitglieds anhand seiner Mitgliedschafts-ID ab.

Lesen

Add Member to Team

Fügt einem Microsoft Teams-Team einen Nutzer hinzu.

Schreiben

Add Team Members (Bulk)

Fügt einem Microsoft Teams-Team mehrere Mitglieder in einem einzigen Vorgang hinzu.

Schreiben

Update Team Member

Aktualisiert die Rolle oder Eigenschaften eines Teammitglieds innerhalb des Teams.

Schreiben

Add Member to Channel

Fügt einem Microsoft Teams-Kanal einen Nutzer hinzu.

Schreiben

List Users

Listet alle Nutzer der Organisation über Microsoft Graph auf, mit optionaler Filterung.

Lesen

List User Joined Teams

Listet die Teams auf, denen ein angegebener Nutzer direkt als Mitglied angehört.

Lesen

Get User Profile

Ruft das Profil eines Nutzers ab, einschließlich ID, UPN, E-Mail und Anzeigename.

Lesen

Get User Presence

Ruft die aktuellen Anwesenheitsinformationen eines Nutzers ab, einschließlich Verfügbarkeit und Aktivitätsstatus.

Lesen

Create Online Meeting

Plant ein neues eigenständiges Microsoft Teams-Onlinemeeting, das nicht mit einem Kalenderereignis verknüpft ist.

Schreiben

Get Online Meeting

Ruft die Details eines bestimmten Microsoft Teams-Onlinemeetings anhand seiner ID ab.

Lesen

Update Online Meeting

Aktualisiert die Eigenschaften eines vorhandenen Microsoft Teams-Onlinemeetings.

Schreiben

List Meeting Transcripts

Listet alle Transkripte auf, die mit einem bestimmten Microsoft Teams-Onlinemeeting verknüpft sind.

Lesen

Get Meeting Transcript Content

Ruft den reinen Textinhalt eines Microsoft Teams-Meeting-Transkripts ab.

Lesen

List Meeting Recordings

Listet Aufzeichnungen für ein geplantes, nicht abgelaufenes Microsoft Teams-Onlinemeeting auf.

Lesen

Get Meeting Recording Content

Ruft bis zu 256 MiB Videoinhalt für eine Teams-Meeting-Aufzeichnung ab.

Lesen

Search Teams Files

Durchsucht Dateien in Microsoft Teams mithilfe der KQL-Syntax nach Name, Typ, Inhalt oder Autor.

Lesen

Get Channel Files Folder

Ruft die Metadaten des Dateiordners für einen bestimmten Kanal in einem Teams-Team ab.

Lesen

List Shifts

Listet alle Schichten im Zeitplan eines Teams auf, mit optionaler Datumsfilterung.

Lesen

Create Team Schedule Shift

Erstellt eine neue Arbeitsschicht im Zeitplan eines Microsoft Teams-Teams.

Schreiben

Create Time Off

Erstellt einen neuen genehmigten Abwesenheitseintrag im Zeitplan eines Teams.

Schreiben

Create Time Off Request

Erstellt einen neuen Abwesenheitsantrag im Zeitplan eines Teams für ein Teammitglied.

Schreiben

List Time Off Requests

Listet alle Abwesenheitsanträge aus dem Zeitplan eines Microsoft Teams-Teams auf.

Lesen

Add Tab to Channel

Fügt einem Microsoft Teams-Kanal eine neue Registerkarte (App oder Website) hinzu.

Schreiben

List Channel Tabs

Listet alle in einem Microsoft Teams-Kanal konfigurierten Registerkarten auf.

Lesen

Delete Teams Team

Löscht ein Microsoft Teams-Team dauerhaft.

⚠️ Destruktiv

Delete Team Channel

Löscht einen Kanal aus einem Microsoft Teams-Team dauerhaft.

⚠️ Destruktiv

Soft-delete Teams Channel Message

Löscht eine Nachricht in einem Teams-Kanal reversibel, ohne sie dauerhaft zu entfernen.

⚠️ Destruktiv

Remove Team Member

Entfernt einen Nutzer aus einem Microsoft Teams-Team.

⚠️ Destruktiv

Remove Chat Member

Entfernt ein Mitglied aus einer Microsoft Teams-Chatunterhaltung.

⚠️ Destruktiv

Delete User Online Meeting

Löscht ein Onlinemeeting dauerhaft aus dem Konto eines Nutzers.

⚠️ Destruktiv

Anwendungsfälle

  • Sende Nachrichten und verwalte Kanalunterhaltungen. Veröffentliche Nachrichten in Teams-Kanälen oder sende Nachrichten in Chats direkt aus Goodweek-Unterhaltungen und halte die Kommunikation im Kontext der übrigen Arbeit, ohne zu Teams zu wechseln.

  • Rufe Meeting-Transkripte und -Aufzeichnungen ab. Greife von Goodweek aus auf den Transkript- oder Aufzeichnungsinhalt eines vergangenen Teams-Meetings zu, um Aufgaben zu extrahieren, Diskussionen zusammenzufassen oder auf bestimmte Entscheidungen zu verweisen.

  • Verwalte Teammitgliedschaften und Kanäle. Füge Teammitglieder aus Goodweek hinzu oder entferne sie, erstelle neue Kanäle und aktualisiere Kanaleigenschaften, um Teamstrukturen organisiert zu halten, ohne die Teams-Admin-Oberfläche zu nutzen.

  • Plane Meetings und verwalte die Schichtplanung. Erstelle Onlinemeetings, verwalte Teamzeitpläne und bearbeite Abwesenheitsanträge von Goodweek aus, um die Arbeit im Team effizient zu koordinieren.


Fehlerbehebung

Berechtigungsfehler bei der Verbindung

Möglicherweise muss dein Microsoft Entra-Mandantenadministrator die Einwilligung für die Anwendung erteilen. Bitte deinen Administrator, die obigen Schritte der Admin-Einrichtung zu befolgen, bevor du eine erneute Verbindung versuchst.

Integration verbunden, aber private Kanäle sind nicht sichtbar

Private Kanäle in Microsoft Teams sind nur für ihre Mitglieder zugänglich. Wenn du kein Mitglied eines privaten Kanals bist, wird dieser nicht über die Integration angezeigt. Bitte den Kanalbesitzer, dich hinzuzufügen.

Integration in Goodweek nicht sichtbar

Stelle sicher, dass dein Organisationsadministrator die Microsoft Teams-Integration im Goodweek Admin-Panel unter dem Reiter Integrationen aktiviert hat.

Referenzen

Hat dies deine Frage beantwortet?