GitHub activadores web

Los activadores web GitHub están configurados para monitorear eventos en un GitHub repositorio o una organización.

Descripción general

LosGitHub activadores web escuchan eventos específicos en una organización GitHub o repositorio. Cuando los eventos de se producen en la organización o en el repositorio , el activador inicia el flujo de trabajo de automatización configurado.

Autenticación

Los activadores web GitHub utilizan los tókenes de acceso personal para la autenticación del usuario y no requieren una conexión ‌OAuth. Para obtener más información sobre la creación y gestión de tókenes de acceso personal, consulte Administración de tókenes de acceso personal. El activador web GitHub admite tókenes de acceso clásicos y detallados. Asegúrese de que los Tókenes de acceso personal sean válidos.

Puede almacenar este token en la Credential Vault. Consulte Credenciales y lockers en Credential Vault para obtener más información sobre el almacenamiento y mantenimiento de credenciales.

Eventos admitidos

Los activadores de web de GitHub admiten los siguientes eventos tanto a nivel de organización como de repositorio:

Eventos Descripción
Crear Cuando se crea un archivo, una rama o una etiqueta.
Bifurcación Cuando se bifurca un repositorio.
Comentario sobre el problema Cuando se agrega un comentario a un problema o a una solicitud de extracción.
Problemas Cuando se crea un problema a nivel de repositorio.
Etiqueta Cuando se agrega o se elimina una etiqueta de un problema o una solicitud de extracción.
Solicitud de extracción Cuando se realiza una solicitud de extracción en una rama dentro del repositorio.
Revisión de solicitudes de extracción Cuando se agregan comentarios de revisión a la solicitud de extracción.
Push Cuando se hace un envío a una rama del repositorio.
Estrella Cuando se marca un repositorio como favorito
Ver Cuando la opción de seguimiento está habilitada para eventos específicos dentro del repositorio.

Requisitos previos

Asegúrese de que se cumplan los siguientes requisitos previos:

  • Una licencia de Bot Creator o Citizen Developer.
  • Permisos Ver mis bots y ACTIVADORES DE EVENTOS.
  • Permisos Registro y Descarga en las carpetas en las que se encuentra la automatización.
  • Un GitHub Token de acceso personal activo.

Configuración

Las siguientes configuraciones están disponibles para los GitHub activadores web:

Captura de pantalla del activador web de la organización GitHub

Captura de pantalla de la configuración del activador web del repositorio GitHub

Escuchar el evento
Seleccione uno o más eventos que el activador debe monitorear.
Nombre de la organización
Ingrese el nombre de la organización GitHub. Este campo es aplicable solo para el activador web de la organización GitHub.
Nombre del repositorio
Ingrese el nombre del repositorio dentro de la organización GitHub. Este campo es aplicable solo para el activador web del repositorio GitHub.
Perfil del usuario
Ingrese el perfil de usuario de GitHub. Este campo es aplicable solo para el activador web del repositorio GitHub
Seleccione el tipo de autenticación
Token de acceso personal es el tipo de autenticación predeterminado. Puede seleccionar los Tókenes de acceso personal almacenados en la Credential Vault usando la opción Elegir en Credencial o ingresar los Tókenes de acceso personal directamente en la opción String insegura.
Respuesta (opcional)
Use la opción Respuesta para guardar los datos de respuesta del activador en una variable de Registro. Puede crear una nueva variable o seleccionar una variable existente para almacenar estos datos de respuesta. Los datos de respuesta del activador capturan la información del cuerpo de la respuesta de la carga de la API webhook de GitHub en un formato de par clave-valor. Utilice la clave como un nombre en la variable Registro, permitiendo que estos datos sirvan como entradas para otras acciones dentro de la automatización.
Los activadores web de GitHub analizan la carga útil de pares clave-valor del webhook utilizando una anotación de punto (.). Debe seguir el mismo formato para construir la expresión de la variable Registro. Por ejemplo, para usar el ID del repositorio como expresión, debe ingresar repository.id como la clave. Para obtener más información sobre la documentación de cargas útiles de webhook de GitHub, consulte GitHub webook events and payload.
Una vez que el bot termina de ejecutarse, el Audit log registra los datos de respuesta del activador en una ejecución de bot por evento de activador.