Configurar integraciones

Esta guía cubre las tres integraciones más comunes: Slack (Pro), GitHub (Pro) y Microsoft Teams (Organization). Otras integraciones siguen patrones similares — si conoces una, conoces todas.

Antes de empezar

Todas las integraciones se configuran desde Ajustes → 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

Requiere plan Pro o superior. La integración habilita: notificaciones en canal, el comando slash /orkestra, y mapeo de canales por proyecto.

Pasos

  1. Ve a Ajustes → 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, las notificaciones 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

Requiere plan Pro o superior. La integración habilita: vincular PRs a tareas, auto-move de tareas al mergear, y estado de PR visible en el detalle de la tarea.

Pasos

  1. Ve a Ajustes → 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.

Auto-move on merge

Cuando un PR vinculado se mergea, la tarea asociada se mueve automáticamente al estado que hayas configurado (típicamente "Done" o "Ready for QA"). Configurable por proyecto desde el workflow.

Microsoft Teams

Requiere suscripción Organization. La integración envía notificaciones con Adaptive Cards y permite mapeo de canales por proyecto.

Pasos

  1. En Orkestra: Ajustes → Integraciones → Microsoft Teams → Conectar.
  2. Inicia sesión con una cuenta que tenga permisos de admin en el tenant de Microsoft 365.
  3. Acepta los permisos solicitados (leer equipos, enviar mensajes).
  4. En Orkestra, mapea cada proyecto al canal de Teams correspondiente.
  5. Prueba creando una tarea — deberías ver la notificación en el canal.

Si algo falla

Todas las integraciones tienen un log de actividad en Ajustes → 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 (plan Free).
  • Google Calendar / Apple Calendar — sync de deadlines (plan Pro).
  • Zapier / Make — vía webhooks entrantes (plan Organization).
  • Agentes IA (Claude, OpenClaw, HermesAgent) — vía MCP (plan Free).