Skip to main content

Tipos de webhooks

Puedes crear webhooks para suscribirte a eventos específicos que se producen en un repositorio, organización o cuentas GitHub Marketplace, GitHub Sponsors, o GitHub App.

Acerca de los tipos de webhook

Puedes crear webhooks para suscribirte a eventos específicos disponibles en el repositorio, organización o cuentas GitHub Marketplace, GitHub Sponsors, 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 20 webhooks que se suscriben a cada tipo de evento individual. Por ejemplo, en un único repositorio solo podrías crear hasta 20 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 20 webhooks que se suscriben a cada tipo de evento individual. Por ejemplo, en una única organización solo podrías crear hasta 20 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”.

Webhooks GitHub Marketplace

Puede crear un webhook para suscribirse a eventos relacionados con una aplicación que publicó en GitHub Marketplace. Solo puede crear un webhook para cada aplicación en GitHub Marketplace. Solo el propietario de la aplicación, o un administrador de aplicaciones para la organización que posee la aplicación, puede crear y administrar un webhook GitHub Marketplace.

No se puede eliminar un webhook de GitHub Marketplace, pero puede desactivarlo para dejar de recibir entregas de webhook.

Puede usar la interfaz web de GitHub para administrar un webhook de GitHub Marketplace. Para más información, consulta "Crear webhooks," "Editar los webhooks" y "Desactivación de webhooks".

Webhooks GitHub Sponsors

Puede crear webhooks para suscribirse a eventos relacionados con GitHub Sponsors. Solo puedes 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 interfaz web de GitHub para administrar webhooks GitHub Sponsors. Para más información, consulte "Crear webhooks," "Editar los webhooks" y "Desactivación de webhooks".

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".