Acerca de los tipos de webhook
Puedes crear webhooks para suscribirte a eventos específicos disponibles en el repositorio, organización o cuentas GitHub Enterprise, o GitHub App donde está instalado.
No puede crear webhooks para cuentas de usuario individuales o para eventos específicos de recursos de usuario, como notificaciones personales o menciones.
Para administrar webhooks, debe ser propietario o tener acceso de administrador al recurso en el que se crea el webhook y se escucha eventos. Por ejemplo, para administrar webhooks de la organización, necesita permisos de administrador para esa organización.
Algunos eventos de webhook son únicos para determinados tipos de webhooks. Por ejemplo, un webhook de la organización puede suscribirse a eventos que solo se producen en el nivel de organización, al que un webhook de repositorio no se puede suscribir. Para obtener más información sobre la disponibilidad específica de cada webhook, consulte "Eventos y cargas de webhook."
Para obtener más información, vea «Acerca de webhooks».
Webhooks de repositorio
Puede crear webhooks en un repositorio para suscribirse a eventos que ocurran en ese repositorio. Debe ser propietario del repositorio o tener acceso de administrador en el repositorio para crear y administrar webhooks en un repositorio. No puede crear, editar ni eliminar webhooks en un repositorio en el que no tenga los permisos necesarios.
Puede crear varios webhooks en un único repositorio. Sin embargo, solo puedes crear hasta 250 webhooks que se suscriben a cada tipo de evento individual. Por ejemplo, en un único repositorio solo podrías crear hasta 250 webhooks diferentes que cada uno suscriba al evento push
.
Puede usar la interfaz web de GitHub o la API de REST para administrar webhooks de repositorio. Para más información, consulta "Crear webhooks," "Editar los webhooks" y "Desactivación de webhooks". Para obtener más información sobre el uso de la API de REST para administrar webhooks de repositorio, consulte “Puntos de conexión de la API de REST para los webhooks de repositorio”.
Webhooks de organización
Puede crear webhooks para suscribirse a eventos que ocurran en esa organización. Los webhooks de la organización pueden suscribirse a eventos que se producen en todos los repositorios que pertenecen a la organización. También pueden suscribirse a eventos que se producen en el nivel de organización que están fuera de cualquier repositorio determinado, como cuando se agrega un nuevo miembro a la organización.
Debe ser propietario de la organización para crear y administrar webhooks en una organización.
Puede crear varios webhooks en una sola organización. Sin embargo, solo puedes crear hasta 250 webhooks que se suscriben a cada tipo de evento individual. Por ejemplo, en una única organización solo podrías crear hasta 250 webhooks diferentes que cada uno suscriba al evento push
.
Puede usar la interfaz web de GitHub o la API de REST para administrar los webhook de organización. Para más información, consulta "Crear webhooks," "Editar los webhooks" y "Desactivación de webhooks". Para obtener más información sobre el uso de la API de REST para administrar webhooks de organización, consulte “Puntos de conexión de API REST para webhooks de organización”.
Editar webhooks globales para GitHub Enterprise
Los propietarios de empresas pueden crear webhooks globales para suscribirse a eventos que se producen dentro de su enterprise o en organizaciones y repositorios que sean propiedad de la enterprise.
Puede crear varios webhooks en una sola enterprise. Sin embargo, solo puedes crear hasta 250 webhooks que se suscriben a cada tipo de evento individual. Por ejemplo, en una única empresa solo podrías crear hasta 250 webhooks diferentes que cada uno suscriba al evento membership
.
Puede usar la interfaz web de GitHub para administrar webhooks de repositorio. Para más información, consulta "Crear webhooks," "Editar los webhooks" y "Desactivación de webhooks". También puede usar la API de REST para administrar webhooks globales. Para una lista completa de puntos de conexión, consulta «Puntos de conexión de la API de REST para los webhooks globales».
Webhooks GitHub App
Puede configurar un GitHub App para recibir webhooks cuando se produzcan eventos específicos en un repositorio u organización a los que se haya concedido acceso a la aplicación.
Cada GitHub App tiene un único webhook que se crea automáticamente mediante GitHub. De manera predeterminada, el webhook no está suscrito a ningún evento. Puede configurar los eventos a los que se suscribe el webhook. No se puede eliminar un webhook de GitHub App, pero puede desactivarlo para dejar de recibir entregas de webhook.
Puede usar la interfaz web de GitHub o la API de REST para administrar webhooks de una GitHub App. Para más información, consulta "Crear webhooks," "Editar los webhooks" y "Desactivación de webhooks". Para más información sobre el uso de la API de REST para administrar GitHub App, consulte "Puntos de conexión de la API de REST para webhooks de GitHub App".