Slack Connections
Slack connections enable agents to send notifications and alerts to your Slack workspace.
Recommended: Create and manage connections via the web UI at https://ui.{deployment}.firetiger.com/settings/connections
Installation
- Navigate to Settings > Connections in the Firetiger UI
- Click New Connection
- Select Slack as the connection type
- Click Connect Slack Workspace
- In the popup, select your Slack workspace and click Allow
The connection will be created automatically with your workspace details.
What Gets Created
When you install the Slack app, Firetiger automatically creates a connection with:
| Field | Value |
|---|---|
connection_id |
slack-{workspace_id} (e.g., slack-t1234567890) |
display_name |
Your Slack workspace name |
description |
Slack workspace: {workspace_name} |
Permissions
The Firetiger Slack app requests the following permissions:
| Scope | Purpose |
|---|---|
channels:read |
List available channels |
channels:join |
Join public channels to send messages |
chat:write |
Send messages to channels |
chat:write.public |
Send messages to public channels without joining |
team:read |
Get workspace information |
users:read |
List users for mentions |
Re-authorization
To update permissions or reconnect a workspace:
- Navigate to Settings > Connections
- Find your Slack connection
- Click Reconnect or delete and recreate the connection
Slack scopes are additive - re-authorizing adds new permissions without removing existing ones.
Tools
Slack connections enable the following agent tools:
| Tool | Description |
|---|---|
slack-send-message |
Send messages to one or more Slack channels |
slack-send-message
Send notifications to Slack channels. Supports Slack’s mrkdwn format for rich text.
Parameters:
| Parameter | Required | Description |
|---|---|---|
connection |
Yes | The Slack connection to use |
channels |
Yes | List of channel names or IDs (e.g., ["#alerts", "C1234567890"]) |
message |
Yes | Message content (use Slack mrkdwn: *bold*, _italic_, `code`) |
title |
No | Optional title displayed as a bold header |
investigation_url |
No | Optional URL to link back to an investigation |
Description Field
The description field helps agents understand when to use this Slack workspace.
Example:
Primary workspace for engineering alerts.
Use for:
- Incident notifications → #incidents
- Deployment updates → #deployments
- Agent status updates → #firetiger-alerts
Best Practices
- Use descriptive workspace names - Helps agents select the right workspace when multiple are connected
- Document channel conventions - Include which channels to use for different alert types
- Limit to necessary workspaces - Only connect workspaces that agents need to notify