Conectando Integraciones

Los equipos de desarrollo modernos usan muchas herramientas—GitHub, Slack, aplicaciones de calendario, sistemas CI/CD y más. Las integraciones de GitScrum conectan estas herramientas para que la información fluya automáticamente, reduciendo el cambio de contexto y manteniendo todo sincronizado.

Categorías de Integración

Integraciones Core

Integración con GitHub

INTEGRACIÓN GITHUB
══════════════════

FUNCIONALIDADES:
├── Vincular commits a tareas
├── Auto-actualizar en PR merge
├── Creación de ramas desde tareas
├── Visibilidad de estado de build
└── Seguimiento de review de PR

CONFIGURACIÓN:
1. Settings → Integraciones → GitHub
2. Click "Conectar GitHub"
3. Autorizar GitScrum App
4. Seleccionar repositorios
5. Mapear a proyectos

CONFIGURACIÓN:
├── Patrón de ID de tarea: GS-[0-9]+
├── Auto-transición en merge: ✓
├── Mostrar commits en tarea: ✓
├── Crear ramas: ✓
└── Sincronizar comentarios de PR: Opcional

Integración con Slack

INTEGRACIÓN SLACK
═════════════════

FUNCIONALIDADES:
├── Notificaciones de tareas a canales
├── Crear tareas desde Slack
├── Resúmenes diarios/semanales
├── Alertas de menciones
└── Comandos slash

CONFIGURACIÓN:
1. Settings → Integraciones → Slack
2. Click "Agregar a Slack"
3. Autorizar permisos
4. Seleccionar workspace
5. Configurar canales

MAPEO DE CANALES:
┌─────────────────────────────────────────────────┐
│  Proyecto/Evento       │  Canal de Slack        │
├─────────────────────────────────────────────────┤
│  Proyecto Website      │  #website-dev          │
│  Bugs Críticos         │  #alertas              │
│  Actualizaciones Sprint│  #standups-equipo      │
│  Todos los Comentarios │  (Deshabilitado)       │
└─────────────────────────────────────────────────┘

COMANDOS SLASH:
├── /gs create [nombre tarea] - Crear tarea
├── /gs search [consulta] - Buscar tareas
├── /gs my - Mis tareas abiertas
└── /gs sprint - Resumen del sprint

Integración con Calendario

INTEGRACIÓN DE CALENDARIO
═════════════════════════

FUNCIONALIDADES:
├── Fechas de vencimiento como eventos
├── Sincronización de fechas de sprint
├── Sincronización de tareas de reuniones
├── Vista de disponibilidad
└── Eventos de recordatorio

CONFIGURACIÓN GOOGLE CALENDAR:
1. Settings → Integraciones → Google Calendar
2. Conectar cuenta de Google
3. Seleccionar calendarios
4. Configurar opciones de sincronización

OPCIONES DE SINCRONIZACIÓN:
├── Fechas vencimiento → Eventos calendario: ✓
├── Sprints → Bloques de calendario: ✓
├── Solo tareas asignadas: ✓
├── Incluir subtareas: ✗
└── Recordatorio antes de vencimiento: 1 día

VISTA DE CALENDARIO:
┌─────────────────────────────────────────────────┐
│  Marzo 2024                                     │
├─────────────────────────────────────────────────┤
│  Lun 18 │ GS-123: Review de API vence          │
│  Mie 20 │ Sprint 15 termina                    │
│  Jue 21 │ Sprint 16 comienza                   │
│  Vie 22 │ GS-456: Feature vence                │
└─────────────────────────────────────────────────┘

Integraciones Avanzadas

Webhooks

CONFIGURACIÓN DE WEBHOOKS
═════════════════════════

WEBHOOKS SALIENTES:
─────────────────────────────────────
Enviar datos a servicios externos cuando
eventos ocurren en GitScrum.

Configuración:
├── URL: https://tu-servicio.com/webhook
├── Secreto: [token secreto]
├── Eventos:
│   ├── ✓ Tarea creada
│   ├── ✓ Tarea completada
│   ├── ✗ Comentario agregado
│   └── ✓ Sprint iniciado
└── Headers personalizados (opcional)

PAYLOAD DE EJEMPLO:
{
  "event": "task.completed",
  "task": {
    "id": "GS-123",
    "title": "Implementar login",
    "assignee": "alex@company.com",
    "completedAt": "2024-03-15T14:30:00Z"
  },
  "project": {
    "id": "proj-456",
    "name": "Acme Website"
  }
}

API REST

API DE GITSCRUM
═══════════════

AUTENTICACIÓN:
├── API Key en header
├── Authorization: Bearer <api_key>
└── Obtener key en Settings → API

ENDPOINTS COMUNES:
─────────────────────────────────────
GET    /api/v1/tasks
POST   /api/v1/tasks
GET    /api/v1/tasks/{id}
PATCH  /api/v1/tasks/{id}
DELETE /api/v1/tasks/{id}

GET    /api/v1/projects
GET    /api/v1/sprints
POST   /api/v1/time-entries

EJEMPLO - CREAR TAREA:
─────────────────────────────────────
POST /api/v1/tasks
{
  "title": "Nueva tarea desde API",
  "project_id": "proj-123",
  "assignee_id": "user-456",
  "priority": "high",
  "labels": ["tipo:feature"]
}

RESPUESTA:
{
  "id": "GS-789",
  "title": "Nueva tarea desde API",
  "status": "todo",
  "created_at": "2024-03-15T10:00:00Z"
}

Integración con Zapier

INTEGRACIÓN ZAPIER
══════════════════

CONECTAR GITSCRUM CON 5000+ APPS:
─────────────────────────────────────

TRIGGERS (Zaps que comienzan con GitScrum):
├── Nueva tarea creada
├── Tarea completada
├── Comentario agregado
├── Sprint iniciado/terminado
└── Tarea asignada

ACTIONS (Acciones en GitScrum):
├── Crear tarea
├── Actualizar tarea
├── Agregar comentario
├── Registrar tiempo
└── Cambiar estado

EJEMPLOS DE ZAPS:
─────────────────────────────────────
• Email recibido (Gmail) → Crear tarea
• Formulario enviado (Typeform) → Crear tarea
• Tarea completada → Agregar fila (Google Sheets)
• Deal cerrado (HubSpot) → Crear proyecto
• Bug reportado (Zendesk) → Crear tarea bug

Soluciones Relacionadas

• Conectando Commits de GitHub a Tareas
• Configurando Automatizaciones de Flujo de Trabajo
• Mejores Prácticas de Comunicación Asíncrona
• Automatización de Reportes de Estado