# Mention alerts in Slack, Discord and email (https://snitchfeed.com/docs/notifications)

Notifications send new mentions to the places your team already looks. They are set **per [feed](/docs/feeds)**: each feed has its own channels, its own on/off switch and its own filters. One feed can ping Slack for strong matches while another sends a weekly email.

| Channel | When it arrives | Good for |
| --- | --- | --- |
| **Slack** | Right away | Team channels you already watch |
| **Discord** | Right away | Teams and communities on Discord |
| **Email** | Hourly, daily or weekly digest, up to 5 people | Reviewing in batches, or people outside Slack |
| **Webhooks** | Right away | Sending mentions to your own tools (Pro plan) |

You can turn on several channels for the same feed.

## Turn on alerts for a feed [#turn-on-alerts-for-a-feed]

New feeds send nothing until you set them up.

<Steps>
  <Step>
    Open a saved feed and click **Notifications** in the top bar. You can also open it from the **Notifications** column on the Feeds page.
  </Step>
  <Step>
    Pick a tab (**Slack**, **Discord**, **Email** or **Webhooks**) and add at least one destination. Each channel is explained below.
  </Step>
  <Step>
    Switch on **Enable notifications**. It stays off until a channel is set up.
  </Step>
  <Step>
    Click **Save changes**. Nothing is saved until you do.
  </Step>
</Steps>

A green check on a tab means that channel has a destination. If **Enable notifications** is off, the dialog shows a banner and nothing is sent.

<Callout type="info" title="Saved feeds only">
  The **Notifications** button only appears on saved feeds. To get alerts for a
  set of filters, save them as a feed first.
</Callout>

### Choose which mentions are sent [#choose-which-mentions-are-sent]

There is no separate alert setting. The filters saved on the feed are the rule: a mention is sent only if it passes every filter. To change what a feed sends, edit its filters and click **Update Feed**.

These filters control alerts: **Fit score**, **Include Listeners** and **Exclude Listeners**, **Platforms**, **Include Intents** and **Exclude Intents**, **Sentiment**, **Include Keywords** and **Exclude Keywords**, **Include Subreddits** and **Exclude Subreddits**, **Tracked Profiles** and **Languages**.

These only change what you see in the feed, not what is sent: **Sort**, **Seen vs New**, **Date Posted**, collections and the Engaged state.

The **Fit score** filter is the easiest way to control volume. [Fit Score](/docs/fit-score) is how well a mention matches what you are looking for.

| Level | Fit Score |
| --- | --- |
| **High** | 70% and above |
| **Medium** | 50% to 69% |
| **Low** | Below 50% (and mentions with no score) |

For example, to get Slack pings only for strong matches, set the feed's **Fit score** to **High**. A feed that SnitchFeed creates for a new listener starts with **Medium** and **High**.

Alerts only cover mentions that arrive after you save. They are not sent for older mentions.

## Slack [#slack]

Slack alerts post each new mention to one or more channels as soon as it is found.

<Steps>
  <Step>
    Open **Integrations → Slack** in the sidebar and click **Connect Slack**.
  </Step>
  <Step>
    Approve the permissions in Slack. The page then shows **Connected**.
  </Step>
  <Step>
    Open a feed's **Notifications**, go to the **Slack** tab and pick one or more channels.
  </Step>
  <Step>
    Switch on **Enable notifications** and click **Save changes**.
  </Step>
</Steps>

You connect Slack once for the whole workspace. Owners and collaborators can both connect or reconnect it.

To check that SnitchFeed can post to a channel, pick it under **Test a channel** on the Slack integration page. The test posts a sample alert, not a real mention.

To send mentions that are already in the feed, switch on **Send existing mentions** in the **Slack** tab, choose **Highest fit** or **Latest** and how many (50 by default, up to 100), then click **Save and send mentions**. They go to every selected channel, so a channel that already gets alerts from this feed may see some mentions twice. Notifications must be on for the feed.

Missing a private channel? Invite SnitchFeed to that channel in Slack, then click the refresh button in the channel picker. If it still does not appear, click **Reconnect** on the Slack integration page.

## Discord [#discord]

Discord alerts post each new mention to a channel as soon as it is found. You do not connect a workspace. You paste a Discord webhook URL (a link Discord gives you that lets apps post to a channel).

<Steps>
  <Step>
    In Discord, open the channel's settings (**Edit Channel**), then go to **Integrations → Webhooks**.
  </Step>
  <Step>
    Click **New Webhook**, give it a name and click **Copy Webhook URL**.
  </Step>
  <Step>
    In SnitchFeed, open a feed's **Notifications** and go to the **Discord** tab.
  </Step>
  <Step>
    Paste the URL and click **Add**. Click **Test** to post a sample alert if you like.
  </Step>
  <Step>
    Switch on **Enable notifications** and click **Save changes**.
  </Step>
</Steps>

To send mentions that are already in the feed, switch on **Send existing mentions** in the **Discord** tab, choose **Highest fit** or **Latest** and how many (50 by default, up to 100), then click **Save and send mentions**. They go to every valid webhook, and any webhook Discord no longer recognizes is skipped. A webhook that already gets alerts from this feed may see some mentions twice. Notifications must be on for the feed.

<video autoPlay loop muted className="rounded-lg">
  <source
    src="https://cms.parthkoshti.com/assets/ff58816f-d49e-47d0-add4-689e1f06c724.webm"
    type="video/webm"
  />
</video>

Add more than one URL to post to several Discord channels.

## Email [#email]

Email sends a digest: one message with the feed's new mentions, on a schedule you choose.

<Steps>
  <Step>
    Open a feed's **Notifications** and go to the **Email** tab.
  </Step>
  <Step>
    Under **To**, add up to **5** email addresses. Press Enter or comma after each one.
  </Step>
  <Step>
    Under **Send**, pick **Hourly** (on the hour or half hour), **Daily** (pick a time) or **Weekly** (pick a day and time).
  </Step>
  <Step>
    Switch on **Enable notifications** and click **Save changes**.
  </Step>
</Steps>

How digests work:

- A digest holds the mentions that pass the feed's filters and have not been emailed yet. If nothing is new, no email is sent.
- A mention is emailed once, even if several feeds match it.
- **Hourly** digests only go out during working hours, 9:00 to 17:00. The last one is at 16:00 or 16:30.

<Callout type="info" title="Which time zone is used">
  Digest times use the workspace owner's time zone, set under **Workspace
  Settings → Notifications** (UTC if none is set). The dialog shows your own
  browser's time zone, so if you and the owner are in different zones, set the
  time in the owner's zone.
</Callout>

Separate from feed digests, each person can turn on a **Daily digest** or **Weekly digest** summary of the workspace under **Workspace Settings → Notifications**. These are not tied to a feed.

## Webhooks [#webhooks]

Webhooks send each new mention to a web address you control, so your own tools can act on it. Add a destination on the **Webhooks** tab of a feed's notifications. See [Webhooks](/docs/integrations/webhooks) for setup.

## Next steps [#next-steps]

- [Feeds](/docs/feeds): build the filters that decide what gets sent.
- [Troubleshooting](/docs/troubleshooting#noisy-feed): cut down noisy alerts.
