Skip to main content

Slack Integration

Connect Recapt with Slack to share session recordings with your team and receive notifications about important user events.

Features​

  • Share Sessions: Send session links directly to Slack channels
  • Team Notifications: Get notified about sessions matching certain criteria
  • Mentions: Tag team members with session context
  • Quick Access: Open sessions directly from Slack messages

Prerequisites​

Before setting up the Slack integration, ensure you have:

  • A Recapt account with admin access
  • A Slack workspace where you have permission to install apps
  • At least one whitelisted domain with active session recording

Setup Instructions​

Step 1: Navigate to Integrations​

  1. Log in to your Recapt dashboard
  2. Go to Settings > Integrations
  3. Find Slack in the integrations list
  4. Click Connect

Step 2: Authorize Recapt​

  1. You'll be redirected to Slack's authorization page
  2. Select the workspace you want to connect
  3. Review the permissions Recapt is requesting
  4. Click Allow to authorize the connection

Step 3: Complete Setup​

After authorization, you'll be redirected back to Recapt:

  1. The integration status will show as "Connected"
  2. Your Slack workspace name will be displayed
  3. You can now start using Slack features

Sharing Sessions to Slack​

From the Session Viewer​

  1. Open a session in Recapt
  2. Click the Share button in the toolbar
  3. Select Share to Slack
  4. Choose a channel or user
  5. Optionally add a message
  6. Click Send

The session link will be posted to Slack with a preview showing:

  • Session duration
  • User information (if identified)
  • Page URL
  • Timestamp

From Session Comments​

When you mention a team member in a session comment:

  1. Add a comment to a session
  2. Type @ followed by a team member's name
  3. The mentioned user receives a Slack notification
  4. The notification includes a link to the session and comment
info

Team members must have their email addresses matched between Recapt and Slack for mentions to work.

Slack Message Format​

When a session is shared to Slack, the message includes:

🎬 Session Recording Shared

User: john@example.com
Duration: 5m 32s
Page: /checkout/payment
Recorded: Feb 3, 2026 at 2:45 PM

[View Session] [View in Recapt]

Managing the Integration​

Viewing Connection Status​

  1. Go to Settings > Integrations > Slack
  2. View the connected workspace information
  3. See when the integration was connected

Reconnecting​

If you need to reconnect (e.g., after permission changes):

  1. Go to Settings > Integrations > Slack
  2. Click Reconnect or Refresh
  3. Complete the OAuth flow again

Disconnecting​

To remove the Slack integration:

  1. Go to Settings > Integrations > Slack
  2. Click Disconnect
  3. Confirm the disconnection

After disconnecting:

  • Session sharing to Slack will stop working
  • Existing shared messages in Slack remain
  • You can reconnect at any time

Permissions​

The Recapt Slack app requests these permissions:

PermissionPurpose
channels:readList available channels for sharing
chat:writePost session links to channels
users:readMatch users for @mentions
users:read.emailMatch users by email address
team:readDisplay workspace information

Best Practices​

Create Dedicated Channels​

Consider creating dedicated Slack channels for different use cases:

  • #recapt-bugs - Sessions with console errors
  • #recapt-ux - Sessions showing UX issues
  • #recapt-support - Sessions linked to support tickets

Use Descriptive Messages​

When sharing sessions, include context:

Found the checkout bug! User got stuck on payment step
because the "Continue" button wasn't responding.
See 2:15 in the recording.

Mention Relevant Team Members​

Tag the right people when sharing:

  • Bug sessions → Engineering team
  • UX issues → Design team
  • Customer complaints → Support team

Troubleshooting​

"Unable to Connect" Error​

  1. Ensure you have permission to install apps in your Slack workspace
  2. Check if your organization has restrictions on app installations
  3. Try authorizing in a private/incognito browser window

Messages Not Posting​

  1. Verify the Slack integration is still connected
  2. Check that Recapt has been added to the target channel
  3. For private channels, invite the Recapt bot first

User Mentions Not Working​

  1. Ensure the mentioned user exists in both Recapt and Slack
  2. Verify email addresses match between systems
  3. Check that the user has joined your Recapt organization

Bot Not Appearing in Channels​

  1. Invite the Recapt bot to channels where you want to share
  2. In Slack, type /invite @Recapt in the channel
  3. The bot must be in a channel to post messages there

Privacy Considerations​

  • Session links shared to Slack are accessible to anyone with the link
  • Slack messages may be visible to your entire team
  • Consider your organization's data sharing policies
  • Use private channels for sensitive session discussions