Configurar Endpoints
Configura URLs de endpoints de webhook en la Configuración del Proyecto GitScrum. Gestiona suscripciones de eventos, prueba endpoints y monitorea webhooks activos.
Configura endpoints de webhook en GitScrum para recibir notificaciones en tiempo real de eventos del proyecto. Cada tipo de evento tiene su propia URL de endpoint, dando control granular sobre qué eventos van a dónde.
Acceder a la Configuración de Webhooks
- Abre tu proyecto en GitScrum
- Haz clic en Settings en la barra lateral del proyecto
- Selecciona la pestaña Webhooks
La página de configuración de webhooks muestra una tabla con todos los eventos disponibles organizados por categoría.
Visión General de la Interfaz
Encabezado
El encabezado muestra:
- Título Webhook Endpoints
- Conteo cargado — Número total de eventos de webhook disponibles
- Conteo activo — Número de eventos con endpoints configurados
- Botón Test All — Envía solicitudes de prueba a todos los webhooks activos
Tabla de Eventos
Cada fila en la tabla contiene:
| Columna | Descripción |
|---|---|
| Estado | Punto verde = activo, punto gris = inactivo |
| Evento | Nombre e identificador del evento |
| Endpoint | Campo de entrada de URL para el servidor receptor |
| Acciones | Botones de Prueba (ícono de pulso) y Eliminar (ícono X) |
Categorías
Los eventos se agrupan en cuatro categorías expandibles:
- Tasks — Creación de tareas, actualizaciones, movimientos, responsables, control de tiempo, comentarios, adjuntos, videos
- User Stories — Creación, actualizaciones, votación y eliminación de user stories
- Sprints — Creación, actualizaciones y eliminación de sprints
- Others — Votación de discusiones
Haz clic en el encabezado de una categoría para expandir o contraer sus eventos. El encabezado muestra el conteo activo/total (ej: "3/12").
Agregar un Endpoint
- Expande la categoría que contiene tu evento objetivo
- Haz clic en el campo de URL del endpoint en la fila del evento
- Ingresa una URL HTTP o HTTPS válida
- Presiona Enter o haz clic fuera del campo
- El indicador de estado se pone verde en caso de éxito
El endpoint se guarda inmediatamente vía API. No se necesita un botón adicional "Guardar".
Eliminar un Endpoint
- Haz clic en el ícono X en la columna de Acciones
- La URL del endpoint se limpia
- El indicador de estado se pone gris
- No se envían más eventos a ese endpoint
Probar Webhooks
Probar un Único Endpoint
- Configura una URL de endpoint para un evento
- Haz clic en el ícono de prueba (ícono de pulso) en la columna de Acciones
- Un payload de prueba se envía a tu endpoint
- Verifica el mensaje de estado debajo del campo de entrada
Probar Todos los Endpoints
Haz clic en el botón Test All en el encabezado para enviar solicitudes de prueba a todos los webhooks activos simultáneamente. Esto verifica toda tu configuración de una vez.
Usar la Misma URL para Múltiples Eventos
Puedes configurar la misma URL de endpoint para múltiples eventos. Tu servidor puede diferenciar eventos examinando el payload de la solicitud, que incluye el tipo de recurso.
Para configurar en masa, ingresa la misma URL en el campo de endpoint de cada evento.
Permisos
Solo usuarios con roles de Manager u Owner pueden configurar webhooks. Otros miembros del equipo pueden ver la configuración de webhooks, pero no pueden modificar endpoints.
Requisitos del Plan
Los webhooks requieren un plan Pro o superior. La interfaz de configuración de webhooks es visible en todos los planes, pero la activación de endpoints está restringida a la función Pro.
Relacionado
- Inicio Rápido — Configura tu primer webhook
- Tarea Creada — Referencia de eventos de tareas
- Seguridad — HTTPS y detalles de encabezados