Visión General de Integraciones
GitScrum Studio se conecta con las herramientas que ya usas. Desde control de versiones hasta plataformas de comunicación, las integraciones extienden tu flujo de trabajo más allá de la gestión de proyectos.
Integraciones Disponibles
Control de Versiones
| Integración | Características |
|---|---|
| GitHub | Vincular PRs, sincronizar issues, auto-actualizaciones |
| GitLab | Enlaces de merge request, sincronización de issues |
| Bitbucket | Integración de pull request |
Comunicación
| Integración | Características |
|---|---|
| Slack | Notificaciones, creación de tareas desde mensajes |
| Discord | Notificaciones de canal |
| Microsoft Teams | Alertas y actualizaciones |
Calendario
| Integración | Características |
|---|---|
| Google Calendar | Sincronizar fechas límite, reuniones |
| Outlook Calendar | Fechas de entrega como eventos |
Desarrollo
| Integración | Características |
|---|---|
| Webhooks | Notificaciones de eventos personalizadas |
| API | Acceso programático completo |
Configurar Integraciones
Nivel de Workspace
Algunas integraciones aplican a todo el workspace:
- Ve a Configuración del Workspace
- Selecciona Integraciones
- Elige la integración
- Sigue el flujo de autorización
- Configura los ajustes
Nivel de Proyecto
Otras son específicas del proyecto:
- Abre Configuración del Proyecto
- Selecciona la pestaña Integraciones
- Habilita las integraciones deseadas
- Configura por integración
Integración con GitHub
Conectar
- Ve a Configuración del Workspace > Integraciones
- Haz clic en "Conectar GitHub"
- Autoriza GitScrum
- Selecciona repositorios
Características
Vinculación de Pull Request
- Referencia tarea #123 en título/descripción del PR
- La tarea muestra PR vinculado con estado
- El merge del PR puede auto-transicionar la tarea
Referencias de Commit
- Incluye número de tarea en el mensaje de commit
- Los commits aparecen en la actividad de la tarea
Creación de Branch
- Crea branch desde la tarea
- Convención de nombres:
feature/123-titulo-tarea
Integración con Slack
Conectar
- Ve a Configuración del Workspace > Integraciones
- Haz clic en "Añadir a Slack"
- Elige workspace
- Selecciona canal por defecto
Características
Notificaciones
- Tarea creada/actualizada
- Comentarios añadidos
- Asignaciones cambiadas
- Fechas de entrega próximas
Comandos
/gitscrum create- Crear tarea desde Slack/gitscrum search- Buscar tareas/gitscrum timer- Iniciar seguimiento de tiempo
Integración de Webhooks
Casos de Uso
- Notificaciones personalizadas a tus sistemas
- Integración con herramientas internas
- Registro de auditoría
- Disparar flujos de trabajo externos
Configurar Webhooks
- Ve a Configuración del Proyecto > Webhooks
- Haz clic en "Añadir Webhook"
- Ingresa:
- URL del endpoint (HTTPS requerido)
- Clave secreta (para verificación de firma)
- Eventos a disparar
- Guardar
Eventos Disponibles
| Evento | Disparador |
|---|---|
task.created | Nueva tarea añadida |
task.updated | Tarea modificada |
task.deleted | Tarea eliminada |
task.moved | Estado cambiado |
comment.created | Nuevo comentario |
sprint.started | Sprint comienza |
sprint.ended | Sprint termina |
time.logged | Entrada de tiempo añadida |
Acceso API
Claves API
- Ve a Configuración del Workspace > API
- Haz clic en "Generar Clave API"
- Nombra la clave
- Copia la clave (se muestra solo una vez)
Documentación
Documentación completa de la API disponible en:
- Referencia de la API
- Playground interactivo en configuración
- Descarga de spec OpenAPI/Swagger
Sincronización de Calendario
Google Calendar
- Conecta cuenta de Google
- Selecciona calendario para sincronización
- Configura ajustes de sincronización:
- Fechas de entrega como eventos
- Fechas de sprint como eventos
- Fechas de milestone
Permisos de Integración
Quién Puede Configurar
| Acción | Rol Requerido |
|---|---|
| Añadir integraciones de workspace | Agency Owner |
| Configurar integraciones de proyecto | Manager, Agency Owner |
| Usar integraciones | Todos los miembros |
| Generar claves API | Agency Owner |
Resolución de Problemas
Integración No Funciona
- Verifica el estado de conexión en configuración
- Verifica si OAuth no ha expirado
- Re-autoriza si es necesario
- Revisa logs de entrega de webhooks
Fallos de Webhook
Ver historial de entregas:
- Ve a Configuración del Proyecto > Webhooks
- Haz clic en el webhook
- Ve entregas recientes
- Revisa códigos de respuesta
Cómo Reportar un Problema o Solicitar una Funcionalidad
Si una integración no funciona o necesitas una nueva integración, envía comentarios a través de GitScrum Studio. En la Barra Lateral, haz clic en Tickets de Soporte y abre un ticket.