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
- Go to Settings in the left sidebar
- Click on Integrations
- Find the Slack card under “Alert Integrations”
Step 2: Authorize Avina
- Click Connect on the Slack integration card
- You’ll be redirected to Slack’s authorization page
- Select the Slack workspace you want to connect
- Click Allow to grant Avina the necessary permissions
Avina requests permissions to create channels, send messages, and invite users. These permissions are required to deliver signal notifications to your team.
Step 3: Create Your Alerts Channel
After authorizing Slack, you’ll be prompted to create a channel for receiving alerts:- Enter a name for your alerts channel (default:
avina-alerts) - Click Add Slack Channel
- Avina will automatically:
- Create the channel in your Slack workspace
- Add the Avina bot to the channel
- Invite you to the channel
Once complete, you’ll see a “Connected to Slack” confirmation message.
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:- Go to Settings → Integrations
- Click on the Slack integration card
- 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:- Navigate to Signals and select a signal
- Click the bell icon (🔔) in the header next to the options menu
- Enter the Slack channel name where you want this signal’s alerts to be sent
- Click Save
Adding Avina to Existing Channels
If you want to send notifications to an existing Slack channel:Option 1: Add Avina to Slack Channel
- Open the channel in Slack
- Click the channel name to open channel details
- Go to the Integrations tab
- Click Add apps
- Search for “Avina” and add it to the channel
Option 2: Use the /invite command
- Open the channel in Slack
- Type
/invite @Avinaand press Enter
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
- Verify the channel exists — Make sure the channel name is spelled correctly
- Check bot membership — Ensure Avina is added to the channel
- Confirm signal is active — Only active signals send notifications
Re-authorizing Slack
If you need to reconnect Slack:- Go to Settings → Integrations
- Click Disconnect on the Slack card (if available)
- 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
Organize by Signal Type
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)
Use Descriptive Names
Name channels clearly so team members know what alerts to expect
Limit Channel Members
Only invite team members who need to see specific signals
Set Up Slack Notifications
Configure Slack notification preferences to avoid alert fatigue. You can do this in the Avina dashboard (Settings → Notifications)