Visión General

Los webhooks de GitScrum envían notificaciones HTTP POST en tiempo real cuando ocurren eventos en tus proyectos. Automatiza flujos de trabajo e integra con sistemas externos.

Los webhooks permiten que tus sistemas externos reciban notificaciones en tiempo real cuando ocurren eventos dentro de los proyectos de GitScrum. En lugar de consultar la API por cambios, tu servidor recibe una solicitud HTTP POST en el momento en que se crea una tarea, se actualiza un sprint o se registra tiempo.

Cómo Funcionan los Webhooks

Los webhooks de GitScrum siguen un modelo simple de publicación-suscripción:

Configuras una URL de endpoint para eventos específicos en Configuración del Proyecto → Webhooks
Cuando ocurre el evento, GitScrum envía una solicitud HTTP POST a tu URL
Tu servidor procesa el payload y devuelve un código de estado 2xx

Cada webhook está vinculado a un único proyecto. Configuras endpoints por tipo de evento, dando control granular sobre qué notificaciones recibes.

Eventos Disponibles

GitScrum soporta 26 eventos de webhook en seis categorías:

Eventos de Tareas (7)

Evento	Descripción
`issues.store`	Tarea creada
`issues.update`	Tarea actualizada
`issues.move.board`	Tarea movida entre columnas del board
`issues.assignees.store`	Responsable agregado a la tarea
`issues.assignees.destroy`	Responsable eliminado de la tarea
`issues.destroy`	Tarea eliminada
`issues.move.project`	Tarea movida a otro proyecto

Eventos de Control de Tiempo (5)

Evento	Descripción
`time-tracking.issues.start`	Timer iniciado
`time-tracking.issues.stop`	Timer detenido
`time-tracking.issues.cancel`	Timer cancelado
`time-tracking.issues.destroy`	Registro de tiempo eliminado
`time-tracking.issues.store`	Registro de tiempo manual creado

Eventos de Comentarios y Medios (6)

Evento	Descripción
`comments.issues.store`	Comentario creado
`comments.issues.destroy`	Comentario eliminado
`attachments.issues.store`	Adjunto agregado
`attachments.issues.destroy`	Adjunto eliminado
`videos.issues.store`	Video agregado
`videos.issues.destroy`	Video eliminado

Eventos de User Stories (4)

Evento	Descripción
`user-stories.store`	User story creada
`user-stories.update`	User story actualizada
`user-stories.vote`	User story votada
`user-stories.destroy`	User story eliminada

Eventos de Sprints (3)

Evento	Descripción
`sprints.store`	Sprint creado
`sprints.update`	Sprint actualizado
`sprints.destroy`	Sprint eliminado

Otros Eventos (1)

Evento	Descripción
`discussions.vote`	Discusión votada

Consulta la página de cada evento para la referencia completa del payload JSON.

Características Principales

Alcance por proyecto — Cada webhook se configura dentro de un proyecto específico
Entrega vía HTTP POST — Todos los eventos se entregan como payloads JSON vía solicitudes POST
Envío síncrono — Los eventos se envían inmediatamente cuando ocurren las acciones
Encabezados personalizados — Las solicitudes incluyen X-Header: GitScrum y User-Agent: GitScrum Webhook
Log de entregas — Cada entrega de webhook se registra con código de estado y respuesta

Función Pro

Los webhooks están disponibles en los planes GitScrum Pro y superiores. Los usuarios del plan gratuito pueden ver la interfaz de configuración de webhooks, pero no pueden activar endpoints.

Requisitos

Tu endpoint de webhook debe:

Ser accesible públicamente desde internet
Aceptar solicitudes HTTP POST con cuerpo JSON
Responder con un código de estado 2xx dentro de 30 segundos
Soportar HTTPS (fuertemente recomendado)

Próximos Pasos

Inicio Rápido — Configura tu primer webhook en 5 minutos
Configurar Endpoints — Configura endpoints en la interfaz de GitScrum
Tarea Creada — Ve un ejemplo completo de payload
Formato del Payload — Entiende la estructura del payload JSON
Seguridad — Encabezados, HTTPS y consideraciones de seguridad