Crie tarefas com o complemento do ClickUp para Outlook

Crie tarefas a partir de e-mails e anexe respostas de e-mail às tarefas usando o add-in do ClickUp.

O que você vai precisar

Esta integração não funciona com caixas de correio compartilhadas ou delegadas.

Compatibilidade

O add-in usa a Autenticação de Aplicativo Aninhado (NAA) da Microsoft para acessar os anexos das mensagens. Você vai precisar de um cliente Outlook e de uma caixa de correio que suportem NAA.

Consulte os requisitos de Autenticação de Aplicativo Aninhado da Microsoft para verificar as versões mínimas do Outlook. O NAA não é compatível quando o add-in é aberto em uma caixa de correio do Outlook.com ou do Gmail.

Use os guias da Microsoft para verificar a sua versão do Outlook ou identificar a versão do Exchange Server à qual sua conta está conectada.

Instalar o add-in do ClickUp

Instale o add-in aqui. Se a sua versão do Outlook exigir uma URL, insira: https://modern-outlook.clickup.com/manifest.xml.

Você também pode instalar o add-in manualmente:

  1. Abra um e-mail no aplicativo do Outlook.
  2. Selecione Store ou Obter Suplementos na barra superior. Quem usa a versão web encontra Obter Suplementos no menu de reticências ... ao lado dos botões Responder e Encaminhar. Os rótulos podem variar conforme a versão do Outlook.
  3. Pesquise por ClickUp for Outlook na Loja de Suplementos.
  4. Clique em Adicionar. Ao clicar em Adicionar, você concorda com os termos de licença e a política de privacidade do add-in.

Aprovação do administrador

O add-in do Outlook solicita a permissão delegada Mail.Read do Microsoft Graph, não permissões de aplicativo. Ele funciona com a caixa de correio do próprio usuário conectado. Caixas de correio compartilhadas e delegadas não são compatíveis. A possibilidade de um usuário conceder consentimento depende das configurações do locatário do Microsoft Entra. Se o consentimento do usuário estiver restrito, um administrador da Microsoft precisará concedê-lo.

Peça a um administrador da Microsoft que siga estas etapas:

  1. Abra o Microsoft Entra ID.
  2. Navegue até Aplicativos empresariais.
  3. Pesquise o aplicativo usando o ID de Aplicativo aaedd6ae-575a-4582-ba2b-7c114a26e870.
  4. Selecione o aplicativo ClickUp.
  5. Abra Permissões em Segurança e revise a permissão do Graph solicitada.
  6. Conceda o consentimento de administrador necessário.
Escopo Finalidade
Mail.Read Permite que o aplicativo leia a caixa de correio do usuário. O add-in usa essa permissão dentro do Outlook para recuperar os anexos da mensagem aberta via Microsoft Graph. O corpo do e-mail é lido por meio do Office.js.

O token Mail.Read permite a leitura de toda a caixa de correio do usuário, mas o add-in o utiliza apenas para a mensagem aberta e seus anexos.

O manifesto do suplemento do Office também solicita o nível de permissão ReadWriteMailbox, que é mais amplo do que o necessário para o add-in ler o e-mail selecionado. Esse é um nível de permissão do suplemento do Office, não uma permissão do Microsoft Graph.

O add-in lê o corpo do e-mail por meio do Office.js e os anexos pelo Microsoft Graph. O acesso ao Graph usa a sua conta conectada, não permissões de aplicativo nem escopos de caixa de correio compartilhada. Ele não usa EWS, IMAP, POP nem SMTP AUTH.

A política de consentimento do locatário do Microsoft Entra determina se você pode conceder o consentimento por conta própria. Se o consentimento do usuário estiver restrito, um administrador da Microsoft precisará conceder o consentimento do Graph necessário.

Os administradores devem revisar as permissões do Graph no Microsoft Entra e o nível de permissão do Office no manifesto e na configuração de implantação do add-in. São revisões independentes.

Consulte o guia da Microsoft sobre gerenciamento de permissões de aplicativo.

