Webhooks del Proyecto

La pestaña Webhooks permite configurar endpoints HTTP para recibir notificaciones en tiempo real cuando ocurren eventos específicos en tu proyecto. Los sistemas externos reciben solicitudes POST instantáneas en lugar de consultar la API, habilitando flujos de trabajo automatizados e integraciones con aplicaciones personalizadas.

Descripción General

La interfaz muestra una tabla de eventos de webhook predefinidos organizados por categoría. Cada evento tiene un campo de URL de endpoint donde ingresas la dirección de tu servidor receptor. Cuando ocurre un evento, GitScrum envía una solicitud HTTP POST a la URL configurada con los datos del evento.

El encabezado muestra estadísticas incluyendo el número total de webhooks cargados y cuántos están actualmente activos (tienen URL configurada).

Categorías de Webhook

Los eventos están agrupados en categorías expandibles. Haz clic en el encabezado de una categoría para expandir o colapsar sus eventos.

Tasks

Webhooks para eventos relacionados con tareas:

• Tarea Creada (issues.store) - Se dispara cuando se crea una nueva tarea
• Tarea Actualizada (issues.update) - Se dispara cuando se modifican campos de la tarea
• Tarea Movida en Board (issues.move.board) - Se dispara cuando una tarea cambia de etapa del workflow
• Asignados Cambiados (issues.assignees) - Se dispara cuando cambian las asignaciones de la tarea
• Tarea Eliminada (issues.destroy) - Se dispara cuando se elimina una tarea
• Tarea Movida a Proyecto (issues.move.project) - Se dispara cuando una tarea se transfiere a otro proyecto
• Time Tracking (time-tracking) - Se dispara cuando se registra tiempo en una tarea

User Stories

Webhooks para eventos de user stories:

• Eventos de User Story (user-stories) - Se dispara cuando se crean, actualizan o eliminan user stories

Sprints

Webhooks para eventos de sprint:

• Eventos de Sprint (sprints) - Se dispara cuando se crean, inician, completan o modifican sprints

Otros

Webhooks para eventos adicionales del proyecto:

• Discusiones (discussions) - Se dispara cuando se crean o actualizan discusiones
• Comentarios (comments) - Se dispara cuando se agregan comentarios a tareas
• Adjuntos (attachments) - Se dispara cuando se adjuntan archivos
• Videos (videos) - Se dispara cuando se agregan videos

Configurando un Webhook

1. Expande la categoría que contiene el evento que deseas configurar
2. Localiza la fila del evento en la tabla
3. Ingresa la URL de tu endpoint en el campo de entrada
4. Presiona Enter o haz clic fuera del campo para guardar
5. El indicador de estado se vuelve verde cuando se guarda exitosamente

La URL del endpoint debe ser una URL HTTP o HTTPS válida. Se recomienda HTTPS por seguridad.

Indicadores de Estado del Webhook

Cada webhook muestra un indicador de estado:

• Punto verde - Webhook está activo con endpoint configurado
• Punto gris - Webhook no tiene endpoint configurado

El encabezado de categoría muestra un conteo de webhooks activos dentro de esa categoría (ej: "2/7" significa 2 de 7 webhooks tienen URLs configuradas).

Probando Webhooks

Probar Webhook Individual

1. Configura una URL de endpoint para el webhook
2. Haz clic en el botón de icono de prueba (icono de pulso) en la columna Acciones
3. Se envía un payload de prueba a tu endpoint
4. Mensaje de éxito o error aparece debajo del campo de entrada

Probar Todos los Webhooks

Haz clic en el botón Probar Todos en el encabezado para enviar solicitudes de prueba a todos los webhooks configurados simultáneamente. Esto es útil para verificar toda tu configuración de webhooks de una vez.

Eliminando un Webhook

1. Haz clic en el icono X en la columna Acciones
2. La URL del endpoint se limpia
3. El indicador de estado se vuelve gris
4. No se envían más eventos a ese endpoint

Requisitos del Endpoint

Tu endpoint de webhook debe:

• Aceptar solicitudes HTTP POST
• Devolver un código de estado 2xx dentro de 30 segundos
• Ser públicamente accesible desde los servidores de GitScrum
• Manejar posibles reintentos graciosamente

Mejores Prácticas

La sección de información en la parte inferior de la página muestra recomendaciones clave:

• Usa HTTPS - Encripta datos de webhook en tránsito
• Devuelve estado 2xx - Confirma la recepción inmediatamente
• Maneja reintentos - El mismo evento puede entregarse múltiples veces

Ejemplos de Integración

Automatización Personalizada: Configura webhooks para disparar tus sistemas internos cuando las tareas cambian de estado, habilitando flujos de trabajo personalizados.

Dashboards Externos: Envía eventos de tareas y sprints para actualizar dashboards en tiempo real fuera de GitScrum.

Sistemas de Notificación: Dirige eventos a tu propia infraestructura de notificaciones para alertas personalizadas.

Herramientas de Workflow: Usa URLs de webhook de plataformas de automatización como Zapier, Make o n8n para disparar flujos de trabajo de múltiples pasos.

Funciones Relacionadas

• Acceso API - Genera tokens API para acceso programático
• Integraciones - Integraciones preconstruidas con Slack, Discord, Teams y proveedores Git