¿Usas nuestra integración con GitHub para sincronizar el trabajo entre GitHub y ClickUp? Agrega automatizaciones de GitHub para crear un flujo de trabajo más eficiente. Los equipos de software pueden reducir el cambio de contexto usando automatizaciones para mantener todo al día.

Las integraciones de automatización están disponibles en los planes Business y superiores.

El administrador o propietario del Entorno de trabajo debe activar el ClickApp de Automatización.

Necesitas permisos de administrador en el repositorio de GitHub para configurar automatizaciones.

Los invitados y los miembros con acceso limitado no pueden usar la integración con GitHub.

Crear una automatización de GitHub en ClickUp

Para configurar una automatización de GitHub, desde una Lista, Subcarpeta, Carpeta o Espacio:

1. En la esquina superior derecha, haz clic en el ícono de robot.
2. Haz clic en Crear automatización:
   • Selecciona un disparador o una acción de GitHub.
   • O, desde la barra lateral izquierda, haz clic en GitHub y selecciona una plantilla de automatización.
3. Configura tu disparador, condiciones y acciones.
   • Selecciona o conecta tu cuenta de GitHub.
   • Ingresa tu nombre de usuario de GitHub, haz clic en Conectar cuenta y autoriza a ClickUp.
   • O haz clic en Crear una cuenta para crear una cuenta nueva en GitHub.com.
   • Para actualizar una cuenta de GitHub que ya autorizaste, debes quitarla y volver a agregarla.
   • Quitar una cuenta no afecta las automatizaciones existentes que la usan. Deberás volver a agregarla para crear automatizaciones de GitHub en el futuro.
   • Especifica quién puede usar tu cuenta de GitHub para crear automatizaciones.
   • Cada automatización de GitHub te permite elegir un repositorio (repo) específico.
4. Haz clic en Crear.

Automatizaciones de GitHub

Las automatizaciones de GitHub usan la misma estructura que las automatizaciones en ClickUp.

Cada automatización consta de un disparador y una acción. Los usuarios con el plan Business o superior pueden usar condiciones.

Disparadores de GitHub

Cuando los siguientes eventos ocurren en el repositorio de GitHub indicado y se cumplen las condiciones, la automatización se ejecuta y realiza una acción.

• Pull Request fusionado
• Rama fusionada
• En commit
• Revisión de Pull Request creada
• Revisión de Pull Request actualizada
• Estado de CI/CD cambiado
• Pull Request vinculado
• Rama vinculada
• Commit vinculado

Condiciones de GitHub

Las automatizaciones de GitHub relacionadas con pull requests admiten una o más condiciones.

Por ejemplo, puedes actualizar el estado de la tarea cuando se vincula un pull request a la rama main. O puedes establecer la prioridad como urgente y agregar un comentario cuando un pull request con la etiqueta hotfix se fusiona con la rama QA.

Las condiciones se pueden establecer para múltiples combinaciones de etiquetas de pull request, ref base y valores de ref head.

Lógica de condiciones

Puedes usar la siguiente lógica de condiciones:

• Es cualquiera de: El pull request incluye al menos una de las etiquetas o ramas especificadas.
• Es todas de: El pull request incluye todas las etiquetas o ramas especificadas.
• No es ninguna de: El pull request no incluye ninguna de las etiquetas o ramas especificadas.
• No es todas de: El pull request no incluye todas las etiquetas o ramas especificadas.

Para las etiquetas, puedes usar la lógica indicada anteriormente y también:

• Está definida: Al menos una etiqueta fue aplicada al pull request.
• No está definida: No se aplicaron etiquetas al pull request.

Agregar una condición

Para agregar una condición a tu automatización de GitHub:

1. Desde una automatización, en la sección del disparador, haz clic en Agregar condición.
2. Selecciona a qué debe aplicarse la condición:
   • Condición de etiqueta de GitHub: Etiquetas aplicadas al pull request.
   • Head ref: La rama de origen que contiene los cambios propuestos.
   • Base ref: La rama de destino donde se aplicarán los cambios.
3. Selecciona la lógica de condición.
4. Elige el valor de etiqueta o rama que usarás con esta condición. Las condiciones distinguen entre mayúsculas y minúsculas, y deben coincidir exactamente con el nombre de la etiqueta o rama; de lo contrario, no cumplirán los criterios y la automatización no se activará.
5. Haz clic en Agregar otro para incluir un valor adicional de etiqueta o rama.
6. Haz clic en Agregar condición para agregar múltiples condiciones.

Acciones de ClickUp

Todas las acciones de automatización, excepto la acción de webhook, están disponibles para actualizar tareas mediante disparadores de GitHub.

Para que las acciones de automatización se apliquen a tareas existentes, la tarea ya debe estar vinculada al repositorio de GitHub a través de un commit, una rama o un pull request. La acción Crear tarea es la única excepción, ya que las tareas nuevas no se pueden vincular de antemano.

Acciones en GitHub

Puedes usar automatizaciones con la acción Crear issue, que crea un nuevo issue en GitHub.

Por ejemplo, cuando se envía un formulario de error y se crea una tarea en una Lista específica, una automatización puede crear un issue en GitHub.