Conectar o ClickUp
O ClickUp é um rastreador de planejamento na plataforma (par do Jira): spaces, tarefas, pontos e status alimentam o value stream, o investimento por tipo de trabalho, a tela de Projeto e o vínculo PR ↔ tarefa.
Como conectar#
A conexão usa um API token pessoal do ClickUp (nunca expira, disponível em qualquer plano).
- No ClickUp, vá em Settings → Apps → API Token → Generate e copie a chave (começa com
pk_). - Na plataforma, abra Integrações, clique em Conectar no card do ClickUp e cole o token. O seu workspace é descoberto a partir dele.
- Selecione os spaces que quer acompanhar e clique em Ativar (no ClickUp, o "projeto" é o Space; as tarefas são puxadas por space).
- A sincronização do histórico começa em segundo plano; as métricas aparecem conforme os dados chegam.
O que é sincronizado#
Para cada space que você ativar, a plataforma importa:
- Tarefas com status, prioridade e tags (só metadados).
- Pontos das tarefas (alimentam velocity e os cards de pontos).
- Dev-start: quando a tarefa entrou em "em progresso" (a partir do histórico de status), para o value stream separar espera de trabalho ativo.
O vínculo PR ↔ tarefa acontece sozinho: basta o id da tarefa aparecer na branch, no título ou no
corpo do PR. A convenção do próprio ClickUp já resolve (o branch gerado por ele é algo como
CU-86b1abc_corrige-login_ana). Também reconhecemos #86b1abc e os Custom Task IDs (ex.: CLK-1).
Tempo real (webhook)#
Sem webhook, sincronizamos de hora em hora. Para tempo quase-real, ative o tempo real no card do ClickUp em Integrações: a plataforma cria o webhook no seu workspace automaticamente (com assinatura verificada) e o remove ao desconectar. Mudanças de tarefa chegam em segundos.
O tempo real exige que o backend da plataforma seja acessível publicamente pelo ClickUp.
Perguntas comuns#
Preciso pagar pelo ClickUp? Não. O API token pessoal está disponível em qualquer plano, inclusive o gratuito.
Quais spaces aparecem? Os que o usuário do token enxerga (spaces privados exigem que essa pessoa tenha acesso).
E os tipos de tarefa e sprints? Hoje importamos tarefas, status e pontos. Tipos de tarefa customizados e a ClickApp de Sprints estão no radar.