Pesquise arquivos do GitHub a partir do ClickUp, sincronize a atividade do GitHub com as tarefas do ClickUp, crie pull requests, branches e issues do GitHub a partir do ClickUp, e muito mais.

Ao configurar a integração, você vinculará Espaços diretamente aos repositórios do GitHub, para que você sempre saiba qual trabalho está relacionado.

Os proprietários e administradores do Workspace podem conectar Espaços aos seus repositórios, permitindo que os membros adicionem seu trabalho do GitHub às tarefas.

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

O que você precisará

• A integração do GitHub está disponível em todos os planos do ClickUp.
• Somente administradores de repositório podem adicionar repositórios do GitHub ao ClickUp. Uma vez adicionados, os administradores do Workspace podem adicionar esses repositórios aos Espaços do ClickUp!
• Somente proprietários e administradores do Workspace podem atualizar as Configurações do Workspace no App Center.
• Somente proprietários e administradores do Workspace podem adicionar e vincular repositórios aos Espaços.
• Somente proprietários e administradores do Workspace podem criar conexões do Workspace. Múltiplas conexões do Workspace são permitidas.
• Membros e acima podem criar conexões pessoais.
• Convidados e membros limitados não podem usar a integração do GitHub.

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 GitHub com sua conta de usuário do ClickUp para cada Workspace que você criou ou se juntou. Os dados na sua conta do GitHub não estarão disponíveis para mais ninguém através do ClickUp.	Visualizações de link do GitHub: As visualizações de link permitem que você veja visualizações ao vivo e sincronizadas de links diretamente no ClickUp. Criar Branches e Pull Requests: Crie e associe rapidamente objetos do GitHub às tarefas. Painel de aplicativos na visualização de tarefas: Visualize links do GitHub a partir de um local central nas tarefas.	Ao usar comandos do GitHub, as pessoas só podem ver o que estão autorizadas a visualizar no GitHub.   Abrir GitHub: Abra o GitHub em uma nova aba.   Criar nova issue do GitHub: Crie uma nova issue do GitHub a partir do ClickUp.   Criar novo Gist do GitHub: Abre uma aba para a página de criação de Gist.   Criar nova branch do GitHub: Crie uma nova branch do GitHub a partir do ClickUp.   Criar novo Pull Request do GitHub: A forma mais rápida de criar um Pull Request do GitHub.
Conexão do Workspace	O proprietário ou administradores do Workspace podem habilitar o GitHub como uma conexão do Workspace. Use esta conexão para dar acesso a todos à pesquisa conectada.	Sincronizar atividade com tarefas Sincronize a atividade do GitHub com as tarefas após vincular Espaços diretamente aos repositórios do GitHub. Atualizar status da tarefa a partir do GitHub: Altere o status das suas tarefas do ClickUp diretamente do GitHub. Pesquisa conectada do Workspace: A pesquisa conectada do Workspace permite que todos os membros do Workspace pesquisem tanto registros públicos quanto privados da conta conectada. Visualizações de link do GitHub As visualizações de link permitem que você veja visualizações ao vivo e sincronizadas de links diretamente no ClickUp. Painel de aplicativos na visualização de tarefas: Visualize links do GitHub a partir de um local central nas tarefas.	Não disponível

Configurar uma conexão pessoal

Para configurar uma conexão pessoal com o GitHub:

1. No canto superior esquerdo, clique no seu avatar do Workspace e selecione Apps.

2. Procure e selecione GitHub.

3. Clique em Conectar.

4. Siga as instruções para autorizar o ClickUp, e depois clique em Concluído.

Configurar uma conexão do Workspace

Existem três etapas para configurar uma conexão do Workspace para o GitHub no ClickUp:

1. Conectar o GitHub.

2. Vincule repositórios do GitHub ao seu Workspace.

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

3. Vincule repositórios do GitHub aos Espaços do ClickUp.

Etapa 1: Conectar o GitHub

Para configurar uma conexão do Workspace para o GitHub:

1. No canto superior esquerdo, clique no seu avatar do Workspace e selecione Apps.

