Set up integrations

This guide covers the two integrations for notifications and code: Slack and GitHub. Other integrations follow similar patterns — if you know one, you know all.

Before you start

All integrations are configured from Organization settings → Connections → Integrations in Orkestra. Each integration has its own OAuth flow, and you need admin permissions on both sides (Orkestra and the service you’re connecting).

Slack

The integration enables: channel notifications, the /orkestra slash command, and per-project channel mapping.

Steps

  1. Go to Organization settings → Connections → Integrations → Slack → Connect.
  2. Authorize the app in your Slack workspace. Orkestra requests minimal permissions: read channels, send messages, receive commands.
  3. Back in Orkestra, assign a channel per project (optional — without assignment, notifications aren’t sent).
  4. In Slack, try the command /orkestra help to see available commands.

Available commands

  • /orkestra create [task title] — creates a task in the project mapped to the current channel.
  • /orkestra my tasks — lists your open tasks.
  • /orkestra status [ID] — shows a task’s state.

GitHub

The integration enables: linking PRs to tasks and seeing each PR’s status in task detail.

Steps

  1. Go to Organization settings → Connections → Integrations → GitHub → Connect.
  2. Authorize the app in your GitHub account or organization.
  3. Select the repositories you want to connect. Orkestra only processes events from explicitly enabled repos.
  4. In commits or PR titles, mention the task ID (e.g. ORK-123) to link automatically.

When a PR is merged

When a linked PR is merged, the task shows the PR as merged but does not change column on its own: a person moves it. Moving a task to the next column is a sign-off, and the task’s history records who gave it, from which column and when.

If something fails

All integrations have an activity log at Organization settings → Connections → Integrations → [name] → Log. If events aren’t arriving, check the log before reinstalling the integration. Write to us at soporte@orkestra.team with the log if the problem persists.

More integrations

Beyond these three, you also have:

  • Google Drive — auto-detection of links in tasks.
  • Google Calendar / Apple Calendar — due date sync.
  • Zapier / Make — with a personal token against the REST API (in beta).
  • AI Agents (Claude, OpenClaw, HermesAgent) — via MCP.