Vai al contenuto principale

Integrazione Outlook - Guida alla configurazione

Collega il tuo account Outlook a Goodweek per gestire email, eventi del calendario, contatti, attività di To Do e impostazioni della casella di posta direttamente dal tuo spazio di lavoro IA.

A
Scritto da Antoine Stempien

Collega il tuo account Outlook a Goodweek per gestire email, eventi del calendario, contatti, attività di To Do e impostazioni della casella di posta direttamente dal tuo spazio di lavoro IA.

ℹ️ Nota sulla governance

Goodweek non supererà mai i livelli di accesso concessi all'utente all'interno di Outlook, garantendo l'allineamento con le politiche 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 qualsiasi utente possa vedere e collegare l'integrazione Outlook, l'amministratore della tua organizzazione deve prima abilitarla dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.

Configurazione amministratore

L'integrazione Outlook utilizza Microsoft OAuth 2.0 tramite Microsoft Entra ID. Per consentire agli utenti di connettersi, 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:

  1. Il consenso amministratore è già stato concesso. Gli utenti possono connettersi direttamente senza ulteriori passaggi.

  2. Il consenso utente è disabilitato nel tuo tenant. Un amministratore Entra deve concedere il consenso per conto dell'organizzazione prima che gli utenti possano connettersi. Vai su Centro di amministrazione di Microsoft Entra → Applicazioni aziendali → Composio → Autorizzazioni → Concedi il consenso amministratore per [la tua organizzazione].

  3. L'accesso ai dati della casella di posta o del calendario è limitato a livello di risorsa. A seconda delle impostazioni Exchange o Entra della tua organizzazione, potrebbe essere necessario configurare autorizzazioni aggiuntive prima che l'integrazione possa accedere al contenuto della casella di posta.

⚠️ Importante: caso limite della sessione amministratore Microsoft

Se un amministratore del tenant Microsoft Entra completa personalmente il processo di connessione OAuth, Microsoft potrebbe applicare automaticamente il consenso amministratore e collegare l'integrazione all'account dell'amministratore anziché al suo account utente individuale. Questo è un comportamento di Microsoft e non può essere modificato a livello OAuth.

Approccio consigliato: l'amministratore dovrebbe pre-approvare l'app in Entra ID (Applicazioni aziendali → Composio → Autorizzazioni → Concedi il consenso amministratore per la tua organizzazione) prima che qualsiasi utente, incluso l'amministratore, esegua il processo di connessione di Goodweek. Una volta pre-approvata, qualsiasi utente, incluso l'amministratore, può completare il processo e l'integrazione verrà collegata al suo account individuale.

In alternativa, un utente non amministratore può completare per primo il processo di connessione per evitare questo problema.

Connessione dell'utente

  1. In Goodweek, vai su Integrazioni.

  2. Trova Outlook e fai clic su Connetti.

  3. Verrai reindirizzato a Microsoft, dove ti verrà chiesto di accedere con il tuo account Microsoft e autorizzare l'accesso.

  4. 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 alle email, agli eventi del calendario e ai contatti che appartengono all'account che autorizzi.

  • Puoi revocare l'accesso di Goodweek in qualsiasi momento da Account Microsoft → Il mio account → Privacy → App e servizi → Composio → Rimuovi accesso.


Strumenti disponibili

Strumento

Descrizione

Tipo

Get Email Message

Recupera un messaggio email specifico tramite il suo ID dalla casella di posta Outlook dell'utente.

Lettura

Get Mail Folder

Recupera una cartella di posta tramite ID o nome noto (Posta in arrivo, Posta inviata, Bozze).

Lettura

Get Mail Delta

Recupera le modifiche incrementali ai messaggi in una casella di posta per la sincronizzazione.

Lettura

Get Drafts Mail Folder

Recupera i dettagli della cartella bozze, incluso il numero di elementi.

Lettura

Get Mail Tips

Recupera i suggerimenti email per i destinatari, come le risposte automatiche o lo stato di casella piena.

Lettura

Create Email Draft

Crea una nuova bozza email di Outlook con oggetto, corpo, destinatari e allegati facoltativi.

Scrittura

Create a Draft Reply

Crea una bozza di risposta a un messaggio esistente da rivedere prima dell'invio.

Scrittura

Create Forward Draft

Crea una bozza di inoltro di un messaggio esistente che può essere modificata prima dell'invio.

Scrittura

Create Reply-All Draft

Crea una bozza di risposta a tutti per un messaggio, da rivedere prima dell'invio.

Scrittura

Forward Message

Inoltra un'email esistente a nuovi destinatari.

Scrittura

Add Mail Attachment

Aggiunge un allegato a un messaggio email tramite il suo ID.

Scrittura

Download Outlook Attachment

Scarica un allegato specifico da un messaggio email.

Lettura

Create Mail Folder

Crea una nuova cartella di posta per organizzare le email.

Scrittura

Batch Move Messages

Sposta fino a 20 messaggi di Outlook in una cartella di destinazione in un'unica chiamata.

Lettura

Batch Update Messages

Aggiorna fino a 20 messaggi di Outlook in un'unica chiamata, ad esempio per contrassegnarli come letti.

Scrittura

Create Email Rule

Crea una regola email con condizioni e azioni per la gestione automatizzata dei messaggi.

Scrittura

Get Calendar View

Recupera gli eventi attivi in un intervallo di tempo specificato, inclusi gli eventi su più giorni.

Lettura

Get Calendar Event

Recupera tutti i dettagli di un evento del calendario specifico tramite il suo ID.

