# Crear webhooks
Puede crear webhooks para suscribirse a eventos específicos que se producen en GitHub.
## Acerca de la creación de webhooks
Puede crear webhooks para suscribirse a eventos específicos en GitHub que ocurren en un repositorio, una organización, GitHub Enterprise, una cuenta de o GitHub App.
Para obtener más información sobre los diferentes tipos de webhooks, consulta [Tipos de webhooks](/es/enterprise-server@3.22/webhooks/types-of-webhooks).
Para una lista completa de eventos de webhook, consulta [Eventos y cargas de webhook](/es/enterprise-server@3.22/webhooks/webhook-events-and-payloads).
## Crear un webhook de repositorio
Puede crear un webhook para suscribirse a eventos concretos de un repositorio. Debe ser propietario del repositorio o tener acceso de administrador en el repositorio para crear webhooks en ese repositorio.
Puede usar la GitHub interfaz web o la API REST para crear un webhook de repositorio. Para obtener más información sobre el uso de la API REST para crear un webhook de repositorio, consulta [Puntos de conexión de la API de REST para los webhooks de repositorio](/es/enterprise-server@3.22/rest/repos/webhooks#create-a-repository-webhook).
1. En GitHub, navegue hasta la página principal del repositorio.
2. Debajo del nombre del repositorio, haz clic en ** Settings**. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable **** y, a continuación, haz clic en **Configuración**.
3. En la barra lateral de la izquierda, haz clic en ** Webhooks**.
4. Haga clic en **Agregar webhook**.
5. En "Dirección URL de carga útil", escriba la dirección URL donde desea recibir cargas útiles.
6. Opcionalmente, selecciona el menú desplegable **Tipo de contenido** y haz clic en un formato de datos para recibir la carga del webhook.
* **application/json** enviará la carga útil JSON directamente como cuerpo de la solicitud `POST`.
* **application/x-www-form-urlencoded** enviará la carga útil JSON como un parámetro de formulario llamado `payload`.
7. Opcionalmente, en el campo “Secreto”, escriba una cadena que se usará como clave `secret`. Debes elegir una cadena aleatoria de texto con alta entropía. Puede usar el secreto de webhook para limitar las solicitudes entrantes solo a las que se originan en GitHub. Para más información, consulta [Validación de entregas de webhook](/es/enterprise-server@3.22/webhooks/using-webhooks/validating-webhook-deliveries).
8. En "¿Qué eventos desea desencadenar este webhook?", seleccione los eventos de webhook que desea recibir. Solo deberías suscribirte a los eventos de webhook que necesites.
9. Si elige **Seleccionar eventos individuales**, seleccione los eventos que quiere que se activen en el webhook.
10. Para que el webhook se active inmediatamente después de agregar la configuración, selecciona **Activo**.
11. Haga clic en **Agregar webhook**.
Después de crear un nuevo webhook, GitHub le enviará un evento sencillo `ping` para informarle de que ha configurado el webhook correctamente. Para más información, consulta [Eventos y cargas de webhook](/es/enterprise-server@3.22/webhooks/webhook-events-and-payloads#ping).
## Crear un webhook para una organización
Puede crear un webhook para suscribirse a eventos concretos de una organización. Debe ser propietario de la organización para crear webhooks en esa organización.
Puede usar la GitHub interfaz web o la API REST para crear un webhook de la organización. Para obtener más información sobre el uso de la API REST para crear un webhook de organización, consulta [Puntos de conexión de API REST para webhooks de organización](/es/enterprise-server@3.22/rest/orgs/webhooks#create-an-organization-webhook).
1. En la esquina superior derecha de cualquier página de GitHub, haga clic en la imagen de perfil.
2. Haga clic en **Sus organizaciones**.
3. A la derecha de la organización, haga clic en **Configuración**.
4. En la barra lateral de la izquierda, haz clic en ** Webhooks**.
5. Haga clic en **Agregar webhook**.
6. En "Dirección URL de carga útil", escriba la dirección URL donde desea recibir cargas útiles.
7. Opcionalmente, selecciona el menú desplegable **Tipo de contenido** y haz clic en un formato de datos para recibir la carga del webhook.
* **application/json** enviará la carga útil JSON directamente como cuerpo de la solicitud `POST`.
* **application/x-www-form-urlencoded** enviará la carga útil JSON como un parámetro de formulario llamado `payload`.
8. Opcionalmente, en el campo “Secreto”, escriba una cadena que se usará como clave `secret`. Debes elegir una cadena aleatoria de texto con alta entropía. Puede usar el secreto de webhook para limitar las solicitudes entrantes solo a las que se originan en GitHub. Para más información, consulta [Validación de entregas de webhook](/es/enterprise-server@3.22/webhooks/using-webhooks/validating-webhook-deliveries).
9. En "¿Qué eventos desea desencadenar este webhook?", seleccione los tipos de webhooks que desea recibir. Solo deberías suscribirte a los eventos de webhook que necesites.
10. Si elige **Seleccionar eventos individuales**, seleccione los eventos que activarán el webhook.
11. Para que el webhook se active inmediatamente después de agregar la configuración, selecciona **Activo**.
12. Haga clic en **Agregar webhook**.
Después de crear un nuevo webhook, GitHub le enviará un evento sencillo `ping` para informarle de que ha configurado el webhook correctamente. Para más información, consulta [Eventos y cargas de webhook](/es/enterprise-server@3.22/webhooks/webhook-events-and-payloads#ping).
## Crear un webhook global para un GitHub Enterprise
Los propietarios de empresas pueden crear un webhook global para suscribirse a eventos que se producen dentro de su empresa.
Puede usar la GitHub interfaz web o la API REST para crear un webhook global. Para obtener más información sobre el uso de la API REST para crear un webhook global, consulta [Puntos de conexión de la API de REST para los webhooks globales](/es/enterprise-server@3.22/rest/enterprise-admin/global-webhooks).
1. En la esquina superior derecha de GitHub Enterprise Server, haz clic en la foto de perfil y luego en **Enterprise settings**.
2. En la parte superior de la página, haga clic en **Configuración**.
3. En " Settings", haz clic en **Hooks**.
4. Haga clic en **Agregar webhook**.
5. En el campo "Dirección URL de carga", escribe la dirección URL donde deseas recibir cargas.
6. Opcionalmente, selecciona el menú desplegable **Tipo de contenido** y haz clic en un formato de datos para recibir la carga del webhook.
* **application/json** enviará la carga útil JSON directamente como cuerpo de la solicitud `POST`.
* **application/x-www-form-urlencoded** enviará la carga útil JSON como un parámetro de formulario llamado `payload`.
7. Opcionalmente, en el campo “Secreto”, escriba una cadena que se usará como clave `secret`. Debes elegir una cadena aleatoria de texto con alta entropía. Puede usar el secreto de webhook para limitar las solicitudes entrantes solo a las que se originan en GitHub. Para más información, consulta [Validación de entregas de webhook](/es/enterprise-server@3.22/webhooks/using-webhooks/validating-webhook-deliveries).
8. Opcionalmente, si la dirección URL de carga es HTTPS y no desea GitHub Enterprise Server comprobar los certificados SSL al entregar cargas, en "Comprobación SSL", seleccione **Deshabilitar**. Lee la información sobre la verificación de SSL y luego haz clic en **Desactivar, entiendo que mis webhooks pueden no ser seguros**.
> \[!WARNING]
> La comprobación SSL ayuda a garantizar que las cargas de enlace se entreguen de forma segura. No es recomendable desactivar la verificación SSL.
9. En "¿Qué eventos desea desencadenar este webhook?", seleccione los tipos de webhooks que desea recibir. Solo deberías suscribirte a los eventos de webhook que necesites.
10. Si elige **Seleccionar eventos individuales**, seleccione los eventos que activarán el webhook.
11. Para que el webhook se active inmediatamente después de agregar la configuración, selecciona **Activo**.
12. Haga clic en **Agregar webhook**.
## Creación de webhooks para un GitHub App
El propietario de un GitHub App puede suscribir la aplicación a los eventos del webhook para recibir notificaciones cada vez que se produzcan determinados eventos. Si el propietario de la aplicación ha designado a algún administrador de la aplicación para un GitHub App, dichos administradores también pueden suscribir la aplicación a eventos de webhook. Para más información, consulta [Uso de webhooks con aplicaciones de GitHub](/es/enterprise-server@3.22/apps/creating-github-apps/registering-a-github-app/using-webhooks-with-github-apps).
Cada GitHub App tiene un webhook. Puede configurar el webhook al registrar un GitHub App, o puede editar la configuración de webhook para un registro existente GitHub App .
Para obtener más información sobre cómo configurar un webhook al registrar un GitHub App, vea [Registro de una aplicación de GitHub](/es/enterprise-server@3.22/apps/creating-github-apps/registering-a-github-app/registering-a-github-app).
Para configurar un webhook para un registro ya existente GitHub App:
1. En la esquina superior derecha de cualquier página, en GitHub, haz clic en la fotografía del perfil.
2. Navega a la configuración de tu cuenta.
* Para una aplicación propiedad de una cuenta personal, haga clic en **Configuración**.
* Para una aplicación propiedad de una organización:
1. Haga clic en **Sus organizaciones**.
2. A la derecha de la organización, haga clic en **Configuración**.
* Para una aplicación propiedad de una empresa:
1. Haga clic en **Configuración empresarial**.
3. Navega a los ajustes de GitHub App.
* Para una aplicación propiedad de una cuenta personal o de una organización.
1. En la barra lateral de la izquierda, haz clic en ** Developer settings** y luego en **GitHub Apps**.
* Para una aplicación propiedad de una empresa:
1. En la barra lateral izquierda, haz clic en **Configuración** y, a continuación, haz clic en **GitHub Apps**.
4. Junto al/a la GitHub App para el que desea configurar el webhook, haga clic en **Editar**.
5. En "Webhook", seleccione **Activo**.
6. En "URL de Webhook", escriba la dirección URL donde desea recibir cargas útiles.
7. Opcionalmente, en el campo “Secreto de Webhook”, escriba una cadena que se usará como clave `secret`. Debes elegir una cadena aleatoria de texto con alta entropía. Puede usar el secreto de webhook para limitar las solicitudes entrantes solo a las que se originan en GitHub. Para más información, consulta [Validación de entregas de webhook](/es/enterprise-server@3.22/webhooks/using-webhooks/validating-webhook-deliveries).
8. Haga clic en **Guardar cambios**.
9. En la barra lateral, haga clic en **Permisos y eventos**.
10. Los eventos de webhook específicos que puede seleccionar en el registro de la GitHub App vienen determinados por el tipo de permisos que has seleccionado para la aplicación. En primer lugar, deberás seleccionar los permisos que deseas que tenga la aplicación y, a continuación, puedes suscribir la aplicación a eventos de webhook relacionados con ese conjunto de permisos.
En las secciones "Repository permissions", "Organization permissions" y "Account permissions", seleccione los permisos necesarios para los eventos a los que se suscribirá la aplicación. Para más información, consulta [Elección de permisos para una aplicación de GitHub](/es/enterprise-server@3.22/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app). Para obtener más información sobre los aspectos que se deben tener en cuenta al cambiar los permisos, consulte [Modificación de un GitHub App registro](/es/enterprise-server@3.22/apps/maintaining-github-apps/modifying-a-github-app-registration#changing-the-permissions-of-a-github-app).
11. En "Suscribirse a eventos", seleccione los eventos de webhook que desea GitHub App recibir.
12. Haga clic en **Guardar cambios**.
También puede usar la API REST para crear un webhook para un GitHub App. Para más información, consulta [Puntos de conexión de API REST para GitHub App webhooks](/es/enterprise-server@3.22/rest/apps/webhooks).
## Información adicional
* [Acerca de webhooks](/es/enterprise-server@3.22/webhooks/about-webhooks)
* [Gestionar las entregas de los webhooks](/es/enterprise-server@3.22/webhooks/using-webhooks/handling-webhook-deliveries)