Slack Integration

Connect MetricChat to your Slack workspace to ask data questions directly from Slack. Users interact through DMs or public channel mentions.

Key Features

• Direct messaging — Chat with the bot in 1:1 DMs
• Channel mentions — @mention the bot in public channels
• Threaded conversations — Each thread maps to a single report
• Status indicators — Shows processing and completion states
• Secure user mapping — Slack accounts link to MetricChat accounts
• Natural language queries — Ask questions in plain English
• Automatic report creation — Every conversation generates a report
• Context-aware access — Channels use public data only; DMs access public and private sources
• Rich responses — Text, images, and file attachments

Setup

Prerequisites

• Admin access to MetricChat
• Slack workspace admin rights

Step 1: Create a Slack App

Go to the Slack API dashboard and create a new app.

Step 2: Configure OAuth Scopes

Add these Bot Token scopes:

• app_mentions:read
• chat:write
• files:read
• files:write
• im:history
• reactions:read
• reactions:write
• users:read

And these additional scopes:

• im:read
• im:write
• channels:history
• groups:history

Step 3: Install to Workspace

Install the app and copy the Bot Token.

Step 4: Enable Event Subscriptions

Enable events and set the webhook URL:

https://YOUR_DOMAIN/api/settings/integrations/slack/webhook

Subscribe to events:

• message.im
• app_mention

Step 5: Get Signing Secret

Copy the Signing Secret from the Basic Information page.

Step 6: Connect in MetricChat

Navigate to Settings > Integrations, enter the Bot Token and Signing Secret, and click Connect.

Usage

Account Verification

Each user must verify once:

1. Send any message to the bot in a DM
2. Receive a verification link
3. Click the link to authenticate with your MetricChat account

Asking Questions

In DMs: Send a question → bot processes → response appears in thread → continue in thread

In Channels: @mention the bot with a question → response appears in thread → continue discussion

Important: Channel mentions restrict data access to public sources only. Use DMs to access private data sources.