Integrar commits, branches e pull requests do Bitbucket com tarefas do ClickUp. Isso permite que você:

• Veja toda a atividade relacionada a uma tarefa diretamente no ClickUp.

• Receba opcionalmente notificações do ClickUp quando novos itens de atividade do Bitbucket forem adicionados às tarefas.

• Anexe automaticamente (ou manualmente) atividades do Bitbucket às tarefas ClickUp.

• Altere automaticamente os Status com ações do Bitbucket adicionando o ID da tarefa ClickUp aos seus commits usando este formato #{taskID}[status] Por exemplo: #1abc2de[fechada]

O que você vai precisar

• A integração com o Bitbucket está disponível em todos os planos do ClickUp.
• Apenas proprietários e administradores do espaço de trabalho podem configurar integrações.
• Convidados não podem usar a integração com o Bitbucket.

Autorize o ClickUp a se conectar ao Bitbucket

Você pode integrar o ClickUp e o Bitbucket.org ou a versão auto-hospedada do Bitbucket. O processo de autorização é diferente dependendo da versão do Bitbucket que você usa.

• Opção 1: Autorizar uma conta Bitbucket.org

• Opção 2: Autorize uma conta Bitbucket auto-hospedada

Opção 1: Autorize uma conta Bitbucket.org

Nota: Apenas administradores do ClickUp podem vincular repositórios aos Espaços da sua Equipe.

1. Abra a Central de Aplicativos.
2. Clique em **Bitbucket**.
3. Clique em Ativar Bitbucket para Equipe.
4. Clique em + Adicionar Bitbucket.

5. Selecione No, I use Bitbucket.com e clique em Link Bitbucket.

   

6. Se você não estiver logado, será solicitado que faça login na sua conta do Bitbucket.org.

7. Revise as permissões necessárias e clique em Conceder acesso

Agora que você autorizou sua conta, prossiga para o próximo passo de vincular repositórios Bitbucket ao seu Espaço de trabalho.

Opção 2: Autorize uma conta Bitbucket auto-hospedada

Se você estiver usando uma versão auto-hospedada do Bitbucket, pode autorizar o ClickUp criando um token de acesso HTTP. Saiba mais sobre os tokens de acesso HTTP do Bitbucket.

1. Abra a Central de Aplicativos.
2. Clique em **Bitbucket**
3. Clique em Ativar o Bitbucket para a equipe
4. Clique em + Adicionar Bitbucket

5. Selecione Yes, I use a hosted version of Bitbucket (Sim, eu uso uma versão hospedada do Bitbucket ) e siga as próximas etapas no Bitbucket.

   

6. No seu Bitbucket hospedado, clique no avatar do seu perfil de usuário no canto superior direito.

7. Selecione Gerenciar conta.

   

8. Selecione tokens de acesso HTTP na barra lateral esquerda.

9. Crie um novo token de acesso com permissões de **administrador** em **projetos** e **repositórios**.

10. Copie o token de acesso HTTP fornecido.

11. De volta ao ClickUp, cole o token copiado no campo Token de acesso.

12. Insira os detalhes da sua conta Bitbucket, incluindo:

    • URL do host

    • URL canônico (opcional)

    

13. Selecione suas preferências:

    • Usar segredo hospedado?

    • IP estático

14. Clique em Vincular Bitbucket.

Agora que você autorizou sua conta, prossiga para o próximo passo de vincular repositórios Bitbucket ao seu Espaço de trabalho.

Anexe repositórios Bitbucket ao seu espaço de trabalho

O ClickUp permite que várias pessoas autorizem o Bitbucket dentro do seu Espaço de trabalho, e também permite que você personalize quais repositórios são compartilhados com seu Espaço de trabalho.

Isso significa que você pode autorizar sua conta pessoal sem anexar todos os seus repositórios; você pode personalizar quais deles anexar.

