Pesquisa

Me pergunte qualquer coisa

Use as Automações do GitHub

Está usando nossa integração com o GitHub para sincronizar o trabalho entre o GitHub e o ClickUp? Adicione Automações do GitHub para criar um fluxo de trabalho eficiente. As equipes de software podem reduzir a troca de contexto usando Automações para manter tudo atualizado.

Integrações de Automação estão disponíveis para planos Business e superiores.

O administrador ou proprietário do Espaço de trabalho deve ativar o ClickApp de Automação.

Você precisa de permissões de administrador no repositório do GitHub para configurar Automações.

Convidados e membros com acesso limitado não podem usar a integração com o GitHub.

Criar uma Automação do GitHub no ClickUp

Para configurar uma Automação do GitHub, a partir de uma Lista, Subpasta, Pasta ou Espaço:

  1. No canto superior direito, clique no ícone de robô.
  2. Clique em Criar Automação:
    • Selecione um gatilho ou uma ação do GitHub.
    • Ou, na barra lateral esquerda, clique em GitHub e selecione um modelo de Automação.
  3. Configure o Gatilho, as Condições e as Ações.
    • Selecione ou conecte sua conta do GitHub.
    • Insira seu nome de usuário do GitHub, clique em Conectar Conta e autorize o ClickUp.
    • Ou clique em Criar uma conta para criar uma nova conta no GitHub.com.
    • Para atualizar uma conta do GitHub autorizada anteriormente, você precisa removê-la e adicioná-la novamente.
    • Remover uma conta não afeta nenhuma Automação existente que use essa conta. Você precisará adicioná-la novamente para criar Automações do GitHub no futuro.
    • Especifique quem pode usar sua conta do GitHub para criar Automações.
    • Cada Automação do GitHub permite escolher um repositório específico (repo).
  4. Clique em Criar.

Automações do GitHub

As Automações do GitHub usam a mesma estrutura das Automações no ClickUp.

Cada Automação é composta por um Gatilho e uma Ação. Usuários do plano Business e superiores têm a opção de usar Condições.

Gatilhos do GitHub

Quando os eventos a seguir ocorrem no repositório do GitHub especificado e as Condições são atendidas, a Automação é executada e realiza uma Ação.

  • Pull Request mesclado
  • Branch mesclado
  • No commit
  • Revisão de pull request criada
  • Revisão de pull request atualizada
  • Status de CI/CD alterado
  • Pull request vinculado
  • Branch vinculado
  • Commit vinculado

Condições do GitHub

As Automações do GitHub relacionadas a pull requests suportam uma ou mais Condições.

Por exemplo, você pode atualizar o status da tarefa quando um pull request para o branch main for vinculado. Ou definir a prioridade da tarefa como urgente e adicionar um comentário quando um pull request com a etiqueta hotfix for mesclado ao branch QA.

As Condições podem ser definidas para múltiplas combinações de etiquetas de pull request, base ref e valores de head ref.

Lógica de condição

Você pode usar a seguinte lógica de Condição:

  • é qualquer um de: O pull request inclui pelo menos uma das etiquetas ou branches especificados.
  • é todos de: O pull request inclui todos os branches ou etiquetas especificados.
  • não é nenhum de: O pull request não inclui nenhuma das etiquetas ou branches especificados.
  • não é todos de: O pull request não inclui todos os branches ou etiquetas especificados.

Para etiquetas, você pode usar a lógica listada acima e também:

  • está definido: Pelo menos uma etiqueta foi aplicada ao pull request.
  • não está definido: Nenhuma etiqueta foi aplicada ao pull request.

Adicionar uma condição

Para adicionar uma Condição à sua Automação do GitHub:

  1. Em uma Automação, na seção Gatilho, clique em Adicionar Condição.
  2. Selecione ao que a condição deve se aplicar:
    • Condição de etiqueta do Github: Etiquetas aplicadas ao pull request.
    • Head ref: O branch de origem que contém as alterações propostas.
    • Base ref: O branch de destino onde as alterações serão aplicadas.
  3. Selecione a lógica de Condição.
  4. Escolha o valor de etiqueta ou branch a ser usado com esta condição. As Condições diferenciam maiúsculas de minúsculas e devem corresponder exatamente ao nome da etiqueta ou do branch — caso contrário, os critérios não serão atendidos e a Automação não será acionada.
  5. Clique em Adicionar outro para incluir um valor adicional de etiqueta ou branch.
  6. Clique em Adicionar Condição para adicionar múltiplas Condições.

Ações do ClickUp

Toda Ação de Automação, exceto a ação de webhook, está disponível para atualizar tarefas usando Gatilhos do GitHub.

Para que as Ações de Automação sejam aplicadas a tarefas existentes, a tarefa já deve estar vinculada ao repositório do GitHub por meio de um commit, branch ou pull request. A ação Criar Tarefa é a única exceção, já que novas tarefas não podem ser vinculadas com antecedência.

Ações no GitHub

Você pode usar Automações com a Ação Criar Issue, que cria um novo issue no GitHub.

Por exemplo, quando um formulário de bug é enviado e cria uma tarefa em uma Lista específica, uma Automação pode criar um issue no GitHub.