Configurar integraciones

Esta guía cubre las dos integraciones de avisos y código: Slack y GitHub. Otras integraciones siguen patrones similares — si conoces una, conoces todas.

Antes de empezar

Todas las integraciones se configuran desde Ajustes de la organización → Conexiones → Integraciones en Orkestra. Cada integración tiene su propio flow OAuth, y necesitas permisos de admin en ambos lados (Orkestra y el servicio que vas a conectar).

Slack

La integración habilita: avisos en canal, el comando slash /orkestra, y mapeo de canales por proyecto.

Pasos

  1. Ve a Ajustes de la organización → Conexiones → Integraciones → Slack → Conectar.
  2. Autoriza la app en el workspace de Slack. Orkestra solicita permisos mínimos: leer canales, enviar mensajes, recibir comandos.
  3. De vuelta en Orkestra, asigna un canal por proyecto (opcional — sin asignación, los avisos no se envían).
  4. En Slack, prueba el comando /orkestra ayuda para ver los comandos disponibles.

Comandos disponibles

  • /orkestra crear [título de la tarea] — crea una tarea en el proyecto mapeado al canal actual.
  • /orkestra mis tareas — lista tus tareas abiertas.
  • /orkestra estado [ID] — muestra el estado de una tarea.

GitHub

La integración habilita: vincular PRs a tareas y ver el estado de cada PR en el detalle de la tarea.

Pasos

  1. Ve a Ajustes de la organización → Conexiones → Integraciones → GitHub → Conectar.
  2. Autoriza la app en tu cuenta u organización de GitHub.
  3. Selecciona los repositorios que quieres conectar. Orkestra solo procesa eventos de repos explícitamente habilitados.
  4. En los commits o el título del PR, menciona el ID de la tarea (ej: ORK-123) para vincularlos automáticamente.

Cuando se integra un PR

Cuando un PR vinculado se integra (merge), la tarea muestra el PR como integrado, pero no cambia de columna sola: la mueve una persona. Pasar una tarea a la columna siguiente es un visto bueno, y en el historial de la tarea queda quién lo dio, desde qué columna y cuándo.

Si algo falla

Todas las integraciones tienen un log de actividad en Ajustes de la organización → Conexiones → Integraciones → [nombre] → Log. Si los eventos no llegan, revisa el log antes de reinstalar la integración. Escríbenos a soporte@orkestra.team con el log si el problema persiste.

Más integraciones

Además de estas tres, tienes:

  • Google Drive — detección automática de links en tareas.
  • Google Calendar / Apple Calendar — sync de deadlines.
  • Zapier / Make — con un token personal contra la API REST (en beta).
  • Agentes IA (Claude, OpenClaw, HermesAgent) — vía MCP.