Slack Integration

Receive OKR notifications, submit check-ins, and view progress summaries directly in Slack

Slack Integration Overview

The Slack integration connects Delvyn Studio to your Slack workspace via OAuth 2.0. Your team can submit OKR check-ins, receive automated notifications, and view progress summaries without leaving Slack.

Slash Commands

  • • /okr checkin — Submit a Key Result check-in
  • • /okr summary — View current cycle progress
  • • /okr status — View your personal KR progress dashboard
  • • /okr list — View all active OKRs for the current cycle
  • • /okr help — List available commands

Automated Notifications

  • • Weekly progress summaries (Monday 9 AM)
  • • At-risk Key Result alerts (daily)
  • • Check-in reminders via DM (daily)
  • • KR update confirmations
Prerequisites

Before You Begin

  • • You need Admin access in your Delvyn Studio organization
  • • Your Delvyn Studio plan must include integrations (Professional or Enterprise)
  • • You need admin access to your Slack workspace to approve the app installation
  • • Team members' Slack email addresses must match their Delvyn Studio accounts
Step 1: Connect Your Slack Workspace
  1. 1

    Navigate to Integrations

    Go to Settings → Integrations in your Delvyn Studio workspace

  2. 2

    Click the Slack tab

    Select the Slack tab in the integrations page

  3. 3

    Click "Connect to Slack"

    You will be redirected to Slack to authorize the app

  4. 4

    Authorize the App

    Review the permissions and click "Allow" to grant Delvyn Studio access to your Slack workspace

  5. 5

    Select Default Channel

    Choose the Slack channel where OKR notifications, summaries, and alerts will be posted

  6. 6

    Invite the Bot to the Channel

    In Slack, open the channel you selected and type /invite @Delvyn Studio to add the bot. The bot must be a member of the channel — otherwise notifications, summaries, and alerts will silently fail to post. Public channels only need the invite; private channels require a channel member to add the app.

  7. 7

    Save Settings

    Click "Save Settings" to activate the integration

OAuth Permissions (Bot Scopes)

The Slack app requests the following bot scopes: commands (slash commands), chat:write (post messages), users:read and users:read.email (match Slack users to accounts), and im:write (send DM reminders). You can revoke access at any time from Slack's App Management page.

Step 2: Using Slash Commands

Once connected, any team member whose Slack email matches their Delvyn Studio account can use slash commands in any Slack channel.

/okr checkin

Opens an interactive modal where you can:

  • Select a Key Result from your active objectives
  • Enter the current value
  • Add a comment or notes
  • Set a confidence level (On Track, At Risk, Off Track)

After submission, a confirmation message is posted to the channel.

/okr summary

Shows an ephemeral message (visible only to you) with current cycle progress, including overall percentage, objective breakdown, and Key Result statuses.

/okr status

Shows an ephemeral message (visible only to you) with your personal KR dashboard:

  • Only Key Results you own across all active objectives
  • Progress bars for each Key Result
  • Current value vs target value

/okr list

Shows an ephemeral message (visible only to you) with all active OKRs:

  • All objectives and Key Results grouped by team
  • Progress bars and status indicators
  • Owner information for each item

/okr help

Lists all available slash commands and their descriptions.

Step 3: Automated Notifications

The integration automatically sends notifications to your configured default channel and direct messages to individual team members.

Weekly Summary

Posted every Monday at 9:00 AM UTC to the default channel. Includes overall progress percentage and a breakdown for each objective with progress bars.

At-Risk Alerts

Sent daily at 9:00 AM UTC to the default channel. Lists Key Results falling behind pace — where actual progress is below the expected pace for the current point in the cycle (default threshold: below 70% of expected pace), or moving away from target. A legacy flat-threshold mode (below 50% progress) is also available.

Check-in Reminders

Sent as DMs to team members who haven't updated their Key Results in over 7 days. Includes a prompt to use /okr checkin.

Check-in Confirmations

When a check-in is submitted via the /okr checkin command, a confirmation message is posted to the channel with the updated progress.

Identity Mapping

The Slack integration matches Slack users to Delvyn Studio accounts using email addresses. When a user types a slash command, the integration looks up their Slack email and finds the corresponding Delvyn Studio account in the connected organization.

Important

  • • Each team member's Slack email must match their Delvyn Studio email
  • • If emails don't match, users will see an error when using slash commands
  • • Admins should verify email consistency before rolling out the integration