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 Marketplace cuenta, GitHub Sponsors cuenta, 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 20 webhooks que se suscriban a cada tipo de evento. Por ejemplo, en un solo repositorio solo podrías crear hasta 20 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 20 webhooks que se suscriban a cada tipo de evento por separado. Por ejemplo, en una sola organización, solo podrías crear hasta 20 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.
GitHub Marketplace webhooks
Puede crear un webhook para suscribirse a eventos relacionados con una aplicación que publicó en GitHub Marketplace. Solo se puede crear un webhook para cada aplicación en GitHub Marketplace. Solo el propietario de la aplicación o un administrador de aplicaciones con acceso a la aplicación pueden crear y administrar un GitHub Marketplace webhook.
No se puede eliminar un GitHub Marketplace webhook, pero puede desactivarlo para dejar de recibir las entregas del webhook.
Puede usar la GitHub interfaz web para administrar un GitHub Marketplace webhook. Para más información, consulta Crear webhooks, Editar los webhooks y Desactivación de webhooks.
GitHub Sponsors webhooks
Puede crear webhooks para suscribirse a eventos relacionados con GitHub Sponsors. Solo se pueden crear hasta 20 webhooks para una cuenta GitHub Sponsors.
Debe ser propietario de la cuenta o tener acceso de administrador en la cuenta patrocinada para administrar webhooks de patrocinio.
Puede usar la GitHub interfaz web para administrar GitHub Sponsors webhooks. Para más información, consulta Crear webhooks, Editar los webhooks y Desactivación de webhooks.
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.