Skip to content
murmurd docs

Slack Integration

Murmurd’s Slack integration brings check-ins, escalations, and summaries directly into your team’s workspace. This is the recommended way to use Murmurd for most teams.

Why Slack?

  • Meet teams where they work: No need to switch apps
  • Faster responses: Interactive messages for quick check-ins
  • Real-time notifications: Instant updates on escalations
  • Slash commands: Create content without leaving Slack

Connecting Slack

  1. Go to Settings

    Navigate to Settings → Integrations → Slack

  2. Click Connect

    You’ll be redirected to Slack’s authorization page

  3. Authorize Murmurd

    Grant the requested permissions:

    • Send messages to you (DMs for prompts)
    • Post in channels (team notifications)
    • Read your workspace info

  4. Complete setup

    Return to Murmurd and verify the connection

Features

Check-in Prompts

Daily prompts arrive as interactive Slack DMs:

  • Submit button: Opens the check-in form
  • Skip button: Marks the day as skipped
  • Pause button: Options to pause for 1 day, 3 days, or 1 week

Slash Commands

Create an escalation from anywhere in Slack:

/escalate

Opens a modal to:

  • Select team
  • Describe the blocker
  • Set visibility
  • Submit

Team Notifications

Configure channels to receive team updates:

  • New escalations posted to team channels
  • Resolved escalations announced
  • Daily check-in summaries (optional)

Weekly Summaries

Division managers and PMs receive summary DMs:

  • Friday 4 PM: Week snapshot
  • Monday 9 AM: Weekstarter

User Setup

Each team member should link their Slack account:

  1. Go to Profile Settings

    Navigate to Settings → Profile

  2. Find Slack section

    Look for “Slack Integration” card

  3. Click Link Account

    Authorize Murmurd to send you DMs

  4. Verify connection

    You should receive a confirmation message

Required Permissions

Murmurd requests these Slack OAuth scopes:

ScopePurpose
chat:writeSend DM prompts and notifications
commandsRegister slash commands
users:readMatch Slack users to Murmurd accounts
team:readGet workspace information

Security

Token Storage

  • OAuth tokens encrypted with AES-256-GCM
  • Stored securely in our database
  • Never exposed in logs or API responses

Webhook Verification

  • All incoming webhooks verified with HMAC-SHA256
  • Signature validation prevents spoofing
  • Timestamps checked to prevent replay attacks

Data Flow

Murmurd → Slack: Sends prompts, notifications
Slack → Murmurd: Receives button clicks, command invocations

No persistent data is stored in Slack.

Troubleshooting

”I’m not receiving prompts”

  1. Check that your Slack account is linked in Profile settings
  2. Verify you’re not on vacation mode
  3. Ensure you haven’t paused prompts
  4. Check Slack notification settings

”Slash commands don’t work”

  1. Make sure the Murmurd app is installed in your workspace
  2. Try reinstalling the integration
  3. Contact your Slack admin to verify permissions

”Connection shows as disconnected”

  1. Try reconnecting from Settings → Integrations
  2. A workspace admin may have revoked the app
  3. Contact support if the issue persists

”Wrong user receiving my prompts”

  1. Verify your Slack email matches your Murmurd email
  2. Unlink and relink your Slack account
  3. Contact support with both email addresses

Disconnecting

To disconnect Slack:

  1. Go to Settings → Integrations → Slack
  2. Click Disconnect
  3. Confirm the action

After disconnecting:

  • Prompts switch to email delivery
  • Slash commands stop working
  • Historical data remains in Murmurd

Enterprise Features

For Slack Enterprise Grid:

  • Multi-workspace support
  • Centralized admin controls
  • SCIM provisioning compatibility
  • Custom retention policies

Contact sales@murmurd.com for Enterprise Slack features.

Next Steps