Integração com Microsoft Teams

Transforme discussões em tarefas acionáveis sincronizando atividades do ClickUp, criando tarefas e visualizando links no Microsoft Teams.

Crie tarefas a partir de canais e mensagens diretas do Microsoft Teams, configure mensagens de atividade do ClickUp específicas por canal para garantir que todas as partes interessadas vejam as atualizações, pesquise conversas no Microsoft Teams e conecte todas as suas ferramentas usando a integração com o Microsoft Teams.

O que você vai precisar

  • A integração com o Microsoft Teams está disponível em todos os planos do ClickUp.
  • Proprietários e administradores do Espaço de trabalho gerenciam as conexões do Microsoft Teams no Espaço de trabalho. Membros podem conectar uma conta pessoal do Microsoft Teams.
  • Convidados e membros com acesso limitado não podem usar a integração com o Microsoft Teams.
  • Membros do Microsoft Teams sem acesso ao ClickUp conseguem ver prévias de tarefas, mas não podem publicá-las.
  • Membros do Microsoft Teams com acesso ao ClickUp conseguem ver e publicar prévias de tarefas.

Tipos de conexão

Os recursos e comandos disponíveis dependem do tipo de conexão que você usa.

Tipo de conexão Descrição Recursos Comandos
Conexão pessoal Conecte sua conta do Microsoft Teams à sua conta de usuário do ClickUp em cada Espaço de trabalho que você criou ou do qual participa. Os dados da sua conta do Microsoft Teams não ficam visíveis para outras pessoas pelo ClickUp. Pesquisa conectada pessoal:
Pesquise conversas públicas e privadas da sua conta do Microsoft Teams conectada. Ninguém mais consegue pesquisar conversas das suas conexões pessoais.
Criar anexos: anexe conversas do Microsoft Teams a tarefas e comentários.
Abrir o Microsoft Teams: abre o Microsoft Teams em uma nova guia.
Conexão do Espaço de trabalho O proprietário ou os administradores do Espaço de trabalho podem habilitar o Microsoft Teams como uma conexão do Espaço de trabalho.
Use essa conexão para dar a todos acesso à Pesquisa conectada.
Pesquisa conectada do Espaço de trabalho:
A Pesquisa conectada do Espaço de trabalho permite que todos os membros do Espaço de trabalho pesquisem mensagens públicas da conta conectada.

Configure a integração com o Microsoft Teams

Saiba como configurar a integração com o Microsoft Teams.

Pesquise conversas do Microsoft Teams usando a Pesquisa Conectada

Depois de habilitar a integração, você pode usar a Pesquisa Conectada pessoal ou do Workspace para pesquisar conversas do Microsoft Teams no ClickUp.

Habilite a sincronização de atividades do ClickUp para conexões pessoais

Ao usar uma conexão pessoal, você pode sincronizar as atividades do ClickUp com o Microsoft Teams para Espaços, Pastas, Subpastas e Listas específicos do seu Espaço de trabalho. As atividades do ClickUp são enviadas como mensagens para o Microsoft Teams.

Você pode criar um canal dedicado do ClickUp no Microsoft Teams para essas mensagens.

Na guia Pessoal do Microsoft Teams, no App Center:

  1. Ao lado de Sincronizar atividade do ClickUp com canais, clique em Adicionar.
  2. Selecione um Espaço, Pasta, Subpasta ou Lista.
  3. Selecione um canal do Microsoft Teams para receber as mensagens de atividade. Você pode escolher entre os canais públicos dos quais participa. Canais privados não estão disponíveis para sincronização de atividades.
  4. Personalize as mensagens de atividade:
    • Atribuído a mim: envia mensagens de atividade somente para tarefas atribuídas a você.
    • Incluir privados: inclui tarefas, Listas, Subpastas e Pastas privadas.
    • Tipos de mensagens de atividade: selecione os tipos de mensagens de atividade de tarefas que você quer receber.
  5. Instale o aplicativo ClickUp no canal do Microsoft Teams escolhido para começar a receber notificações.

Se você não estiver recebendo mensagens de atividade, verifique se o aplicativo ClickUp não está bloqueado.

Tarefas em múltiplas Listas só geram mensagens de atividade no Microsoft Teams se a Lista de origem estiver incluída no local selecionado.

Captura de tela da integração com o MS Teams

Chatbot do ClickUp no Microsoft Teams

Após a instalação, você verá o bot de integração no seu chat individual. Na primeira vez que interagir com ele, o bot vai explicar como a integração funciona, mostrar alguns exemplos e oferecer links úteis para os artigos da nossa Central de Ajuda.

