Set up integrations

This guide covers the three most common integrations: Slack (Pro), GitHub (Pro) and Microsoft Teams (Organization). Other integrations follow similar patterns — if you know one, you know all.

Before you start

All integrations are configured from Settings → 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

Requires Pro plan or higher. The integration enables: channel notifications, the /orkestra slash command, and per-project channel mapping.

Steps

  1. Go to Settings → 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

Requires Pro plan or higher. The integration enables: linking PRs to tasks, auto-move of tasks on merge, and PR status visible in task detail.

Steps

  1. Go to Settings → 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.

Auto-move on merge

When a linked PR is merged, the associated task automatically moves to the state you've configured (typically "Done" or "Ready for QA"). Configurable per project from the workflow.

Microsoft Teams

Requires Organization subscription. The integration sends notifications via Adaptive Cards and allows per-project channel mapping.

Steps

  1. In Orkestra: Settings → Integrations → Microsoft Teams → Connect.
  2. Sign in with an account that has admin permissions in the Microsoft 365 tenant.
  3. Accept the requested permissions (read teams, send messages).
  4. In Orkestra, map each project to the corresponding Teams channel.
  5. Test by creating a task — you should see the notification in the channel.

If something fails

All integrations have an activity log at Settings → 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 (Free plan).
  • Google Calendar / Apple Calendar — deadline sync (Pro plan).
  • Zapier / Make — via inbound webhooks (Organization plan).
  • AI Agents (Claude, OpenClaw, HermesAgent) — via MCP (Free plan).