Crea attività dalle email e allega le risposte alle attività usando il componente aggiuntivo di ClickUp.
Cosa ti serve
- Puoi usare questo componente aggiuntivo ClickUp con tutti i piani ClickUp.
- Gli Ospiti e i membri con accesso limitato non possono usare questo componente aggiuntivo ClickUp.
- Il componente aggiuntivo per Outlook non è disponibile su dispositivi mobili.
Questa integrazione non funziona con caselle di posta condivise o delegate.
Compatibilità
Il componente aggiuntivo usa la tecnologia Nested App Authentication (NAA) di Microsoft per accedere agli allegati dei messaggi. Sono necessari un client Outlook e una casella di posta che supportino NAA.
Consulta i requisiti di Nested App Authentication di Microsoft per le versioni minime di Outlook. NAA non è supportato quando il componente aggiuntivo viene aperto in una casella di posta Outlook.com o Gmail.
Usa le guide di Microsoft per trovare la versione di Outlook in uso o identificare la versione di Exchange Server a cui è connesso il tuo account.
Installa il componente aggiuntivo ClickUp
Installa il componente aggiuntivo qui. Se la tua versione di Outlook richiede un URL, inserisci: https://modern-outlook.clickup.com/manifest.xml.
Puoi anche installare il componente aggiuntivo manualmente:
- Apri un'email nell'app Outlook.
- Seleziona Store o Ottieni componenti aggiuntivi dalla barra superiore. Gli utenti web possono trovare Ottieni componenti aggiuntivi nel menu puntini di sospensione ... accanto ai pulsanti Rispondi e Inoltra. Le etichette possono variare a seconda della versione di Outlook.
- Cerca ClickUp for Outlook nell'Add-In Store.
- Fai clic su Aggiungi. Cliccando su Aggiungi, accetti i termini di licenza e l'informativa sulla privacy del componente aggiuntivo.
Approvazione da parte dell'amministratore
Il componente aggiuntivo per Outlook richiede l'autorizzazione delegata Mail.Read di Microsoft Graph, non autorizzazioni applicative. Funziona con la casella di posta dell'utente che ha eseguito l'accesso. Le caselle di posta condivise e delegate non sono supportate. La possibilità di concedere il consenso dipende dalle impostazioni del tenant Microsoft Entra. Se il consenso utente è limitato, un amministratore Microsoft deve concedere il consenso.
Chiedi a un amministratore Microsoft di seguire questi passaggi:
- Apri Microsoft Entra ID.
- Vai a Applicazioni aziendali.
- Cerca l'app usando l'ID applicazione
aaedd6ae-575a-4582-ba2b-7c114a26e870. - Seleziona l'app ClickUp.
- Apri Autorizzazioni nella sezione Sicurezza e verifica l'autorizzazione Graph richiesta.
- Concedi il consenso amministratore richiesto.
| Ambito | Scopo |
Mail.Read |
Consente all'app di leggere la casella di posta dell'utente. Il componente aggiuntivo usa questa autorizzazione all'interno di Outlook per recuperare gli allegati del messaggio aperto da Microsoft Graph. Il corpo dell'email viene letto tramite Office.js. |
Il token Mail.Read consente la lettura dell'intera casella di posta dell'utente, ma il componente aggiuntivo lo usa solo per il messaggio aperto e i relativi allegati.
Il manifesto del componente aggiuntivo Office richiede anche il livello di autorizzazione ReadWriteMailbox, più ampio di quanto necessario al componente aggiuntivo per leggere l'email selezionata. Si tratta di un livello di autorizzazione del componente aggiuntivo Office, non di un'autorizzazione Microsoft Graph.
Il componente aggiuntivo legge il corpo dell'email tramite Office.js e gli allegati tramite Microsoft Graph. L'accesso a Graph utilizza l'account con cui hai effettuato l'accesso, non autorizzazioni applicative né ambiti per caselle di posta condivise. Non utilizza EWS, IMAP, POP né SMTP AUTH.
I criteri di consenso del tenant Microsoft Entra determinano se puoi concedere il consenso autonomamente. Se il consenso utente è limitato, un amministratore Microsoft deve concedere il consenso Graph richiesto.
Gli amministratori devono verificare le autorizzazioni Graph in Microsoft Entra e il livello di autorizzazione Office nel manifesto e nella configurazione di distribuzione del componente aggiuntivo. Si tratta di due verifiche distinte.
Consulta la guida di Microsoft sulla gestione delle autorizzazioni delle applicazioni.
L'ID applicazione Entra del componente aggiuntivo è aaedd6ae-575a-4582-ba2b-7c114a26e870. L'ID manifesto Office, c1f0f062-29a7-4adf-bae8-a04aef9498ca, è un identificatore diverso. Non sostituire una registrazione ClickApp di Outlook Mail, Calendario o Email durante la verifica del componente aggiuntivo.
Aprire il componente aggiuntivo ClickUp
Dopo aver installato il componente aggiuntivo, puoi completare la configurazione accedendo al tuo account ClickUp:
- Apri un'email nell'app Outlook.
- Nell'angolo in alto a destra, fai clic sull'icona App.
- Seleziona ClickUp.
- Accedi al tuo account ClickUp.
- Seleziona le aree di lavoro che devono avere accesso e fai clic su Connetti aree di lavoro.
Durante l'autorizzazione Microsoft, la schermata di consenso elenca le autorizzazioni richieste. Le impostazioni di consenso della tua organizzazione determinano se puoi approvarle tu stesso o se è necessario l'intervento di un amministratore Microsoft.
Cambiare o aggiungere aree di lavoro
Per visualizzare le aree di lavoro connesse, fai clic sul tuo avatar nell'angolo in alto a sinistra del componente aggiuntivo.
Per aggiungere una nuova area di lavoro al componente aggiuntivo, fai clic sull'icona più accanto ad Aree di lavoro.
Creare nuove attività
Per creare una nuova attività dal componente aggiuntivo ClickUp:
- Apri il componente aggiuntivo da un'email in Outlook.
- Nell'angolo in alto a destra, seleziona la scheda Nuova attività.
- Assegna un nome all'attività, seleziona un elenco e aggiungi eventuali dettagli aggiuntivi.
- Nell'angolo in basso a destra, fai clic su Crea nuova attività.
L'attività viene creata prima che il caricamento dei file email sia completato. Un errore di caricamento può far sì che l'attività risulti priva di alcuni o di tutti i contenuti email selezionati.
Allegare email alle attività
Per allegare un'email a un'attività esistente o creare una nuova attività a partire da essa:
- Apri il componente aggiuntivo da un'email in Outlook.
- Per allegare l'email a un'attività esistente, seleziona Allega all'attività. Per creare una nuova attività e allegarvi l'email, fai clic su + Nuova attività.
La copia dell'email e i suoi allegati usano richieste di caricamento separate. Un caricamento non riuscito può lasciare allegata a un'attività esistente solo una parte del contenuto dell'email.
Cosa invia il componente aggiuntivo a ClickUp
Quando apri il pannello, il componente aggiuntivo usa l'ID del messaggio per cercare le attività ClickUp collegate. Questa ricerca non carica il corpo dell'email né i relativi file allegati. Il pannello esegue anche richieste separate per le informazioni sull'account ClickUp, sul Workspace e sulle attività.
Il componente aggiuntivo legge il corpo dell'email selezionata e i dati degli allegati all'interno di Outlook. Quando scegli di creare un'attività dall'email o di allegarla a un'attività, carica:
- Una copia HTML del corpo dell'email.
- Una miniatura.
- I metadati dell'email, inclusi l'ID del messaggio, l'oggetto, il mittente e il link di Outlook.
- Gli allegati supportati del messaggio come file separati.
Questi caricamenti diventano allegati dell'attività. Alcuni tipi di allegati di Outlook potrebbero non essere trasferiti correttamente. Controlla l'attività dopo il caricamento per assicurarti che i file necessari siano allegati.
Memorizzazione temporanea dei dati
Il componente aggiuntivo mantiene in memoria il corpo dell'email selezionata, i metadati e i dati degli allegati mentre è in esecuzione. Non salva questa copia temporanea dell'email nell'archiviazione locale del browser né nelle impostazioni di roaming di Office.
I dati di accesso a ClickUp e alcune preferenze usano l'archiviazione del browser e le impostazioni di roaming di Office. La libreria di accesso di Microsoft mantiene una cache dei token separata nell'archiviazione del browser. Il token Microsoft Graph rimane all'interno del client Outlook e non viene inviato a ClickUp.
La disconnessione rimuove i dati di accesso a ClickUp e le impostazioni di roaming. Non cancella la cache dei token di Microsoft né tutti i dati delle email conservati in memoria. Chiudere il pannello non è un controllo per l'eliminazione dei dati.
Sicurezza
Il contenuto email caricato in un'attività diventa contenuto ClickUp salvato. La rimozione del componente aggiuntivo o la disconnessione non elimina queste copie.
Quando utilizzi le funzionalità di ClickUp Brain supportate, il contenuto email salvato può essere incluso in base alle impostazioni della tua area di lavoro e alle autorizzazioni sui contenuti. Il componente aggiuntivo non importa continuamente la tua casella di posta.
Consulta il nostro articolo sull'hosting dei dati, l'elenco dei sub-responsabili del trattamento di ClickUp e l'Addendum sulla protezione dei dati per i termini di hosting e trattamento. Il trattamento delle integrazioni può avvenire al di fuori della regione di hosting selezionata per la tua area di lavoro.
La rimozione del componente aggiuntivo non revoca il consenso Microsoft. Un amministratore Microsoft può esaminare o rimuovere le autorizzazioni dell'applicazione in Microsoft Entra ID. A seconda della policy del tenant, gli utenti potrebbero anche revocare autonomamente il proprio consenso tramite My Apps.
Per ulteriori informazioni, consulta la Policy di sicurezza di ClickUp e l'articolo su Privacy e sicurezza.
Comportamento imprevisto
Soluzioni comuni per i comportamenti imprevisti.
Impossibile connettere il tuo account ClickUp
Prova ad accedere di nuovo a ClickUp dal componente aggiuntivo. L'autorizzazione Microsoft è separata dall'accesso a ClickUp: per accedere agli allegati è necessario anche un client Outlook compatibile e il consenso Microsoft richiesto.
Problemi generali di connessione o schermata vuota
Se riscontri problemi di connessione o vedi una schermata vuota, prova l'opzione Usa token per accedere a ClickUp:
- Seleziona Usa token nel componente aggiuntivo. Se non vedi questa opzione, rimuovi e reinstalla il componente aggiuntivo.
- In ClickUp, nell'angolo in alto a sinistra, fai clic sull'avatar del tuo Workspace.
- Seleziona Impostazioni.
- Nella barra laterale Tutte le impostazioni, fai clic su App.
- Fai clic su Genera sotto Token API.
- Fai clic su Copia.
- Torna al componente aggiuntivo e incolla il token per collegare i due account.
Questa opzione ti consente di accedere a ClickUp. Non sostituisce l'autorizzazione Microsoft per la lettura degli allegati dei messaggi.
Impossibile installare i componenti aggiuntivi
Se non riesci a installare i componenti aggiuntivi, dovrai rivolgerti al team IT.
Condivisione con il team
Al momento, il componente aggiuntivo per Outlook mostra solo le persone a cui è stato concesso l'accesso diretto o che sono state invitate singolarmente. Se l'accesso di qualcuno avviene esclusivamente tramite una condivisione con il team, quella persona non comparirà come opzione assegnabile nel componente aggiuntivo. Per renderla visibile, invita quell'utente direttamente all'Elenco, alla Sottocartella o alla Cartella su cui stai lavorando.
Ambiti richiesti dal componente aggiuntivo per Outlook
Le impostazioni del tenant Microsoft Entra determinano se puoi fornire il consenso al Mail.Read delegato. Se il consenso dell'utente è limitato, un amministratore Microsoft deve concedere il consenso.
La rimozione del componente aggiuntivo non revoca il consenso Microsoft. Un amministratore Microsoft lo rimuove da Applicazioni aziendali in Microsoft Entra ID.
Il permesso ReadWriteMailbox del manifest di Office è separato da Mail.Read di Graph. Verifica il consenso Graph in Entra e le autorizzazioni di Office nel manifest e nelle impostazioni di distribuzione del componente aggiuntivo.
Limitare chi può usare il componente aggiuntivo
Gli amministratori Microsoft possono controllare chi può usare il componente aggiuntivo:
- In Microsoft Entra ID, imposta Assegnazione obbligatoria su Sì nell'applicazione aziendale ClickUp. Solo gli utenti e i gruppi assegnati possono accedere. Gli altri riceveranno
AADSTS50105. L'assegnazione di gruppi richiede Entra ID P1 o P2. - Nell'interfaccia di amministrazione di Microsoft 365, usa la Distribuzione centralizzata per distribuire il componente aggiuntivo a utenti o gruppi specifici.