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

# Slack Integration

> Connect Slack to receive real-time signal alerts and notifications from Avina

## Overview

The Slack integration allows you to receive signal alerts directly in your Slack workspace. When signals are triggered, Avina will automatically send notifications to your configured Slack channels.

## Connecting Slack to Avina

### Step 1: Navigate to Integrations

1. Go to **Settings** in the left sidebar
2. Click on **Integrations**
3. Find the **Slack** card under "Alert Integrations"

### Step 2: Authorize Avina

1. Click **Connect** on the Slack integration card
2. You'll be redirected to Slack's authorization page
3. Select the Slack workspace you want to connect
4. Click **Allow** to grant Avina the necessary permissions

<Info>
  Avina requests permissions to create channels, send messages, and invite users. These permissions are required to deliver signal notifications to your team.
</Info>

### Step 3: Create Your Alerts Channel

After authorizing Slack, you'll be prompted to create a channel for receiving alerts:

1. Enter a name for your alerts channel (default: `avina-alerts`)
2. Click **Add Slack Channel**
3. Avina will automatically:
   * Create the channel in your Slack workspace
   * Add the Avina bot to the channel
   * Invite you to the channel

<Check>
  Once complete, you'll see a "Connected to Slack" confirmation message.
</Check>

## Configuring Signal Notifications

### Default Workspace Channel

By default, all signal alerts are sent to the channel you created during setup. You can change this default channel at any time:

1. Go to **Settings** → **Integrations**
2. Click on the Slack integration card
3. Update the **Alert Channel** field with your preferred channel name

### Per-Signal Channel Configuration

You can configure individual signals to send notifications to different Slack channels:

1. Navigate to **Signals** and select a signal
2. Click the **bell icon** (🔔) in the header next to the options menu
3. Enter the Slack channel name where you want this signal's alerts to be sent
4. Click **Save**

<Warning>
  Make sure the channel exists in your Slack workspace and the Avina app is installed in the channel before configuring it.
</Warning>

## Adding Avina to Existing Channels

If you want to send notifications to an existing Slack channel:

### Option 1: Add Avina to Slack Channel

1. Open the channel in Slack
2. Click the channel name to open channel details
3. Go to the **Integrations** tab
4. Click **Add apps**
5. Search for "Avina" and add it to the channel

### Option 2: Use the /invite command

1. Open the channel in Slack
2. Type `/invite @Avina` and press Enter

<Tip>
  After adding Avina to a channel, you can configure your signals to use that channel for notifications.
</Tip>

## Notification Format

When a signal is triggered, Avina sends a notification that includes:

* **Signal name:** The name of the triggered signal
* **Company information:** Name, domain, and logo of the relevant company
* **Signal details:** Description of what triggered the signal
* **Timestamp:** When the signal was detected
* **Quick actions:** Links to view more details in Avina

## Troubleshooting

### Notifications not appearing

1. **Verify the channel exists:** Make sure the channel name is spelled correctly
2. **Check bot membership:** Ensure Avina is added to the channel
3. **Confirm signal is active:** Only active signals send notifications

### Re-authorizing Slack

If you need to reconnect Slack:

1. Go to **Settings** → **Integrations**
2. Click **Disconnect** on the Slack card (if available)
3. Click **Connect** to start the authorization flow again

## Required Permissions

Avina requests the following Slack permissions:

| Permission         | Purpose                        |
| ------------------ | ------------------------------ |
| `channels:manage`  | Create new channels for alerts |
| `channels:join`    | Join channels to send messages |
| `chat:write`       | Send signal notifications      |
| `users:read`       | Look up users for invitations  |
| `users:read.email` | Match users by email address   |

## Best Practices

<CardGroup cols={2}>
  <Card title="Organize by Signal Type" icon="folder">
    Create separate channels for signal categories if your process for handling those signals is differentiated by signal type. (ex. #avina-web-visits, #avina-new-hires)
  </Card>

  <Card title="Use Descriptive Names" icon="tag">
    Name channels clearly so team members know what alerts to expect
  </Card>

  <Card title="Limit Channel Members" icon="users">
    Only invite team members who need to see specific signals
  </Card>

  <Card title="Set Up Slack Notifications" icon="bell">
    Configure Slack notification preferences to avoid alert fatigue. You can do this in the Avina dashboard (Settings → Notifications)
  </Card>
</CardGroup>