Anexar um repositório não concede aos usuários acesso ao código-fonte do seu repositório de forma alguma. Isso simplesmente permite aos usuários anexar itens de histórico para aquele repositório aos Espaço(s) que você especificar.

Nota: Vocêsó pode associar repositórios do Bitbucket onde possui acesso de administrador.

Etapa 3: selecione quais espaços estão anexados aos seus repositórios

Você pode personalizar quais Espaços os repositórios estão vinculados expandindo a lista suspensa à direita de Repos de Equipe. Para que você possa anexar itens do Bitbucket a tarefas, o espaço deve ser anexado ao repositório.

Associe automaticamente a atividade do Bitbucket no ClickUp

O ClickUp automaticamente detectará qualquer nova atividade e a associará com as tarefas.

Para habilitar isso, você deve:

Adicione um ID da tarefa ClickUp em qualquer parte do título da solicitação de pull, nome do branch ou mensagem de commit nestes formatos:

#{task_id}

CU-{task_id}

{custom_task_id}

Por exemplo:

#1abc2de

CU-1abc2de

prefixo-1

Associar manualmente a atividade do Bitbucket

1. Clique no ícone do Bitbucket em qualquer tarefa

2. Selecione um repositório

3. Selecione um Branch

4. Anexe seu commit

Altere automaticamente o status da tarefa via Bitbucket

Você também pode alterar o status de uma tarefa a partir de um commit ou pull request.
Para fazer isso:

Adicione o ID da tarefa da ClickUp em qualquer parte da mensagem de commit, assim como o status que deseja entre colchetes.
Por exemplo: #ud5b[pronto]

Nota: Você também pode vincular IDs de tarefas do Bitbucket de volta ao ClickUp!

1. Acesse as configurações do repositório

2. Clique em Links

3. Adicione novo link

4. Tipo de link: Personalizado

5. Link URL: app.clickup.com/t/\1

6. Chave de link: CU-(\w{3,10})(\[\w+\])?

Isso vale tanto para commits quanto para solicitações de pull.

Ações

Crie novos branches rapidamente e com facilidade dentro do ClickUp com nossas ações rápidas.

1. Clique no ícone do Bitbucket para abrir o modal do Git

2. À esquerda, há uma variedade de opções de cópia rápida geradas automaticamente, como nome sugerido, comando para fazer checkout e vincular um novo branch localmente, comando para vincular um único commit ou um comando para abrir uma solicitação pull

Você pode personalizar o nome gerado automaticamente usado nessas opções nas configurações de integração do Bitbucket!

Solicitações de pull

Agora, você pode criar solicitações de pull diretamente no ClickUp ou vincular as já existentes! Para criar uma nova solicitação de pull no ClickUp:

1. Clique no ícone do Bitbucket na tarefa que deseja vincular e clique no botão "Nova Solicitação de Pull".

2. No modal, um título de pull request sugerido será pré-preenchido com um título sugerido. Se você não gostar do título gerado automaticamente, pode ajustá-lo nas configurações de integração do Bitbucket.

3. Selecione um branch de destino e um branch de origem

4. Insira uma descrição

5. Crie a solicitação de pull

Assim que você criar uma solicitação de pull na ClickUp ou vincular uma existente, um link para a tarefa associada da ClickUp será adicionado à solicitação de pull!

Uma vez que uma solicitação de pull é vinculada, você poderá ver quem a abriu, o revisor (se houver um atribuído), o status de CI/CD e o status da solicitação de pull (aberta, revisão solicitada, em revisão, mesclada, fechada) tudo dentro da tarefa ClickUp vinculada!

Você está tendo problemas com o Bitbucket?

Leia nosso documento de solução de problemas ou pergunte ao suporte ao cliente do Bitbucket aqui.

Remover integração com o Bitbucket

Apenas os proprietários e administradores do Espaço de trabalho podem desativar integrações.

Para remover a integração, no App Center:

1. Selecione Bitbucket.
2. Role para baixo e clique em Remover autorização para meus repositórios no Bitbucket.