> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fincelo.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack Setup

> Connect Fincelo to Slack for CSM alerts with interactive Block Kit messages.

## Setup Time: 30 minutes

***

## Step 1 — Create Slack App

1. Go to [api.slack.com/apps](https://api.slack.com/apps) → **Create New App → From scratch**
2. Name: `Fincelo CSM Hub`
3. Select your workspace → **Create App**

***

## Step 2 — Add Bot Scopes

1. Your app → **OAuth & Permissions → Bot Token Scopes → Add**:
   * `chat:write` — Post messages
   * `chat:write.public` — Post to public channels
   * `users:read` — Look up users for @mentions
   * `channels:read` — Access channel info

***

## Step 3 — Enable Interactivity (for button clicks)

1. **Interactivity & Shortcuts** → Toggle **ON**
2. Request URL: `https://app.fincelo.app/api/webhooks/slack`
3. Click **Save Changes**

***

## Step 4 — Install to Workspace

1. **Install App → Install to Workspace → Allow**
2. Copy **Bot User OAuth Token** (starts with `xoxb-`)

***

## Step 5 — Get Signing Secret

1. **Basic Information → Signing Secret → Show → Copy**

***

## Step 6 — Configure in Fincelo

1. Fincelo → **Settings → CSM Hub → Channel Config → Slack**
2. Paste **Bot Token** + **Default Channel** (e.g. `#cs-alerts`)
3. Save ✅

**Test:**

```bash theme={null}
curl -X POST "https://slack.com/api/chat.postMessage"   -H "Authorization: Bearer YOUR_BOT_TOKEN"   -H "Content-Type: application/json"   -d '{"channel": "#cs-alerts", "text": "✅ Fincelo CSM Hub connected"}'
```

***

## Getting CSM Slack User IDs (for @mentions)

1. In Slack → click CSM's profile → **"⋯" → Copy member ID**
2. Format: `U1234ABCD`
3. Add in Fincelo → **Settings → CSM Hub → CSM Roster → Slack User ID**