Link Espaços diretamente com repositórios do Bitbucket (repos) para que você sempre saiba qual trabalho está relacionado.

Os proprietários e administradores do Workspace podem conectar Espaços aos seus repos, permitindo que os membros adicionem seu trabalho do Bitbucket a tarefas.

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

O que você precisará

• A integração do Bitbucket está disponível em todos os planos do ClickUp.
• Apenas os proprietários e administradores do Workspace podem criar conexões de Workspace. Múltiplas conexões de Workspace são permitidas.
• Membros e acima podem criar conexões pessoais. 
• Convidados e membros limitados não podem usar a integração do Bitbucket.
• Apenas administradores de repositório podem adicionar repositórios do Bitbucket ao ClickUp.
• Apenas proprietários e administradores do Workspace podem atualizar as Configurações do Workspace no App Center.
• Apenas os proprietários e administradores do Workspace podem adicionar e vincular repositórios aos 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 apenas para conexões pessoais. Os dados não estão vinculados às conexões do Workspace. Quando um usuário tem uma conexão pessoal habilitada e executa um comando do Bitbucket, ele verá uma lista de opções, como listas de repositórios, que ele está autorizado a visualizar no Bitbucket.

Tipo de conexão	Descrição	Recursos	Comandos
Conexão pessoal	Conecte sua conta do Bitbucket com sua conta de usuário do ClickUp. Os dados na sua conta do Bitbucket não estarão disponíveis para mais ninguém através do ClickUp.	Visualizar links do Bitbucket no ClickUp: As prévias de links permitem que você veja visualizações ao vivo e sincronizadas de links diretamente no ClickUp. Painel de aplicativo na visualização de tarefas: Visualize links do Bitbucket de um lugar central nas tarefas.	Abrir Bitbucket: Abra o Bitbucket em uma nova aba do navegador.   Criar nova branch do Bitbucket: Crie uma nova branch do Bitbucket a partir do ClickUp.   Criar nova Pull Request do Bitbucket: A maneira mais rápida de criar uma Pull Request do Bitbucket.
Conexão do Workspace	O proprietário ou administradores do Workspace podem habilitar o Bitbucket como uma conexão do Workspace.	Sincronizar atividade com tarefas: Sincronize a atividade do Bitbucket com tarefas do ClickUp para garantir que toda a sua equipe sempre saiba onde os projetos estão.   Atualizar status da tarefa a partir do Bitbucket: Altere os status das tarefas sem sair do Bitbucket.   Visualizar links do Bitbucket no ClickUp: Veja visualizações ao vivo e sincronizadas de links diretamente no ClickUp.   Painel de aplicativo na visualização de tarefas: Visualize links do Bitbucket de um lugar central nas tarefas.

Configurar a integração

Existem três etapas para configurar a integração do Bitbucket no ClickUp:

1. Conectar o Bitbucket.
2. Anexar repositórios do Bitbucket ao seu Workspace.

   Repos são necessários para que o ClickUp possa vincular automaticamente pull requests às suas respectivas tarefas do ClickUp.

3. Vincular repositórios do Bitbucket aos Espaços do ClickUp.

Você pode opcionalmente definir um formato de nome de branch personalizado. Este formato é usado no painel de aplicativos da tarefa para criar branches diretamente do ClickUp.

Etapa 1: Conectar o Bitbucket

Para conectar o Bitbucket a partir do App Center:

1. Pesquise e selecione Bitbucket.
2. Dependendo do tipo de conexão que você deseja, selecione a aba Pessoal ou Workspace.
3. Escolha como deseja autorizar:
   • Conta do Bitbucket: Autorize usando sua conta 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 Workspace

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

Anexar um repo não dá acesso aos usuários do ClickUp ao código do seu repo.

Para adicionar um repo a um Workspace:

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

Se você não vê os repos corretos, certifique-se de que está conectado à conta certa. Um proprietário ou administrador do Workspace deve selecionar cada repo para conectar. Repos vinculados podem ser visualizados no App Center.

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

Após adicionar repos ao seu Workspace, um administrador pode adicionar cada repo 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 aos 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.

Defina seu formato de nome de 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 as pessoas criarem branches a partir de tarefas do ClickUp, esse formato será utilizado.

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

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

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

Valor	Descrição
:username:	O nome de usuário da conta do ClickUp que criou a branch. Espaços são substituídos por _.
:taskId:	O ID da tarefa do ClickUp onde a branch é criada. O ID inclui o prefixo necessário.
:taskName:	O nome da tarefa onde a branch é criada. Espaços são substituídos por _.

Para definir seu formato de nome padrão a partir do Bitbucket no App Center:

1. Pesquise e selecione Bitbucket.
2. No canto superior direito, clique em Configurações.
3. Em Nome de branch auto-gerado, insira seu formato de nome de branch preferido.
4. Clique Salvar.

Vincular tarefas do Bitbucket

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