2. Procure e selecione GitHub.

3. Na parte superior, clique na aba Workspace.

   • Opcional: Desative a Pesquisa Conectada do Workspace clicando no botão ao lado.

4. Clique em Conectar.

5. Siga as instruções para autorizar o ClickUp.

6. Escolha quais repositórios você deseja que sejam pesquisáveis através da Pesquisa Conectada do Workspace clicando no menu suspenso Selecionar repositórios.

7. Depois de adicionar repositórios, clique em Salvar.
   

8. Clique em Próximo, e depois selecione Concluído.

Etapa 2: Adicionar repositórios do GitHub ao seu Workspace

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

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

Para adicionar um repositório ao seu Workspace:

1. Na página do GitHub no App Center, clique em Configurações no canto superior direito.
2. Clique em Adicionar repositório.
3. Selecione um repositório. 
4. Para adicionar mais repositórios, repita as etapas 2 e 3.

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

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

Após adicionar repositórios ao seu Workspace, os administradores podem conectar cada repositório a um ou mais Espaços. Os Espaços podem ter múltiplos repositórios adicionados a eles.

Para vincular um repositório a um Espaço:

1. Na página do GitHub no App Center, clique em Configurações no canto superior direito.
2. Clique no nome do repositório que você deseja vincular.
3. Clique em + Adicionar Espaço.
   
4. Pesquise e selecione um Espaço.
5. Para vincular Espaços adicionais, repita as etapas 2-4.

Mudar o formato do nome da sua branch

Se sua organização usa um formato específico para nomes de branches, você pode configurá-lo na página do GitHub no App Center. Quando as pessoas criarem branches a partir das tarefas do ClickUp, esse formato será utilizado.

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

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

Os valores disponíveis são mostrados 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 um traço.
:taskId:	O ID da tarefa do ClickUp onde a branch é criada. Inclui o prefixo necessário.
:taskName:	O nome da tarefa onde a branch é criada. Espaços são substituídos por um traço.

Para mudar o formato do nome da sua branch:

1. Na página do GitHub no App Center, clique em Configurações no canto superior direito.
2. Em Nome da branch gerada automaticamente, insira seu formato preferido para o nome da branch.
3. Clique em Salvar.

Pesquisar arquivos do GitHub usando Pesquisa Conectada

Use Pesquisa Conectada do Workspace para permitir que todos os membros do Workspace pesquisem quaisquer arquivos públicos dos repositórios que você adicionar.

Editar repositórios pesquisáveis

Para editar quais repositórios podem ser pesquisados via Pesquisa Conectada do Workspace:

1. Na página do GitHub no App Center, clique na aba Workspace.
2. Adicione ou remova repositórios da Pesquisa Conectada do Workspace:
   • Adicionar novos repositórios: Clique no menu suspenso repositórios selecionados e selecione um repositório.
   • Remover um repositório existente: À direita do repositório, clique no ícone x.

Permitir que Super Agents pesquisem no GitHub

Para permitir que um Super Agent pesquise arquivos na sua conta do GitHub conectada, ative a Pesquisa Externa para o GitHub em seu perfil.

Vincular tarefas do GitHub

O ClickUp associa automaticamente nova atividade do GitHub com tarefas se você incluir um ID da tarefa válido em qualquer parte do título do pull request, descrição do pull request, nome da branch ou mensagem do 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 será postado no pull request. Um link não será exibido ao colar manualmente um pull request em uma tarefa do ClickUp.

O comentário será postado usando a conta do GitHub da pessoa que configurou o mapeamento do repositório e 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 a commits, branches e pull requests do GitHub a partir da tarefa. Certifique-se de que a tarefa esteja localizada em um Espaço que esteja vinculado a um repositório.

Para vincular uma tarefa:

1. Abra uma tarefa e clique no
   

   ---

   Dúvidas técnicas? O suporte oficial do ClickUp resolve.

   Já para levar a produtividade da sua empresa ao próximo nível, conheça os serviços de consultoria e treinamento da Audatia, parceira certificada do ClickUp no Brasil. Agende um bate-papo →