SlateoAPI Reference

Notification Preferences

Configure how and when you receive notifications from Slateo to stay informed without being overwhelmed.

Overview

Slateo keeps you updated on important events like query completions, comments, mentions, and data updates. You can customize which notifications you receive and through which channels.

Notifications are available through:

  • In-app: Always visible in your Slateo workspace
  • Slack: Real-time alerts in your connected Slack workspace
  • Email: Digest summaries of important updates

Access notification settings by clicking your profile picture in the navigation bar and selecting Notifications.

Notification channels

In-app notifications

In-app notifications appear in the Slateo interface and are always enabled. You'll see notifications for:

  • Query execution completions
  • Comments and mentions
  • Data refresh updates
  • Integration activity
  • System announcements

Access your notification inbox by clicking the bell icon in the top navigation bar. Unread notifications are indicated with a badge count.

Slack notifications

If your organization has connected Slack, you can receive real-time notifications in Slack channels or direct messages. Slack notifications are sent immediately when events occur.

Email notifications

Email notifications provide digest summaries of activity. Emails are sent based on urgency and your configured preferences to avoid inbox overload.

Slack notifications

Slack integration provides real-time alerts and enables your team to interact with Slateo directly from Slack.

Prerequisites

Before you can receive Slack notifications, your organization administrator must:

  1. Connect Slack to your Slateo workspace
  2. Configure the default notification channel
  3. Authorize the required permissions

See the Slack Integration guide for setup instructions.

Enable Slack notifications

Once Slack is connected at the organization level, you can configure your personal Slack notification preferences:

  1. Click your profile picture and select Notifications
  2. Navigate to the Slack section
  3. Toggle on Enable Slack notifications
  4. Choose which types of events should trigger Slack notifications:
    • Query completions
    • Comments and mentions
    • Data updates
    • Error alerts

Notification delivery

Slack notifications can be delivered to:

  • Direct messages: Personal notifications sent directly to you
  • Channels: Shared notifications in configured channels
  • Threads: Contextual updates in existing conversation threads

Interact with Slateo in Slack

Mention @slateo in any Slack channel to:

  • Ask questions about your data
  • Execute queries
  • Get help with SQL syntax
  • Request reports and visualizations
@slateo What were our top 10 customers by revenue last month?

The Slateo bot will respond with results, visualizations, or follow-up questions.

Manage Slack connection

To disconnect Slack notifications:

  1. Navigate to Settings > Integrations
  2. Find the Slack integration
  3. Click Disconnect (requires administrator permissions)

Disconnecting Slack at the organization level will disable notifications for all users. Personal notification preferences only control which events trigger notifications, not the connection itself.

Email notifications

Email notifications provide summaries of activity without overwhelming your inbox. Configure when and how often you receive email digests.

Configure email preferences

  1. Click your profile picture and select Notifications
  2. Navigate to the Email section
  3. Toggle on Enable email notifications
  4. Choose your digest frequency:
    • Real-time: Immediate emails for urgent events
    • Hourly: Digest every hour with activity summary
    • Daily: Once-daily summary at your preferred time
    • Weekly: Weekly roundup of activity

Email notification types

Query activity:

  • Query execution completions
  • Query failures and errors
  • Long-running query alerts

Collaboration:

  • Comments on your queries
  • @mentions in comments or descriptions
  • New collaborators added to your queries

Data updates:

  • Scheduled refresh completions
  • Data quality alerts
  • Schema change notifications

System notifications:

  • Product updates and new features
  • Maintenance windows
  • Security alerts

Quiet hours

Configure quiet hours to prevent non-urgent notifications during off-hours:

  1. Navigate to Email notification settings
  2. Enable Quiet hours
  3. Set your preferred quiet hours (e.g., 6 PM - 8 AM)
  4. Choose your timezone

During quiet hours, only urgent notifications (errors, security alerts) will be sent immediately. Other notifications will be queued and sent in the next digest after quiet hours end.

Unsubscribe from emails

To stop receiving email notifications:

  1. Click the Unsubscribe link at the bottom of any notification email
  2. Or disable email notifications in your Notifications settings

You will continue to receive critical security and account-related emails even if you unsubscribe from activity notifications.

In-app notifications

In-app notifications are always enabled and appear in your Slateo workspace. Manage how they're displayed and organized.

Notification inbox

Access your notification inbox by clicking the bell icon in the top navigation. The inbox shows:

  • Unread count badge
  • Chronological list of notifications
  • Filtering by notification type
  • Mark as read/unread actions

Notification types

In-app notifications include:

Query activity:

  • Execution completions with result previews
  • Errors and warnings
  • Performance insights

Collaboration:

  • Comments and replies
  • @mentions
  • Share invitations

