Vincule Espaços diretamente a repositórios do Bitbucket (repos) para saber sempre qual trabalho está relacionado.

Proprietários e administradores do Espaço de trabalho podem conectar Espaços aos seus repos, permitindo que os membros adicionem o trabalho do Bitbucket às tarefas.

Tarefas em Espaços com um repositório conectado podem ser vinculadas a commits, branches e pull requests.

O que você vai precisar

• A integração com o Bitbucket está disponível em todos os planos do ClickUp.
• Somente proprietários e administradores do Espaço de trabalho podem criar conexões de Espaço de trabalho. É possível ter múltiplas conexões de Espaço de trabalho.
• Membros e acima podem criar conexões pessoais.
• Convidados e membros com acesso limitado não podem usar a integração com o Bitbucket.
• Somente administradores de repositório podem adicionar repositórios do Bitbucket ao ClickUp.
• Somente proprietários e administradores do Espaço de trabalho podem atualizar as configurações do Espaço de trabalho no App Center.
• Somente proprietários e administradores do Espaço de trabalho podem adicionar e vincular repositórios a Espaços.

Tipos de conexão

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

Os comandos do ClickUp para o Bitbucket estão disponíveis somente para conexões pessoais. Os dados não ficam vinculados às conexões de Espaço de trabalho. Quando um usuário tem uma conexão pessoal ativa e executa um comando do Bitbucket, ele vê uma lista de opções — como listas de repositórios — que está autorizado a visualizar no Bitbucket.

Configurar a integração

São três etapas para configurar a integração com o Bitbucket no ClickUp:

1. Conectar o Bitbucket.
2. Anexar repositórios do Bitbucket ao seu Espaço de trabalho. Os repos são necessários para que o ClickUp possa vincular automaticamente os pull requests às respectivas tarefas do ClickUp.
3. Vincular repos do Bitbucket a Espaços do ClickUp.

Você também pode definir um formato personalizado para o nome dos branches. Esse formato é usado no painel de aplicativo da tarefa para criar branches diretamente do ClickUp.

Etapa 1: Conectar o Bitbucket

Para conectar o Bitbucket pelo App Center:

1. Pesquise e selecione Bitbucket.
2. Dependendo do tipo de conexão desejado, selecione a aba Pessoal ou Espaço de trabalho.
3. Escolha como deseja autorizar:
   • Conta do Bitbucket: Autorize usando sua conta em bitbucket.org.
   • Versão auto-hospedada: Autorize usando uma URL personalizada do Bitbucket.

     

4. Clique em Próximo.
5. Autorize o ClickUp.
6. Clique em Concluído.

Etapa 2: Anexar repositórios do Bitbucket ao seu Espaço de trabalho

Somente o proprietário da conexão pode adicionar repositórios.

Anexar um repo não concede aos usuários do ClickUp acesso ao código-fonte do seu repositório.

Para adicionar um repo a um Espaço de trabalho:

1. No App Center, pesquise e selecione Bitbucket.
2. No canto superior direito, clique em Configurações.
3. Em Conectar repositórios a Espaços, clique em Adicionar repo.
4. Selecione o repo que deseja adicionar.
5. Repita as etapas acima para adicionar mais repos.

Se não encontrar os repos corretos, verifique se você está conectado à conta certa. Um proprietário ou administrador do Espaço de trabalho deve selecionar cada repo para conectar. Os repos vinculados podem ser visualizados no App Center.

Etapa 3: Vincular repositórios do Bitbucket a Espaços do ClickUp

Depois de adicionar repos ao seu Espaço de trabalho, um administrador pode adicioná-los a um ou mais Espaços. Cada Espaço do ClickUp pode ter múltiplos repos adicionados.

Você pode adicionar ou remover repos de Espaços a qualquer momento.

Para vincular um repo a um Espaço:

1. No App Center, pesquise e selecione Bitbucket.
2. No canto superior direito, clique em Configurações.
3. Em Conectar repositórios a Espaços, clique no nome do repo que deseja vincular.
4. Clique em + Adicionar Espaço e selecione um Espaço.
5. Repita esta etapa para adicionar mais Espaços.

Definir o formato do nome do branch

Se sua organização usa um formato específico para nomes de branches, você pode defini-lo na página do Bitbucket no App Center. Quando alguém criar um branch a partir de uma tarefa do ClickUp, esse formato será aplicado.

O formato padrão é: :taskId:_:taskName:_:username:

Por exemplo: CU-ae27de_Auto-generated-naming_John-smith

As opções disponíveis estão na tabela a seguir:

Para definir o formato de nome padrão pelo Bitbucket no App Center:

1. Pesquise e selecione Bitbucket.
2. No canto superior direito, clique em Configurações.
3. Em Nome de branch gerado automaticamente, insira o formato de nome de branch de sua preferência.
4. Clique em Salvar.

Vincular tarefas pelo Bitbucket

O ClickUp associa automaticamente a nova atividade do Bitbucket às tarefas quando você inclui um ID de tarefa válido do ClickUp em qualquer parte do título do pull request, da descrição do pull request, do nome do branch ou da mensagem de commit.

Quando um ID de tarefa do ClickUp é incluído em um pull request, um comentário com um link para a tarefa do ClickUp é publicado no pull request. O link não aparece ao colar manualmente um pull request em uma tarefa do ClickUp.

O comentário é publicado usando a conta do Bitbucket da pessoa que configurou o repositório e o mapeamento de Espaço.

O ID da tarefa deve ser formatado usando uma destas opções:

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Por exemplo:

#1abc2de

CU-1abc2de

eng-123

#eng-123

Vincular tarefas pelo ClickUp

Vincule manualmente tarefas do ClickUp a commits, branches e pull requests do Bitbucket a partir das tarefas do ClickUp. Verifique se a tarefa está em um Espaço vinculado a um repositório.

Para vincular uma tarefa:

1. Abra a tarefa.
2. Na barra lateral direita, clique no ícone do Bitbucket. À direita, você verá sugestões de nomes de branch e mensagens de commit que pode copiar para a área de transferência. Você também pode copiar o ID da tarefa por ali.
3. No canto inferior direito, clique em Adicionar link do Bitbucket.

   

4. Cole o link.
5. No canto inferior direito, clique em Adicionar.

Atividade da tarefa no ClickUp

O feed de atividade da tarefa às vezes recolhe itens semelhantes para destacar os detalhes mais importantes.

Você pode realizar as seguintes ações para localizar a atividade do Bitbucket:

• Clique em Mais atualizações para mostrar atividades que foram ocultadas.
• Quando um branch é mesclado, os commits aparecem como um único item de atividade no feed da tarefa.
  • Clique no link para todos os commits para abrir um modal.
  • Clique em um commit individual para abri-lo no Bitbucket.
• Filtre a atividade da tarefa por Itens do Git.

  

Atividade ausente

Se não conseguir localizar determinada atividade, verifique se está referenciando corretamente o ID de tarefa do ClickUp para vincular a atividade no Bitbucket. Você pode usar qualquer uma das seguintes opções para referenciar suas tarefas do ClickUp em commits, nomes de branch e pull requests:

#{task_id}

CU-{task_id}

{custom_task_id}

Por exemplo:

#1abc2de

CU-1abc2de

prefix-1

Você pode vincular manualmente tarefas do ClickUp a commits, branches e pull requests do Bitbucket a partir da tarefa do ClickUp.

Prévias de links do Bitbucket

Quando você cola um link do Bitbucket no meio de uma frase ou dentro de um texto existente, ele exibe uma prévia de link inline — passe o cursor sobre ela para ver mais detalhes.

Quando você cola um link do Bitbucket em uma nova linha, pode escolher exibi-lo inline, como uma prévia ao vivo ou como uma URL comum.

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

Criar issues, branches e pull requests do Bitbucket pelo ClickUp

Crie novos branches e pull requests diretamente nas tarefas. Verifique se a tarefa está em um Espaço vinculado a um repositório.

Para criar um branch ou pull request:

1. Abra uma tarefa e clique no ícone do Bitbucket.
2. À direita, você verá sugestões de nomes de branch e mensagens de commit que pode copiar para a área de transferência. Você também pode copiar o ID da tarefa por ali.
3. No canto inferior direito, clique em Adicionar link do Bitbucket.
4. Escolha uma das seguintes opções:
   • Novo branch do Bitbucket
   • Novo pull request do Bitbucket
5. Dê um nome ao branch ou pull request.
6. Selecione um repo e preencha as informações. Adicione um branch de origem e um branch de destino, se necessário.
7. Clique em Criar.

Painel de aplicativo do Bitbucket nas tarefas