O ID do aplicativo Entra do add-in é aaedd6ae-575a-4582-ba2b-7c114a26e870. O ID do manifesto do Office, c1f0f062-29a7-4adf-bae8-a04aef9498ca, é um identificador diferente. Não use um registro de ClickApp do Outlook Mail, Calendar ou E-mail ao revisar o add-in.

Abrir o suplemento do ClickUp

Após instalar o suplemento, você pode concluir a configuração fazendo login na sua conta do ClickUp:

  1. Abra um e-mail no aplicativo Outlook.
  2. No canto superior direito, clique no ícone Aplicativos.
  3. Selecione ClickUp.
  4. Faça login na sua conta do ClickUp.
  5. Selecione os Espaços de trabalho que devem ter acesso e clique em Conectar Espaços de trabalho.

Durante a autorização da Microsoft, a tela de consentimento lista as permissões solicitadas. As configurações de consentimento da sua organização determinam se você ou um administrador da Microsoft pode aprová-las.

Alternar ou adicionar Espaços de trabalho

Para ver seus Espaços de trabalho conectados, clique no seu avatar no canto superior esquerdo do suplemento.

Para adicionar um novo Espaço de trabalho ao suplemento, clique no ícone de mais ao lado de Espaços de trabalho.

Criar novas tarefas

Para criar uma nova tarefa a partir do suplemento do ClickUp:

  1. Abra o suplemento em um e-mail no Outlook.
  2. No canto superior direito, selecione a guia Nova tarefa.
  3. Dê um nome à sua tarefa, selecione uma Lista para ela e adicione os detalhes que precisar.
  4. No canto inferior direito, clique em Criar nova tarefa.

A tarefa é criada antes que os arquivos do e-mail terminem de ser carregados. Uma falha no carregamento pode deixar a tarefa sem parte ou todo o conteúdo do e-mail selecionado.

Anexar e-mails a tarefas

Para anexar um e-mail a uma tarefa existente ou criar uma nova tarefa a partir dele:

  1. Abra o suplemento em um e-mail no Outlook.
  2. Para anexar o e-mail a uma tarefa existente, selecione Anexar à tarefa. Para criar uma nova tarefa e anexar o e-mail a ela, clique em + Nova tarefa.

A cópia do e-mail e seus anexos usam solicitações de upload separadas. Uma falha no upload pode deixar apenas parte do conteúdo do e-mail anexado a uma tarefa existente.

O que o suplemento envia ao ClickUp

Quando você abre o painel, o suplemento usa o ID da mensagem para localizar as tarefas do ClickUp vinculadas. Essa consulta não faz upload do corpo do e-mail nem dos arquivos anexos. O painel também faz solicitações separadas para informações de conta do ClickUp, Workspace e tarefas.

O suplemento lê o corpo do e-mail selecionado e os dados dos anexos dentro do Outlook. Quando você opta por criar uma tarefa a partir do e-mail ou anexar o e-mail a uma tarefa, ele faz upload de:

  • Uma cópia HTML do corpo do e-mail.
  • Uma miniatura.
  • Metadados do e-mail, incluindo o ID da mensagem, o assunto, o remetente e o link do Outlook.
  • Anexos de mensagem compatíveis como arquivos separados.

Esses uploads se tornam anexos da tarefa. Alguns tipos de anexo do Outlook podem não ser transferidos. Verifique a tarefa após o upload para garantir que os arquivos necessários estão anexados.

Cache de dados

O suplemento mantém o corpo do e-mail selecionado, os metadados e os dados dos anexos em memória enquanto está em execução. Ele não salva essa cópia temporária do e-mail no armazenamento local do navegador nem nas configurações de roaming do Office.

Os dados de login do ClickUp e algumas preferências usam o armazenamento do navegador e as configurações de roaming do Office. A biblioteca de login da Microsoft mantém um cache de token separado no armazenamento do navegador. O token do Microsoft Graph fica dentro do cliente do Outlook e não é enviado ao ClickUp.

