Integraciones del Proyecto

La pestaña Integraciones permite conectar GitScrum con servicios externos para sincronizar flujos de desarrollo y recibir notificaciones en tiempo real. Conecta plataformas de control de versiones para vincular commits e issues a tareas, o configura herramientas de comunicación para recibir actualizaciones del proyecto en los canales de chat de tu equipo.

Descripción General

La interfaz muestra un diseño de dos paneles. La barra lateral izquierda lista todos los proveedores de integración disponibles organizados por categoría. El panel derecho muestra las opciones de configuración para el proveedor seleccionado. Un contador en el encabezado muestra cuántas integraciones están actualmente activas.

Integraciones Disponibles

Integraciones Nativas:

Slack - Notificaciones basadas en webhook a canales
Microsoft Teams - Notificaciones basadas en webhook a canales
Discord - Notificaciones basadas en webhook a canales
GitHub (Pro) - Conexión de repositorio con sincronización de issues/commits
GitLab (Pro) - Conexión de repositorio con sincronización de issues/commits
Bitbucket (Pro) - Conexión de repositorio con sincronización de commits

Integraciones Externas:

Zapier - Conecta con más de 3,000 aplicaciones
Pabbly - Automatizaciones de flujo de trabajo
Documentación API - Enlace a documentación de API REST

Integraciones de Comunicación

Slack, Discord y Microsoft Teams usan URLs de webhook para recibir notificaciones. El proceso de configuración es idéntico para los tres proveedores.

Conectando una Plataforma de Comunicación

Selecciona el proveedor desde la barra lateral izquierda (Slack, Discord o Teams)
Obtén una URL de webhook de tu plataforma:

Slack: Crea un Incoming Webhook en la configuración de tu workspace
Discord: Crea un webhook en la configuración del canal
Teams: Agrega un conector Incoming Webhook a tu canal

Pega la URL del webhook en el campo URL del Webhook
Haz clic en Validar para probar la conexión
Opcionalmente ingresa un Nombre del Canal para referencia
Activa Integración Activa para habilitar notificaciones
Haz clic en Activar Integración para guardar

Opciones de Configuración del Webhook

URL del Webhook: La URL completa del webhook de tu plataforma. Campo requerido.

Nombre del Canal: Etiqueta opcional para tu referencia. No afecta la funcionalidad.

Integración Activa: Control principal para activar o desactivar todas las notificaciones para esta integración.

Notificar Propias Acciones: Cuando está activado, recibes notificaciones por acciones que tú realizas. Cuando está desactivado, solo las acciones de otros miembros del equipo activan notificaciones.

Eventos de Notificación

Después de activar una integración, configura qué eventos activan notificaciones. Los eventos están organizados en categorías expandibles:

Ciclo de Vida de la Tarea:

Tarea creada
Tarea eliminada

Estado de la Tarea:

Tarea movida a diferente etapa del workflow
Tarea completada
Tarea bloqueada
Tarea desbloqueada

Asignación de Tarea:

Tarea asignada a miembro del equipo

Comentarios:

Comentario creado en tarea
Usuario mencionado en comentario

Sprint:

Sprint iniciado
Sprint completado

Equipo:

Miembro se unió al proyecto
Miembro dejó el proyecto

Cada evento tiene un toggle individual. Usa los enlaces Habilitar Todos o Deshabilitar Todos en los encabezados de categoría para configurar rápidamente múltiples eventos.

Probando y Administrando

Probar Conexión: Haz clic en Probar en el encabezado para enviar una notificación de prueba y verificar que el webhook funciona correctamente.

Eliminar Integración: Haz clic en Eliminar en el encabezado para borrar la configuración de la integración. Un modal de confirmación requiere reconocimiento antes de la eliminación.

Integraciones de Control de Versiones

Las integraciones de GitHub, GitLab y Bitbucket conectan repositorios para sincronizar issues, comentarios y commits con tareas de GitScrum. Estas integraciones requieren suscripción Pro.

Configuración de GitHub

Selecciona GitHub desde la barra lateral
Genera un Personal Access Token en GitHub con scopes repo y admin:repo_hook
Pega el token en el campo Personal Access Token
Haz clic en Guardar Token para validar y almacenar
Haz clic en el botón de actualizar para cargar tus repositorios
Selecciona un repositorio del dropdown
Haz clic en Conectar Repositorio

Configuraciones de Sincronización de GitHub

Después de conectar un repositorio, configura las opciones de sincronización:

Issues:

Crear cuando issue es abierta: Crea una tarea GitScrum cuando se abre una issue de GitHub. Opcionalmente asigna a una etapa específica del workflow.
Actualizar cuando issue es cerrada: Mueve la tarea vinculada cuando la issue de GitHub se cierra. Opcionalmente mueve a una etapa específica del workflow.
Actualizar cuando issue es reabierta: Actualiza el estado de la tarea cuando la issue es reabierta.
Actualizar cuando issue es editada: Sincroniza cambios de título/descripción.
Eliminar cuando issue es eliminada: Remueve la tarea vinculada cuando la issue es eliminada.

Comentarios:

Sincronizar nuevos comentarios: Agrega comentarios de issues de GitHub a tareas vinculadas.
Sincronizar comentarios editados: Actualiza comentarios de tareas cuando los comentarios de GitHub cambian.
Remover comentarios eliminados: Elimina comentarios de tareas cuando los comentarios de GitHub son removidos.

Commits y Pull Requests:

Vincular commits a tareas: Asocia commits que mencionan IDs de tareas con las tareas. Usa códigos de tarea en mensajes de commit para vincular automáticamente.
Mover al fusionar: Opcionalmente mueve tareas vinculadas a una etapa específica del workflow cuando los commits son fusionados.

Acciones Adicionales de GitHub

Importar Issues: Haz clic en Importar Issues para importar issues existentes de GitHub como tareas de GitScrum.

Desconectar: Haz clic en Desconectar GitHub para remover la conexión del repositorio.

GitLab y Bitbucket

GitLab y Bitbucket siguen el mismo patrón de configuración:

Genera un Personal Access Token desde tu plataforma
Ingresa el token y valida
Selecciona y conecta un repositorio
Configura las opciones de sincronización para issues, comentarios y commits

Integraciones Externas

La barra lateral incluye enlaces a plataformas de integración externas:

Zapier: Abre la página de integración de GitScrum en Zapier donde puedes conectar con más de 3,000 aplicaciones usando flujos de trabajo automatizados.

Pabbly: Abre la página de integración de GitScrum en Pabbly para crear automatizaciones de flujo de trabajo.

Documentación API: Abre la documentación de la API REST de GitScrum para construir integraciones personalizadas.

Estos enlaces se abren en nuevas pestañas del navegador y no requieren configuración dentro de GitScrum.

Indicadores de Estado de Integración

Cada proveedor en la barra lateral muestra su estado actual:

Punto verde + "Conectado" - La integración está activa y funcionando
"No configurado" - No hay integración configurada para este proveedor
Contador activo - El encabezado muestra el total de integraciones activas

Mejores Prácticas

Comienza con eventos esenciales: Habilita solo notificaciones críticas inicialmente, luego expande basándote en el feedback del equipo.
Usa nombres de canal: Agrega nombres de canal descriptivos para identificar fácilmente qué canal recibe qué notificaciones.
Prueba antes de desplegar: Siempre usa los botones Validar y Probar antes de confiar en una integración.
Revisa regularmente: Revisa periódicamente los eventos habilitados para prevenir fatiga de notificaciones.

Funciones Relacionadas

Webhooks - Configuración de webhook personalizado para automatización avanzada
Acceso API - Genera tokens API para integraciones personalizadas