Depois de colar seu primeiro link do Bitbucket na descrição ou em um comentário de uma tarefa, você verá um novo ícone do Bitbucket na barra lateral direita de qualquer tarefa localizada em Espaços conectados a repositórios. Clique nesse ícone a qualquer momento para ver todos os links do Bitbucket publicados na tarefa.

A atividade de tarefas do Bitbucket usa o nome de usuário do ClickUp da pessoa ou o nome de usuário do Bitbucket, caso ela não tenha uma conta no ClickUp.

Atualizar status de tarefas pelo Bitbucket

Você pode atualizar o status de uma tarefa do ClickUp ao vincular um commit, enviar um commit ou criar um pull request. O ClickUp detecta automaticamente a nova atividade do Bitbucket e a associa às tarefas quando você inclui um ID de tarefa válido em qualquer parte do título do pull request, da descrição do pull request ou da mensagem de commit.

O ID da tarefa deve ser formatado usando uma destas opções:

#{task_id}[status]

CU-{task_id}[status]

{custom_task_id}[status]

#{custom_task_id}[status]

Para atualizar o status de uma tarefa:

1. Adicione o ID de tarefa do ClickUp em qualquer parte da mensagem de commit ou pull request.
2. Inclua o status atualizado da tarefa entre colchetes.

Por exemplo: #ud5b[ready]

Todos os formatos listados na seção Vincular tarefas pelo Bitbucket deste artigo podem ser usados. Para garantir a formatação correta, não adicione espaço entre o ID da tarefa e as informações de status.

Gerenciar issues, branches, pull requests e commits do Bitbucket pelo ClickUp

Após vincular issues, branches, pull requests ou commits, eles aparecem no lado direito da sua tarefa quando você clica no ícone do Bitbucket. Use o menu de reticências ... para copiar o link ou excluir o item.

Se você entrou no Espaço de trabalho como convidado, não poderá usar a integração com o Bitbucket. Entre em contato com o proprietário ou administrador do Espaço de trabalho para solicitar um upgrade para membro do Espaço de trabalho.

Após vincular um item do Bitbucket, as seguintes informações são exibidas na sua tarefa do ClickUp:

Informações da issue

Após uma issue ser vinculada, você pode ver os seguintes detalhes:

• A pessoa que abriu a issue, conhecida como autor
• Revisores atribuídos
• Link criado
• Repositório
• O status da issue
• URL

Informações do branch

Após um branch ser vinculado, você pode ver os seguintes detalhes:

• A pessoa que criou o branch, conhecida como autor
• Criador do link
• Repositório
• URL

Informações do pull request

Após um pull request ser vinculado, você pode ver os seguintes detalhes:

• A pessoa que abriu o pull request, conhecida como autor
• Revisores atribuídos
• Responsáveis
• Alterações de linha
• Link criado
• Repositório
• Branch de origem
• Branch de destino
• O status do pull request
• URL

Informações do commit

Após um commit ser vinculado, você pode ver os seguintes detalhes:

• A pessoa que criou o commit, conhecida como autor
• Alterações de linha
• Link criado
• Repositório
• URL

Adicionar sua conta do Bitbucket ao ClickUp

Configure uma conexão pessoal usando sua conta do Bitbucket.

Para adicionar sua conta do Bitbucket pelo App Center:

1. Pesquise e selecione Bitbucket.
2. Clique em Conectar.
3. Faça login no Bitbucket e autorize o ClickUp.
4. Clique em Concluído.

Problemas de conexão

Às vezes, a conta do Bitbucket errada é vinculada ou há algum problema com a conexão. Para corrigir erros de conexão, tente desconectar e reconectar seus repositórios ou toda a conta.

Essas ações não afetam a capacidade de ninguém de acessar repos usando sua conta do Bitbucket pelo Bitbucket.

Para desconectar um repositório pelo App Center:

1. Pesquise e selecione Bitbucket.
2. No canto superior direito, clique em Configurações.
3. Em Repositórios, clique no menu de reticências ... à direita do repositório.
4. Clique em Excluir do ClickUp.

A seção abaixo traz instruções para desconectar toda a sua conta.

Desconectar a integração com o Bitbucket

Se você não precisar mais acessar arquivos do Bitbucket no ClickUp, pode desconectar a integração pelo App Center:

1. Pesquise e selecione Bitbucket.
2. Selecione a aba Espaço de trabalho. Somente proprietários e administradores podem desconectar conexões de Espaço de trabalho.
3. Ao lado de Conectado, clique no menu de reticências ....
4. Selecione Desconectar.
5. Para confirmar, clique em Desconectar.