Collega il tuo account Microsoft Teams a Goodweek per gestire canali, messaggi, chat, riunioni, team e la pianificazione dei turni direttamente dal tuo spazio di lavoro IA.
ℹ️ Nota sulla governance
Goodweek non supererà mai i livelli di accesso concessi all'utente all'interno di Microsoft Teams, garantendo così l'allineamento con le policy di governance della tua organizzazione. I risultati e le funzionalità disponibili possono variare in base alle autorizzazioni specifiche e all'accesso autenticato di ciascun utente.
📋 Prerequisiti
Prima che un utente possa vedere e collegare l'integrazione Microsoft Teams, l'amministratore della tua organizzazione deve prima abilitarla dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.
Configurazione amministratore
L'integrazione Microsoft Teams utilizza Microsoft OAuth 2.0 tramite Microsoft Entra ID. Per consentire agli utenti di collegarsi, un amministratore del tenant Microsoft Entra deve concedere il consenso amministratore per l'applicazione. Senza questo passaggio, gli utenti potrebbero visualizzare un errore di autorizzazione durante il processo di connessione.
Esistono tre scenari tipici a seconda della configurazione del tuo Entra ID:
Il consenso amministratore è già stato concesso. Gli utenti possono collegarsi direttamente senza passaggi aggiuntivi.
Il consenso utente è disattivato nel tuo tenant. Un amministratore Entra deve concedere il consenso per conto dell'organizzazione prima che gli utenti possano collegarsi. Vai su Microsoft Entra admin center → Enterprise Applications → Composio → Permissions → Grant admin consent for [la tua organizzazione].
L'accesso ai dati di Teams o di messaggistica è limitato a livello di risorsa. A seconda delle policy Teams della tua organizzazione, potrebbe essere necessario configurare autorizzazioni aggiuntive prima che l'integrazione possa accedere ai contenuti di canali o chat.
⚠️ Importante: caso particolare della sessione amministratore Microsoft
Se un amministratore del tenant Microsoft Entra completa personalmente il flusso di connessione OAuth, Microsoft potrebbe applicare automaticamente il consenso amministratore e collegare l'integrazione all'account dell'amministratore anziché al suo account utente individuale. Si tratta di un comportamento di Microsoft che non può essere modificato a livello OAuth.
Approccio consigliato: L'amministratore dovrebbe pre-approvare l'app in Entra ID (Enterprise Applications → Composio → Permissions → Grant admin consent for your organization) prima che qualsiasi utente, incluso l'amministratore, esegua il flusso di connessione Goodweek. Una volta pre-approvata, qualsiasi utente, incluso l'amministratore, può completare il flusso e l'integrazione verrà collegata al suo account individuale.
In alternativa, un utente non amministratore può completare per primo il flusso di connessione per evitare questo problema.
Connessione dell'utente
In Goodweek, vai su Integrazioni.
Trova Microsoft Teams e fai clic su Connetti.
Verrai reindirizzato a Microsoft, dove ti verrà chiesto di accedere con il tuo account Microsoft e autorizzare l'accesso.
Fai clic su Accetta per concedere l'accesso e tornare a Goodweek.
Note importanti
Ogni utente deve collegare il proprio account individualmente.
Goodweek può accedere solo ai team, canali e chat che il tuo account individuale ha il permesso di vedere. I canali privati e i contenuti limitati seguono i controlli di accesso di Teams.
Puoi revocare l'accesso di Goodweek in qualsiasi momento da Microsoft account → My Account → Privacy → Apps and services → Composio → Remove access.
Strumenti disponibili
Strumento | Descrizione | Tipo |
List Teams | Recupera i team Microsoft Teams accessibili all'utente autenticato, con filtraggio opzionale. | Lettura |
Get Team | Recupera i dettagli completi di un team specifico tramite il suo ID. | Lettura |
Create Team | Crea un nuovo team Microsoft Teams con modello, canali e membri opzionali. | Scrittura |
Update Team | Aggiorna le impostazioni del team, come le autorizzazioni di membri, messaggistica, funzioni ludiche e ospiti. | Scrittura |
Archive Teams Team | Archivia un team Microsoft Teams per rimuoverlo dalla visualizzazione attiva mantenendo i suoi dati. | Scrittura |
Unarchive Teams Team | Ripristina un team Microsoft Teams archiviato allo stato attivo. | Scrittura |
Clone Team | Crea una copia di un team Microsoft Teams esistente. | Lettura |
List Team Channels | Recupera i canali di un team Microsoft Teams specificato, con filtraggio opzionale. | Lettura |
Get Team Channel | Recupera i dettagli di un canale specifico all'interno di un team. | Lettura |
Create a Channel | Crea un nuovo canale standard, privato o condiviso all'interno di un team Microsoft Teams. | Scrittura |
Update Teams Channel | Aggiorna le proprietà del canale, come il nome visualizzato e la descrizione. | Scrittura |
Archive Channel | Archivia un canale all'interno di un team Microsoft Teams. | Scrittura |
Unarchive Channel | Ripristina un canale archiviato allo stato attivo. | Scrittura |
List Channel Messages | Elenca i messaggi in un canale Teams quando sono noti l'ID del team e l'ID del canale. | Lettura |
Get Teams Channel Message | Recupera un messaggio specifico da un canale Microsoft Teams tramite gli ID di team, canale e messaggio. | Lettura |
Send Channel Message | Pubblica un nuovo messaggio di primo livello in un canale Microsoft Teams. | Scrittura |
Reply to Teams Channel Message | Invia una risposta a un messaggio esistente all'interno di un canale specifico. | Scrittura |
List Channel Message Replies | Elenca tutte le risposte a un messaggio specifico in un canale Teams. | Lettura |
Search Teams Messages | Cerca i messaggi Microsoft Teams utilizzando la sintassi KQL, inclusi filtri per mittente, data e allegato. | Lettura |
Get All Chats | Elenca le chat Microsoft Teams di un utente specificato, con filtraggio opzionale. | Lettura |
Get Chat | Recupera i dettagli di una chat specifica tramite il suo ID. | Lettura |
Create Chat | Crea una nuova chat. Se esiste già una chat individuale con i membri specificati, ne restituisce i dettagli. | Scrittura |
Send Message to Teams Chat | Invia un messaggio (testo o HTML) a una chat Microsoft Teams esistente. | Scrittura |
List User Chat Messages | Recupera i messaggi di una chat specifica per un determinato utente. | Lettura |
List Pinned Messages | Recupera l'elenco dei messaggi fissati in una chat Microsoft Teams. | Lettura |
Pin Message in Chat | Fissa un messaggio in una chat Microsoft Teams per un rapido riferimento. | Lettura |
List Team Members | Elenca i membri di un team Microsoft Teams specifico. | Lettura |
Get Team Member | Recupera i dettagli di un membro specifico del team tramite il suo ID di appartenenza. | Lettura |
Add Member to Team | Aggiunge un utente a un team Microsoft Teams. | Scrittura |
Add Team Members (Bulk) | Aggiunge più membri a un team Microsoft Teams in un'unica operazione. | Scrittura |
Update Team Member | Aggiorna il ruolo o le proprietà di un membro del team all'interno del team. | Scrittura |
Add Member to Channel | Aggiunge un utente a un canale Microsoft Teams. | Scrittura |
List Users | Elenca tutti gli utenti dell'organizzazione tramite Microsoft Graph, con filtraggio opzionale. | Lettura |
List User Joined Teams | Elenca i team Teams di cui un utente specificato è membro diretto. | Lettura |
Get User Profile | Recupera il profilo di un utente, inclusi ID, UPN, email e nome visualizzato. | Lettura |
Get User Presence | Recupera le informazioni sulla presenza attuale di un utente, inclusi disponibilità e stato di attività. | Lettura |
Create Online Meeting | Pianifica una nuova riunione online autonoma di Microsoft Teams non collegata a un evento del calendario. | Scrittura |
Get Online Meeting | Recupera i dettagli di una specifica riunione online di Microsoft Teams tramite il suo ID. | Lettura |
Update Online Meeting | Aggiorna le proprietà di una riunione online esistente di Microsoft Teams. | Scrittura |
List Meeting Transcripts | Elenca tutte le trascrizioni associate a una specifica riunione online di Microsoft Teams. | Lettura |
Get Meeting Transcript Content | Recupera il contenuto testuale grezzo di una trascrizione di riunione Microsoft Teams. | Lettura |
List Meeting Recordings | Elenca le registrazioni di una riunione online Microsoft Teams pianificata e non scaduta. | Lettura |
Get Meeting Recording Content | Recupera fino a 256 MiB di contenuto video per una registrazione di riunione Teams. | Lettura |
Search Teams Files | Cerca file in Microsoft Teams utilizzando la sintassi KQL per nome, tipo, contenuto o autore. | Lettura |
Get Channel Files Folder | Recupera i metadati della cartella dei file per un canale specifico in un team Teams. | Lettura |
List Shifts | Elenca tutti i turni del calendario di un team, con filtraggio opzionale per data. | Lettura |
Create Team Schedule Shift | Crea un nuovo turno di lavoro nel calendario di un team Microsoft Teams. | Scrittura |
Create Time Off | Crea una nuova voce di permesso approvata nel calendario di un team. | Scrittura |
Create Time Off Request | Crea una nuova richiesta di permesso nel calendario di un team per un membro del team. | Scrittura |
List Time Off Requests | Elenca tutte le richieste di permesso dal calendario di un team Microsoft Teams. | Lettura |
Add Tab to Channel | Aggiunge una nuova scheda (app o sito web) a un canale Microsoft Teams. | Scrittura |
List Channel Tabs | Elenca tutte le schede configurate in un canale Microsoft Teams. | Lettura |
Delete Teams Team | Elimina definitivamente un team Microsoft Teams. | ⚠️ Distruttivo |
Delete Team Channel | Elimina definitivamente un canale da un team Microsoft Teams. | ⚠️ Distruttivo |
Soft-delete Teams Channel Message | Elimina in modo reversibile un messaggio in un canale Teams senza rimuoverlo definitivamente. | ⚠️ Distruttivo |
Remove Team Member | Rimuove un utente da un team Microsoft Teams. | ⚠️ Distruttivo |
Remove Chat Member | Rimuove un membro da una conversazione di chat Microsoft Teams. | ⚠️ Distruttivo |
Delete User Online Meeting | Elimina definitivamente una riunione online dall'account di un utente. | ⚠️ Distruttivo |
Casi d'uso
Invia messaggi e gestisci le conversazioni dei canali. Pubblica messaggi nei canali Teams o invia messaggi nelle chat direttamente dalle conversazioni Goodweek, mantenendo la comunicazione nel contesto del resto del lavoro senza passare a Teams.
Recupera trascrizioni e registrazioni delle riunioni. Accedi al contenuto della trascrizione o della registrazione di una riunione Teams passata da Goodweek per estrarre azioni da intraprendere, riassumere discussioni o fare riferimento a decisioni specifiche.
Gestisci l'appartenenza al team e i canali. Aggiungi o rimuovi membri del team, crea nuovi canali e aggiorna le proprietà dei canali da Goodweek per mantenere organizzate le strutture del team senza navigare nell'interfaccia di amministrazione di Teams.
Pianifica le riunioni e gestisci la pianificazione dei turni. Crea riunioni online, gestisci i calendari del team e gestisci le richieste di permesso da Goodweek per coordinare il lavoro del team in modo efficiente.
Risoluzione dei problemi
Errore di autorizzazione durante la connessione
Il tuo amministratore del tenant Microsoft Entra potrebbe dover concedere il consenso per l'applicazione. Chiedi al tuo amministratore di seguire i passaggi di Configurazione amministratore sopra riportati prima di provare a riconnetterti.
Integrazione connessa ma i canali privati non sono visibili
I canali privati di Microsoft Teams sono accessibili solo ai loro membri. Se non sei membro di un canale privato, non apparirà tramite l'integrazione. Chiedi al proprietario del canale di aggiungerti.
L'integrazione non è visibile in Goodweek
Assicurati che l'amministratore della tua organizzazione abbia abilitato l'integrazione Microsoft Teams dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.