Quando um ID de tarefa do ClickUp é incluído em uma pull request, um comentário com um link para a tarefa do ClickUp será postado na pull request. Um link não será exibido ao colar manualmente uma pull request em uma tarefa do ClickUp.

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

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

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Por exemplo:

#1abc2de

CU-1abc2de

eng-123

#eng-123

Vincular tarefas do ClickUp

Vincule manualmente tarefas do ClickUp com commits, branches e pull requests do Bitbucket a partir de tarefas do ClickUp. Certifique-se de que a tarefa esteja localizada em um Espaço que esteja vinculado a um repo.

Para vincular uma tarefa:

1. Abra a tarefa.
2. Na barra lateral direita, clique no ícone Bitbucket .

   À direita, você verá nomes de branches sugeridos e mensagens de commit que pode copiar para sua área de transferência. Você também pode copiar o ID da tarefa daqui.

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 do ClickUp

O feed de atividade da tarefa às vezes agrupa itens de atividade semelhantes para garantir que você veja os detalhes mais importantes.

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

• Clique em Mais atualizações para revelar atividades que foram ocultadas.
• Quando uma branch é mesclada, os commits são exibidos como um único item de atividade no feed de atividade da tarefa.
  • Clique no link para todos os commits para abrir um modal.
  • Clique em um commit individual para abri-lo no Bitbucket.
• Filtrar a atividade da tarefa por itens do Git.
  

Atividade ausente 

Se você não conseguir localizar certa atividade, certifique-se de que está referenciando corretamente o ID da 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 branches 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 com commits, branches e pull requests do Bitbucket a partir da tarefa do ClickUp.

Pré-visualizações de links do Bitbucket

Quando você cola um link do Bitbucket em uma tarefa do ClickUp, Chat ou Doc, você verá a opção de colá-lo como uma prévia, menção ou URL.

Criar problemas, branches e pull requests do Bitbucket a partir do ClickUp

Crie novas branches e pull requests diretamente a partir das tarefas. Certifique-se de que a tarefa esteja localizada em um Espaço que esteja vinculado a um repositório.

Para criar uma branch ou pull request:

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

Painel do aplicativo do Bitbucket nas tarefas

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

A atividade da tarefa do Bitbucket usa o nome de usuário do ClickUp da pessoa, ou seu nome de usuário do Bitbucket se ela não tiver uma conta do ClickUp.

Atualizar status das tarefas a partir do Bitbucket

Você pode atualizar o status de uma tarefa do ClickUp quando você vincula um commit, faz um push de um commit ou cria uma pull request. O ClickUp automaticamente captura nova atividade do Bitbucket e a associa a tarefas se você incluir um ID de tarefa válido em qualquer parte do título da pull request, descrição da pull request ou mensagem do commit.

O ID da tarefa deve ser formatado usando uma dessas 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 da tarefa do ClickUp em qualquer parte da mensagem do commit ou pull request.
2. Inclua o status da tarefa atualizado entre colchetes.

Por exemplo: #ud5b[pronto]

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

Gerenciar problemas, branches, pull requests e commits do Bitbucket a partir do ClickUp

Depois de vincular problemas, branches, pull requests ou commits, eles são exibidos no lado direito da sua tarefa quando você clica no ícone Bitbucket. Use o menu reticências … para copiar o link ou excluir o item.

Se você se juntou ao Workspace como convidado, não poderá usar a integração do Bitbucket. Entre em contato com o proprietário ou administrador do seu Workspace para solicitar uma atualização para membro do Workspace.

Uma vez que você vincule um item do Bitbucket, as seguintes informações são exibidas na sua tarefa do ClickUp:

Informações do problema

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

• A pessoa que abriu o problema, conhecida como autor
• Quaisquer revisores designados
• Link criado
• Repositório
• O status do problema.
• URL

Informações da branch

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

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

Informações da pull request

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

• A pessoa que abriu a pull request, conhecida como autor
• Quaisquer revisores designados
• Designados
• Alterações de linha
• Link criado
• Repositório
• Branch de origem
• Branch de destino
• O status da 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

Adicione sua conta do Bitbucket ao ClickUp

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

Para adicionar sua conta do Bitbucket a partir do 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 errada do Bitbucket está vinculada ou há um 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 impactam a capacidade de ninguém acessar repos usando sua conta do Bitbucket através do Bitbucket.

Para desconectar um repositório a partir do App Center:

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

A seção abaixo inclui instruções para desconectar sua conta inteira.

Desconectar a integração do Bitbucket

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

1. Pesquise e selecione Bitbucket.
2. Selecione a aba Workspace.

   Apenas proprietários e administradores podem desconectar conexões do Workspace.

3. Ao lado de Conectado, clique no menu reticências ….
4. Selecione Desconectar.
5. Para confirmar, clique em Desconectar.

---

Ficou com alguma dúvida? Acione o suporte oficial a qualquer momento.

Para soluções completas de implantação, treinamento ou licenciamento no Brasil, conte com a Audatia, parceira oficial do ClickUp. Descubra como podemos ajudar →