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

# Notifications

> Configure how and where you receive alerts about inbox activity

## Overview

Stay informed about important inbox activity with customizable notifications delivered to Slack and email. Configure which events trigger notifications and where they're sent.

<Info>
  All notifications are configured in **Settings** → **Notifications**. Each notification type can
  be sent to one or more destinations (Slack channels, email addresses, or email groups).
</Info>

## Notification Types

<CardGroup cols={2}>
  <Card title="All New Messages" icon="inbox">
    Get notified for every message that comes into your inbox from any source.
  </Card>

  <Card title="New Direct Messages" icon="send">
    Receive alerts specifically for direct messages. Filter by follower count, verified accounts, or
    VIP contacts.
  </Card>

  <Card title="Held for Review" icon="shield">
    Get alerts when messages are flagged by moderation rules and require manual review.
  </Card>

  <Card title="Daily Activity Report" icon="file-text">
    Receive a daily summary of inbox activity every morning.
  </Card>
</CardGroup>

## Configuring Notifications

<Steps>
  <Step title="Navigate to Settings">
    Go to **Settings** → **Notifications** to access notification configuration.
  </Step>

  <Step title="Enable/Disable Notification Types">
    Toggle notifications on or off for each type. Disabled notifications won't be sent to any
    destination.
  </Step>

  <Step title="Select Destinations">
    For each enabled notification type, select one or more destinations. You can add multiple Slack
    channels, email addresses, or email groups per notification type.
  </Step>

  <Step title="Test Your Setup">
    Click **Send Test** next to each notification type to verify delivery. Tests send a sample notification to all configured destinations.
  </Step>
</Steps>

## Notification Destinations

Choose where to receive notifications:

<Tabs>
  <Tab title="Slack">
    **Send notifications to Slack channels**

    <Steps>
      <Step title="Connect Slack Workspace">
        Go to **Settings** → **Notifications** → **Connect Slack** to authorize Blueberry with your Slack workspace.
      </Step>

      <Step title="Select Channels">
        For each notification type, choose one or more Slack channels to receive alerts. You can add
        multiple channels per notification type.
      </Step>

      <Step title="Test Integration">
        Use the **Send Test** button to verify notifications are delivered correctly to all selected channels.
      </Step>
    </Steps>

    <Tip>
      Send different notification types to different channels. For example, send daily reports to
      \#analytics and urgent alerts to #support.
    </Tip>
  </Tab>

  <Tab title="Email">
    **Receive notifications via email**

    <Steps>
      <Step title="Add Email Address">
        Add individual email addresses or create email groups in **Settings** → **Notifications**.
      </Step>

      <Step title="Create Email Groups">
        Group multiple email addresses together (e.g., "Management Team", "Support Team") for easier
        routing.
      </Step>

      <Step title="Assign to Notification Types">
        Select which emails or email groups should receive each notification type.
      </Step>
    </Steps>

    <Note>
      Organization members with verified email addresses can be added directly without verification.
    </Note>
  </Tab>
</Tabs>

## Connecting Slack

<AccordionGroup>
  <Accordion title="Setup" icon="slack">
    <Steps>
      <Step title="Connect Slack">
        Click **Connect Slack** in **Settings** → **Notifications**.
      </Step>

      <Step title="Select Workspace">
        Choose your Slack workspace from the list.
      </Step>

      <Step title="Authorize">
        Authorize Blueberry to access your workspace.
      </Step>

      <Step title="Select Channel">
        Choose which Slack channel should receive notifications for each notification type.
      </Step>
    </Steps>

    <Tip>
      Once connected, all public channels and private channels where the bot is invited will be available for notification routing.
    </Tip>
  </Accordion>
</AccordionGroup>

## Email Groups

Email groups let you send notifications to multiple people at once.

<Steps>
  <Step title="Create Group">
    In **Settings** → **Notifications**, click **Create Email Group**.
  </Step>

  <Step title="Add Recipients">Add individual email addresses to the group.</Step>

  <Step title="Name Your Group">
    Choose a descriptive name like "Support Team" or "Management Alerts".
  </Step>

  <Step title="Assign to Notifications">
    Select the email group as a destination for any notification type.
  </Step>
</Steps>

## FAQ

<AccordionGroup>
  <Accordion title="Can I send notifications to multiple destinations?" icon="circle-question">
    Yes! Each notification type can be sent to multiple Slack channels, email addresses, and email groups simultaneously.
  </Accordion>

  <Accordion title="How do I stop receiving notifications temporarily?" icon="circle-question">
    Toggle off the notification type in **Settings** → **Notifications**. This disables all
    notifications of that type without removing your destination configuration.
  </Accordion>

  <Accordion title="Can I customize the notification message format?" icon="circle-question">
    Not currently. Notification messages follow a standard format that includes the message content,
    author information, and relevant context (post, campaign, etc.).
  </Accordion>

  <Accordion title="Are notifications sent immediately?" icon="circle-question">
    Yes, except for Daily Activity Reports which are sent every morning. All other notifications are
    sent in real-time as events occur.
  </Accordion>

  <Accordion title="Can I filter which DM notifications I receive?" icon="circle-question">
    Yes! For "New Direct Messages", click **Adjust Filters** to set filtering criteria:

    * **Verified Accounts Only** - Only notify for DMs from verified accounts
    * **Follower Count Threshold** - Only notify for accounts with X+ followers
    * **VIP Contacts Only** - Only notify for contacts in VIP segments

    Filters use OR logic. If you enable "Verified Accounts" and "1,000+ followers", you'll be notified for DMs from accounts that are *either* verified *or* have 1,000+ followers.
  </Accordion>
</AccordionGroup>

## Related Pages

<CardGroup cols={2}>
  <Card title="DM Inbox" icon="envelope" href="/inbox/dms">
    Manage direct messages that trigger notifications.
  </Card>

  <Card title="Comments Inbox" icon="comments" href="/inbox/comments">
    View and respond to comments that can trigger notifications.
  </Card>

  <Card title="Rules Engine" icon="gears" href="/comments/rules-engine">
    Create rules that hold messages for review.
  </Card>
</CardGroup>