Visualizar tarefas, comentários e Documentos no Microsoft Teams

Quando um link de tarefa, comentário ou Documento é compartilhado no Microsoft Teams, todos os membros da equipe veem uma prévia expandida do link com informações úteis.

Links de tarefas

Os links de tarefas exibem os seguintes detalhes:

Captura de tela de uma pré-visualização expandida de tarefa.

Links de comentários

Os links de comentários exibem os seguintes detalhes:

  • Quem deixou o comentário.
  • Prévia do comentário.
  • O local onde o comentário foi publicado.

Captura de tela de uma pré-visualização de comentário.

Links de Documentos

Os links de Documentos exibem os seguintes detalhes:

  • O título do Documento.
  • Prévia do Documento.
  • O proprietário do Documento.
  • A localização do Documento.

Captura de tela de uma pré-visualização de Documento.

Pré-visualizações de links do Microsoft Teams

Quando você cola um link do Microsoft Teams no meio de uma frase ou dentro de um texto existente, ele exibe uma pré-visualização inline do link. Passe o cursor sobre ela para ver mais detalhes.

Quando você cola um link do Microsoft Teams em uma nova linha, pode escolher exibi-lo inline, como uma pré-visualização ao vivo ou como uma URL comum.

As pré-visualizações de links funcionam em descrições de tarefas, comentários, Documentos e mensagens de Chat. Para alterar manualmente o tipo de pré-visualização de um link, passe o cursor sobre ele e clique no ícone de reticências ….

Painel do Microsoft Teams em tarefas

Ao usar uma conexão pessoal, você pode acessar o painel do Microsoft Teams em tarefas.

Após colar o primeiro link do Microsoft Teams em uma descrição de tarefa ou comentário, você verá um novo ícone do Microsoft Teams na barra lateral direita da sua tarefa. Clique nesse ícone a qualquer momento para ver todos os links do Microsoft Teams publicados na tarefa.

Captura de tela destacando o painel de tarefas do MS Teams.

As pré-visualizações são agrupadas por tipo. Você pode alternar entre os layouts de grade e tabela usando os ícones no canto superior direito.

Usar a extensão de mensagens

Encontre e anexe tarefas em qualquer conversa do Microsoft Teams:

  1. Clique no ícone do suplemento do ClickUp em um canal.
  2. Pesquise uma tarefa.
  3. Clique na tarefa para visualizar os detalhes dela no canal.

Criar tarefas a partir do Microsoft Teams

Você pode criar tarefas a partir de canais ou mensagens no Microsoft Teams.

A partir de um canal

Para criar uma nova tarefa a partir de um canal do Microsoft Teams:

  1. Clique no ícone do suplemento do ClickUp em um canal.
  2. Clique no menu reticências ....
  3. Selecione Criar tarefa.
  4. Adicione os detalhes da tarefa.
  5. Clique em Criar tarefa.

Captura de tela de alguém criando uma tarefa a partir de um canal.png

A partir de uma mensagem

Para criar uma nova tarefa a partir de uma mensagem do Microsoft Teams:

  1. Passe o cursor sobre a mensagem e clique no menu reticências ....
    • Se for a primeira vez que você cria uma tarefa do ClickUp no Microsoft Teams, selecione Mais ações.
  2. Selecione Criar tarefa.
  3. Adicione os detalhes da tarefa.
  4. Clique em Criar tarefa.

Anexar mensagens do Microsoft Teams a tarefas

Para anexar uma mensagem do Microsoft Teams a uma tarefa do ClickUp:

  1. No Microsoft Teams, passe o cursor sobre a mensagem e clique no menu de reticências ....
    • Se for a primeira vez que você cria uma tarefa do ClickUp pelo Microsoft Teams, selecione Mais ações.
  2. Clique em Adicionar comentário à tarefa.
  3. Pesquise e selecione uma tarefa.
    • Opcionalmente, selecione um responsável.
  4. Clique em Adicionar para enviar o comentário.
  5. A mensagem será adicionada a um comentário do ClickUp e formatada como citação, com um link de volta ao comentário original do Microsoft Teams.

Desconectar a integração com o Microsoft Teams

Se você não quiser mais usar a integração, pode desconectá-la.

Para desconectar a integração, acesse o App Center:

  1. Localize e selecione Microsoft Teams.
  2. Clique na aba Pessoal ou Workspace.
  3. Ao lado da conexão, clique no menu de reticências ....
  4. Selecione Desconectar.

Você pode adicionar a integração com o Microsoft Teams novamente a qualquer momento.

Perguntas frequentes

Perguntas frequentes sobre a integração com o Microsoft Teams.