Lettura

Get Calendar Schedule

Recupera le informazioni di disponibilità (libero/occupato) per utenti, liste di distribuzione o risorse.

Lettura

Find Meeting Times

Suggerisce orari per le riunioni in base alla disponibilità dell'organizzatore e dei partecipanti e ai requisiti di durata.

Lettura

Create Calendar Event

Crea un nuovo evento del calendario di Outlook con orario di inizio, orario di fine, partecipanti e luogo.

Scrittura

Create Event in Specific Calendar

Crea un nuovo evento in un calendario specifico denominato per un utente.

Scrittura

Accept Calendar Event Invite

Accetta o accetta provvisoriamente un invito a una riunione del calendario per conto dell'utente.

Lettura

Create Calendar

Crea un nuovo calendario nella casella di posta dell'utente per organizzare gli eventi separatamente.

Scrittura

Get User's Default Calendar

Recupera le proprietà e le relazioni del calendario predefinito dell'utente che ha effettuato l'accesso.

Lettura

Get Calendar Event Attachment

Recupera un allegato specifico da un evento del calendario.

Lettura

Add Event Attachment

Aggiunge un allegato a un evento specifico del calendario di Outlook.

Scrittura

Get Contact

Recupera un contatto specifico di Outlook tramite il suo ID.

Lettura

Create Contact

Crea un nuovo contatto nella cartella dei contatti di un utente Microsoft Outlook.

Scrittura

Create Contact Folder

Crea una nuova cartella contatti nella casella di posta dell'utente per organizzare i contatti.

Scrittura

Get Contact Photo

Scarica la foto del profilo binaria di un contatto.

Lettura

Create To Do Task

Crea una nuova attività in Microsoft To Do all'interno di un elenco di attività specificato.

Scrittura

Get Mailbox Settings

Recupera le impostazioni della casella di posta, come le risposte automatiche, il fuso orario e la lingua.

Lettura

Get Supported Languages

Recupera le lingue supportate configurate nella casella di posta dell'utente.

Lettura

Get Supported Time Zones

Recupera i fusi orari supportati per il server della casella di posta dell'utente.

Lettura

Get User by Email

Recupera i dettagli dell'utente da Microsoft Graph tramite indirizzo email o userPrincipalName.

Lettura

Get Outlook Profile

Recupera il profilo Microsoft Outlook di un utente specificato.

Lettura

Get Master Categories

Recupera tutte le categorie definite nell'elenco principale delle categorie dell'utente.

Lettura

Create User Master Category

Crea una nuova categoria nell'elenco principale delle categorie dell'utente.

Scrittura

Get Inference Classification

Recupera le impostazioni di classificazione della Posta in arrivo prioritaria dell'utente autenticato.

Lettura

Create User Focused Inbox Override

Crea un'eccezione della Posta in arrivo prioritaria per un mittente specifico per controllare l'instradamento dei messaggi.

Scrittura

Decline Calendar Event

Rifiuta un invito a un evento del calendario per conto dell'utente.

⚠️ Distruttivo

Cancel User Calendar Event

Annulla un evento del calendario e invia notifiche di annullamento a tutti i partecipanti.

⚠️ Distruttivo

Delete Calendar Event

Elimina definitivamente un evento del calendario dal calendario Outlook dell'utente.

⚠️ Distruttivo

Delete Calendar

Elimina un calendario diverso da quello predefinito dalla casella di posta dell'utente.

⚠️ Distruttivo

Delete Message

Elimina definitivamente un messaggio email di Outlook tramite il suo ID.

⚠️ Distruttivo

Delete Mail Folder

Elimina una cartella di posta dalla casella di posta dell'utente.

⚠️ Distruttivo

Delete Contact

Elimina definitivamente un contatto esistente tramite il suo ID.

⚠️ Distruttivo

Delete Email Rule

Elimina definitivamente una regola email. Questa azione è irreversibile.

⚠️ Distruttivo

Delete To Do Task

Elimina definitivamente un'attività da un elenco di attività di Microsoft To Do.

⚠️ Distruttivo

Casi d'uso

  • Crea bozze e gestisci le email dalle conversazioni. Crea bozze di email, risposte e inoltri direttamente da Goodweek senza passare a Outlook, utile per redigere risposte mentre esamini altro contesto nello stesso spazio di lavoro.

  • Controlla la disponibilità e pianifica riunioni. Recupera le viste del calendario, trova slot liberi in base alla disponibilità dei partecipanti e crea eventi del calendario direttamente da Goodweek per pianificare riunioni senza navigare in Outlook.

  • Gestisci contatti e attività. Crea nuovi contatti, aggiungili alle cartelle contatti e aggiungi attività a Microsoft To Do da Goodweek per tenere organizzati persone e attività dopo una riunione o una conversazione.

  • Organizza la tua posta in arrivo con regole e cartelle. Crea cartelle di posta e regole email da Goodweek per automatizzare l'instradamento dei messaggi e mantenere la posta in arrivo organizzata senza configurarle manualmente in Outlook.


Risoluzione dei problemi

Errore di autorizzazione durante la connessione

Potrebbe essere necessario che l'amministratore del tenant Microsoft Entra conceda il consenso per l'applicazione. Chiedi al tuo amministratore di seguire i passaggi di Configurazione amministratore sopra riportati prima di tentare di riconnetterti.

Integrazione non visibile in Goodweek

Assicurati che l'amministratore della tua organizzazione abbia abilitato l'integrazione Outlook dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.

Riferimenti

Hai ricevuto la risposta alla tua domanda?