Data updates:

  • Refresh completions
  • Schema changes
  • Data quality alerts

System:

  • Product announcements
  • Feature releases
  • Maintenance notifications

Manage notifications

Mark as read:

  • Click any notification to mark it as read
  • Click Mark all as read to clear the entire inbox

Filter notifications:

  • Use the filter dropdown to show specific types
  • Search notifications by keyword
  • Filter by date range

Notification retention: Slateo retains up to 500 notifications in your inbox. Older notifications are automatically archived but remain accessible in your activity history.

Notification timing

Different notification channels have different delivery timing to balance immediacy with avoiding notification fatigue.

Real-time channels

Slack and in-app notifications are sent immediately when events occur. This includes:

  • Query completions
  • Comments and mentions
  • Error alerts
  • System notifications

Email digests

Email notifications use intelligent batching to reduce inbox clutter:

Immediate (< 1 minute):

  • Query failures and errors
  • Security alerts
  • @mentions in urgent contexts

Batched (hourly):

  • Query completions
  • Comments and replies
  • Data refresh updates

Daily digest:

  • Activity summaries
  • Weekly metrics
  • Product updates

You can customize email timing in your notification preferences.

Subscribing to queries

Control which queries and datasets trigger notifications by managing your subscriptions.

Automatic subscriptions

You're automatically subscribed to queries when you:

  • Create a new query
  • Are assigned as a collaborator
  • Are @mentioned in a comment or description
  • Manually subscribe using the subscribe button

Manual subscriptions

To subscribe to a query:

  1. Open the query in Slateo
  2. Click the Subscribe button in the top toolbar
  3. Choose notification preferences for this query:
    • All activity
    • Comments only
    • Execution results only
    • Errors only

To unsubscribe:

  1. Open the query
  2. Click the Unsubscribe button
  3. Confirm the action

View subscriptions

See all your subscribed queries:

  1. Navigate to My Queries in the sidebar
  2. Select the Subscribed filter
  3. View and manage all subscriptions

Subscription preferences

Configure default subscription behavior:

  1. Navigate to Notifications settings
  2. Go to Subscription preferences
  3. Choose default settings:
    • Auto-subscribe to queries you create
    • Auto-subscribe to queries you're mentioned in
    • Auto-subscribe to queries you comment on

FAQ

Why am I not receiving Slack notifications?

If Slack notifications are enabled but you're not receiving them:

  1. Verify Slack is connected at the organization level in Settings > Integrations
  2. Check your personal notification preferences are enabled
  3. Confirm the Slateo app is installed in your Slack workspace
  4. Verify you haven't muted the Slateo bot in Slack
  5. Check that the notification channel exists and you're a member

If issues persist, contact your organization administrator or Slateo support.

Can I receive notifications for specific queries only?

Yes. Use query subscriptions to control exactly which queries trigger notifications. Unsubscribe from queries you don't want to follow, and manually subscribe to important ones.

You can also use filters in your notification inbox to focus on specific types of activity.

How do I reduce notification noise?

To reduce notification volume:

  1. Adjust your email digest frequency to daily or weekly
  2. Enable quiet hours to batch non-urgent notifications
  3. Unsubscribe from queries you no longer need to follow
  4. Disable notification types you don't find useful
  5. Use notification filters to focus on what matters

Do notifications work with multiple organizations?

Yes. If you're a member of multiple Slateo organizations, notification preferences are configured separately for each organization. Switch between organizations to manage their respective notification settings.

Can I get notifications for data quality issues?

Yes. Enable data quality notifications in your notification preferences. You'll receive alerts when:

  • Data freshness falls behind schedule
  • Schema changes are detected
  • Row counts change unexpectedly
  • Query results differ significantly from historical patterns

Configure data quality monitoring in Settings > Databases for your connected data warehouses.

What happens to notifications when I'm on vacation?

Notifications accumulate in your inbox while you're away. Consider:

  1. Setting an out-of-office auto-responder in email
  2. Unsubscribing from non-critical queries temporarily
  3. Delegating query ownership to team members
  4. Enabling "Mark all as read" when you return

Slateo retains up to 500 notifications, so you won't lose important updates.

Can I customize notification sounds?

In-app notification sounds are controlled by your browser settings. Slack notification sounds are configured in your Slack preferences. Email notifications don't have sound settings.

How do I report notification bugs?

If you experience issues with notifications:

  1. Check your notification preferences are configured correctly
  2. Verify integration connections are active
  3. Contact support with details:
    • Which notification channel is affected
    • Expected vs. actual behavior
    • Screenshots if applicable
    • Approximate time the issue occurred

Our support team will investigate and resolve the issue.

Was this page helpful?

Was this page helpful?