Acerca de los tipos de webhook
Un webhook solo puede acceder a los eventos que están disponibles en el repositorio, la organización, GitHub Enterprise, o GitHub App donde está instalado.
No puede crear webhooks para cuentas de usuario individuales. Tampoco puede hacerlo 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 en una organización, necesitará permisos de administrador para dicha 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, consulta Eventos y cargas de webhook.
Para más información, consulta 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 puede crear hasta 250 webhooks que se suscriban a cada tipo de evento. Por ejemplo, en un solo repositorio solo podrías crear hasta 250 webhooks diferentes, suscritos cada uno al evento push.
Puede usar la GitHub interfaz web o la API 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 REST para administrar webhooks de repositorio, consulta 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 puede crear hasta 250 webhooks que se suscriban a cada tipo de evento por separado. Por ejemplo, en una sola organización, solo podrías crear hasta 250 webhooks diferentes, cada uno suscrito al push evento.
Puede usar la GitHub interfaz web o la API REST para administrar webhooks de la 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 REST para administrar webhooks de organización, consulta Puntos de conexión de API REST para webhooks de organización.
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 puede crear hasta 250 20 webhooks que se suscriban a cada tipo de evento individual. Por ejemplo, en una sola empresa, solo podrías crear hasta 250 webhooks diferentes, suscritos cada uno al membership evento.
Puede usar la GitHub interfaz web para administrar webhooks globales. 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 obtener una lista completa de puntos de conexión, consulta Puntos de conexión de la API de REST para los webhooks globales.
GitHub App webhooks
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 GitHub App webhook, pero puede desactivarlo para dejar de recibir entregas de webhook.
Puede usar la GitHub interfaz web o la API REST para administrar un GitHub App webhook. 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 REST para administrar GitHub App webhooks, consulte Puntos de conexión de API REST para GitHub App webhooks.