Collega il tuo account Gmail a Goodweek per leggere, inviare e gestire le email direttamente dal tuo spazio di lavoro IA.
ℹ️ Nota sulla governance
Goodweek non supererà mai i livelli di accesso concessi all'utente all'interno di Gmail, garantendo 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 Gmail, l'amministratore della tua organizzazione deve prima abilitarla dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.
Configurazione amministratore
Account Google personali (@gmail.com)
Non è richiesta alcuna configurazione da parte dell'amministratore. Collegati direttamente seguendo i passaggi di Connessione utente riportati di seguito.
Account Google Workspace (lavoro o scuola)
A seconda della policy di accesso alle API della tua organizzazione, può applicarsi uno dei seguenti scenari.
Scenario 1 — Predefinito (accesso di terze parti senza restrizioni)
Qualsiasi utente può collegarsi direttamente senza l'intervento dell'amministratore.
Scenario 2 — L'accesso di terze parti è limitato (errore admin_policy_enforced)
Un Super Admin di Google Workspace deve contrassegnare Composio come app attendibile:
Accedi a admin.google.com come Super Admin.
Vai su Sicurezza → Controllo di accesso e dati → Controlli API → Gestisci l'accesso delle app di terze parti.
Fai clic su Configura nuova app, cerca Composio, selezionalo, imposta l'accesso su Attendibile e fai clic su Salva.
Scenario 3 — Tutto l'accesso di terze parti alle API è bloccato
Vai su admin.google.com → Sicurezza → Controlli API e controlla l'impostazione «Accesso delle app di terze parti alle API di Google». Se è bloccato, l'amministratore deve creare un'eccezione per Composio prima di seguire lo Scenario 2.
Connessione utente
In Goodweek, vai su Integrazioni.
Trova Gmail e fai clic su Connetti.
Verrai reindirizzato a Google, dove ti verrà chiesto di accedere.
Controlla le autorizzazioni richieste e fai clic su Consenti per tornare a Goodweek.
Note importanti
Ogni utente deve collegare il proprio account singolarmente.
Goodweek può accedere solo alle email e ai dati a cui il tuo account utente individuale ha accesso.
Se hai più account Google, assicurati di selezionare quello corretto durante il passaggio di collegamento. Google potrebbe preselezionare automaticamente l'ultimo account utilizzato.
I token OAuth di Gmail possono essere invalidati se l'amministratore del tuo Google Workspace modifica la durata della sessione o le policy di accesso alle API. Se l'integrazione smette di funzionare inaspettatamente, prova a disconnetterla e ricollegarla.
Puoi revocare l'accesso di Goodweek in qualsiasi momento da myaccount.google.com → Sicurezza → App di terze parti con accesso all'account.
Strumenti disponibili
Strumento | Descrizione | Tipo |
Send Email | Invia immediatamente un'email tramite l'API di Gmail utilizzando il nome visualizzato dell'utente autenticato. | Scrittura |
Reply to Email Thread | Invia una risposta all'interno di un thread Gmail specifico, mantenendo l'oggetto originale e il contesto del thread. | Scrittura |
Forward Email Message | Inoltra un messaggio Gmail esistente a destinatari specificati, mantenendo il corpo e gli allegati originali. | Scrittura |
Create Email Draft | Crea una bozza email in Gmail senza inviarla, per la revisione prima dell'invio. | Scrittura |
Update Draft | Sostituisce il contenuto di una bozza Gmail esistente sul posto tramite l'ID della bozza. | Scrittura |
Send Draft | Invia una bozza email esistente così com'è ai destinatari definiti. | Scrittura |
Get Draft | Recupera una singola bozza Gmail tramite il suo ID. | Lettura |
List Drafts | Recupera un elenco paginato di bozze email dall'account Gmail dell'utente. | Lettura |
Fetch Emails | Recupera un elenco di messaggi email da un account Gmail con filtri, paginazione e recupero opzionale del contenuto completo. | Lettura |
Fetch Message by Message ID | Recupera un messaggio email specifico tramite il suo ID. | Lettura |
Fetch Message by Thread ID | Recupera tutti i messaggi di un thread Gmail tramite l'ID del thread. | Lettura |
List Threads | Recupera un elenco di thread email da un account Gmail con filtri e paginazione. | Lettura |
Get Gmail Attachment | Recupera un allegato specifico da un messaggio Gmail tramite il suo ID allegato. | Lettura |
Get Profile | Recupera le informazioni del profilo Gmail, incluso l'indirizzo email e le statistiche della casella di posta. | Lettura |
Get Contacts | Recupera i contatti dell'account Google autenticato con selezione dei campi e paginazione opzionali. | Lettura |
Search People | Cerca i contatti confrontando una query con nomi, email, numeri di telefono e organizzazioni. | Lettura |
Modify Email Labels | Aggiunge o rimuove etichette Gmail da un messaggio specifico. | Scrittura |
Batch Modify Gmail Messages | Modifica le etichette su un massimo di 1.000 messaggi Gmail in un'unica chiamata API. | Scrittura |
Create Label | Crea una nuova etichetta Gmail con un nome univoco nell'account dell'utente. | Scrittura |
List Gmail Labels | Recupera tutte le etichette di sistema e create dall'utente per un account Gmail. | Lettura |
Create Gmail Filter | Crea un nuovo filtro Gmail con criteri e azioni specifici per organizzare la posta in arrivo. | Scrittura |
List Gmail Filters | Elenca tutti i filtri Gmail (regole) nella casella di posta. | Lettura |
Get Vacation Settings | Recupera le impostazioni del risponditore automatico per verificare se le risposte automatiche di assenza sono attive. | Lettura |
Update Vacation Settings | Configura le impostazioni delle risposte automatiche di assenza per un utente Gmail. | Scrittura |
Move to Trash | Sposta un messaggio email nel cestino (recuperabile). | ⚠️ Destruttivo |
Trash Thread | Sposta un intero thread email e tutti i suoi messaggi nel cestino. | ⚠️ Destruttivo |
Batch Delete Gmail Messages | Elimina definitivamente più messaggi Gmail in blocco, bypassando il cestino senza possibilità di recupero. | ⚠️ Destruttivo |
Delete Thread | Elimina in modo permanente e immediato un thread e tutti i suoi messaggi. Questa azione non può essere annullata. | ⚠️ Destruttivo |
Casi d'uso
Invia e rispondi alle email da Goodweek. Componi, invia e rispondi ai messaggi Gmail direttamente all'interno di una conversazione Goodweek, mantenendo la comunicazione via email nel contesto del lavoro che stai già svolgendo.
Leggi e mostra le email pertinenti su richiesta. Cerca nella tua casella di posta per mittente, oggetto o parole chiave per recuperare email specifiche e portarle in una conversazione Goodweek per la revisione o il riferimento.
Crea bozze di email da rivedere prima dell'invio. Crea bozze di email in Gmail tramite Goodweek, quindi rivedile e inviale al momento giusto, utile quando devi preparare le comunicazioni in anticipo.
Gestisci l'organizzazione della tua casella di posta. Applica etichette alle email, crea filtri Gmail per la posta in arrivo o sposta i messaggi nel cestino da Goodweek per mantenere la tua casella di posta organizzata senza passare all'interfaccia di Gmail.
Risoluzione dei problemi
«Errore 400: admin_policy_enforced» durante il collegamento
Questo è il problema più comune per gli utenti Google Workspace. Solo un Super Admin di Google Workspace può risolverlo seguendo lo Scenario 2 sopra.
L'amministratore ha contrassegnato Composio come attendibile, ma l'errore continua a comparire
Potrebbe esserci un ritardo di propagazione. Attendi qualche minuto e riprova. Se l'errore persiste, verifica che sia stata selezionata l'app Composio corretta e che il livello di accesso sia stato salvato come Attendibile e non come Limitato.
Collegato l'account Google sbagliato
Disconnetti l'integrazione da Goodweek e ricollegala. Fai clic su «Usa un altro account» durante il passaggio di autenticazione Google, oppure apri una finestra del browser in incognito per evitare la selezione automatica dell'account.
L'integrazione ha smesso di funzionare dopo il collegamento riuscito
L'amministratore del tuo Google Workspace potrebbe aver modificato le policy di accesso alle API. Prova a disconnettere e ricollegare l'integrazione. Se il problema persiste, chiedi al tuo amministratore di verificare che Composio sia ancora contrassegnato come Attendibile.
Integrazione non visibile in Goodweek
Assicurati che l'amministratore della tua organizzazione abbia abilitato l'integrazione Gmail dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.