Fazer logout remove os dados de login do ClickUp e as configurações de roaming. Isso não limpa o cache de token da Microsoft nem todos os dados de e-mail mantidos em memória. Fechar o painel não é um controle de exclusão de dados.

Segurança

O conteúdo de e-mail enviado para uma tarefa passa a ser conteúdo salvo no ClickUp. Remover o suplemento ou fazer logout não exclui essas cópias.

Quando você usa os recursos compatíveis do ClickUp Brain, o conteúdo de e-mail salvo pode ser incluído de acordo com as configurações do seu Espaço de trabalho e as permissões de conteúdo. O suplemento não importa sua caixa de entrada continuamente.

Consulte nosso artigo sobre hospedagem de dados, a lista de subprocessadores do ClickUp e o Adendo de Proteção de Dados para conhecer os termos de hospedagem e processamento. O processamento da integração pode ocorrer fora da região de hospedagem selecionada pelo seu Espaço de trabalho.

Remover o suplemento não revoga o consentimento da Microsoft. Um administrador da Microsoft pode revisar ou remover as permissões do aplicativo no Microsoft Entra ID. Dependendo da política do locatário, os usuários também podem conseguir remover o próprio consentimento pelo My Apps.

Para mais informações, consulte a Política de Segurança do ClickUp e Privacidade e segurança.

Comportamento inesperado

Soluções comuns para comportamentos inesperados.

Não é possível conectar sua conta do ClickUp

Tente entrar no ClickUp novamente pelo suplemento. A autorização da Microsoft é independente do login do ClickUp: o acesso a anexos também exige um cliente Outlook compatível e o consentimento necessário da Microsoft.

Problemas gerais de conexão ou tela em branco

Se você estiver enfrentando problemas de conexão ou vendo uma tela em branco, tente a opção Usar token para entrar no ClickUp:

  1. Selecione Usar token no suplemento. Se essa opção não aparecer, remova e reinstale o suplemento.
  2. No ClickUp, no canto superior esquerdo, clique no avatar do seu Espaço de trabalho.
  3. Selecione Configurações.
  4. Na barra lateral Todas as configurações, clique em Aplicativos.
  5. Clique em Gerar abaixo de Token de API.
  6. Clique em Copiar.
  7. Volte ao suplemento e cole seu token para conectar as duas contas.

Essa opção conecta você ao ClickUp. Ela não substitui a autorização da Microsoft para leitura de anexos de mensagens.

Não é possível instalar suplementos

Se você não conseguir instalar suplementos de forma alguma, precisará entrar em contato com sua equipe de TI.

Compartilhamento de equipe

No momento, o suplemento para Outlook exibe apenas as pessoas que receberam acesso direto ou foram convidadas individualmente. Se o acesso de alguém for somente por meio de um compartilhamento de equipe, essa pessoa não aparecerá como opção de responsável no suplemento. Para torná-la visível, convide o usuário diretamente para a Lista, Subpasta ou Pasta em que você está trabalhando.

Escopos necessários do suplemento do Outlook

As configurações do seu locatário no Microsoft Entra determinam se você pode consentir com a permissão delegada Mail.Read. Se o consentimento do usuário estiver restrito, um administrador da Microsoft precisará conceder esse consentimento.

Remover o suplemento não remove o consentimento da Microsoft. Um administrador da Microsoft deve removê-lo em Aplicativos empresariais no Microsoft Entra ID.

A permissão ReadWriteMailbox do manifesto do Office é separada da permissão Mail.Read do Graph. Verifique o consentimento do Graph no Entra e as permissões do Office no manifesto e nas configurações de implantação do suplemento.

Limitar quem pode usar o suplemento

Os administradores da Microsoft podem controlar quem pode usar o suplemento:

  • No Microsoft Entra ID, defina Atribuição necessária como Sim no aplicativo empresarial do ClickUp. Somente usuários e grupos atribuídos podem entrar. Os demais recebem AADSTS50105. A atribuição de grupos exige o Entra ID P1 ou P2.
  • No centro de administração do Microsoft 365, use a Implantação Centralizada para implantar o suplemento para usuários ou grupos específicos.