Preciso fazer login no ClickUp ao adicionar o suplemento do ClickUp a um canal do Microsoft Teams?

Não. Você precisa adicionar o aplicativo do ClickUp ao seu espaço de trabalho do Microsoft Teams.

No Microsoft Teams:

  1. Clique em Aplicativos.
  2. Pesquise por ClickUp.
  3. Clique em Adicionar.

Por que não consigo ver todos os meus canais do Microsoft Teams após ativar a integração?

Você precisa ser membro do canal para visualizá-lo. Novos canais que você criar ou entrar podem levar alguns minutos para sincronizar e aparecer no ClickUp. Não é necessário sair e entrar novamente para que os novos canais sejam exibidos no ClickUp.

Onde está a visualização incorporada na nova integração com o Microsoft Teams?

A visualização incorporada não é compatível no momento.

Por que não consigo acionar notificações pelo bot?

Primeiro, você precisa conectar o aplicativo do Microsoft Teams no ClickUp.

Pelo App Center no ClickUp:

  1. Localize e selecione Microsoft Teams.
  2. Selecione Pessoal.
  3. Clique em Conectar.
  4. Clique em Permitir para conceder acesso ao ClickUp.

Escopos OAuth

Para conectar o aplicativo Microsoft Teams, o ClickUp exige que um administrador da Microsoft aprove os escopos necessários.

Se a integração com o Microsoft Teams for removida, os escopos serão removidos automaticamente.

Você tem duas opções:

  • Peça a um colega que seja administrador da Microsoft para conectar o aplicativo Teams no App Center do ClickUp. Ele verá uma caixa de seleção para aprovar os escopos necessários para todos.
  • Peça a um administrador da Microsoft que siga estas etapas:
    • Abra o Azure.
    • Acesse Aplicativos empresariais.
    • Ao lado da barra de pesquisa, clique em Adicionar filtros e selecione o filtro ID do aplicativo.
    • Em ID do aplicativo, cole ea172ec1-913d-4def-9c76-27df452263e8 e clique em Aplicar.
    • Selecione o aplicativo ClickUp.
    • Abra a página Segurança e selecione Permissões.
    • Aprove os escopos necessários listados abaixo.

Tipos de permissão

A integração principal com o Microsoft Teams usa permissões delegadas, que operam em nome de um usuário conectado.

A Connected Search usa permissões de aplicativo, que operam sem uma sessão de usuário conectado. As permissões de aplicativo são solicitadas somente quando a Connected Search está habilitada e são removidas automaticamente quando ela é desabilitada.

Escopos da integração principal com o Teams (permissões delegadas)

Essas permissões operam em nome de um usuário conectado.

Escopo Descrição
AppCatalog.Read.All Permite que o aplicativo leia todos os aplicativos no catálogo de aplicativos
Calendars.ReadBasic Permite que o aplicativo leia um conjunto básico de propriedades do calendário do usuário conectado
Channel.ReadBasic.All Permite que o aplicativo leia os nomes e as descrições de todos os canais
ChannelMember.Read.All Permite que o aplicativo leia os membros de todos os canais
ChannelMessage.Read.All Permite que o aplicativo leia todas as mensagens dos canais
Chat.Read Permite que o aplicativo leia as mensagens de chat do usuário em nome do usuário conectado
OnlineMeetings.Read Permite que o aplicativo leia os detalhes de reuniões online em nome do usuário conectado
Team.ReadBasic.All Permite que o aplicativo leia os nomes e as descrições de todas as equipes
TeamMember.Read.All Permite que o aplicativo leia os membros de todas as equipes
TeamsAppInstallation.ReadWriteForTeam Concede ao aplicativo permissão para ler, instalar, atualizar e desinstalar aplicativos do Teams em qualquer equipe
User.Read Permite que o aplicativo autentique o usuário e leia seu perfil
User.Read.All Lista todos os usuários no diretório
offline_access Mantém o acesso válido

Leia o artigo da Microsoft sobre gerenciamento de permissões de aplicativos ou o artigo com informações do aplicativo para o ClickUp para saber mais.

Escopos da Connected Search (permissões de aplicativo)

Essas permissões operam sem um usuário conectado e são solicitadas somente quando a Connected Search está habilitada. Se a Connected Search for desabilitada, essas permissões serão revogadas automaticamente.

Escopo Descrição
GroupMember.Read.All Permite que o aplicativo leia associações e propriedades básicas de grupos para todos os grupos sem um usuário conectado.
Group-Conversation.Read.All Permite que o aplicativo leia conversas dos grupos aos quais ele tem acesso sem um usuário conectado.