Alert System

How Alert Rules Work

Alert rules automatically notify your Discord channel when specific scoring events happen during live games. SportDataIQ monitors games in real-time (checking every 30 seconds) and sends beautiful embeds with player photos, team logos, and play descriptions.

Alert Markets (Types)

Alert markets determine what kind of scoring events trigger notifications. Different leagues support different markets:

Creating Alert Rules

Alert rules are created and managed through the web dashboard. Here's the complete process:

Step 1: Access the Dashboard

1. Visit sportdataiq.com/dashboard
2. Click "Login with Discord" and authorize
3. Select your server from the list (you must have "Manage Server" permission)
4. Click on Settings

Quick start: Templates

Not sure where to begin? Click Templates on the Alert Rules page and pick a pack — NFL Sunday, Fantasy football, MLB homers, NHL goals, NBA nights, My team (choose a league and team; adds a filtered pack for that team) or Daily reads (Edges + game-day digest + weekly standings). Choose the channel, click Add, and the rules are created for you. Each one is a normal rule afterwards: edit, filter, pause or delete it as usual.

Step 2: Create New Rule

1. Click the "New Alert Rule" button
2. Select a League from the dropdown:
   • NFLNFL (National Football League)
   • NCAAFNCAAF (College Football)
   • MLBMLB (Major League Baseball)
   • NBANBA (National Basketball Association)
   • WNBAWNBA (Women's National Basketball Association)
   • NHLNHL (National Hockey League)
3. Choose a Market Type:
   • First Scorer - Opening score of the game only
   • Anytime Scorer - Every scoring play (available for most leagues)
4. Select the Destination Channel:
   • Choose any text or announcement channel in your server
   • Click "Refresh" if you don't see a newly created channel
   • Make sure the bot has permission to send messages in that channel
5. Optionally, add Filters (see below) to limit the rule to certain teams or players
6. Choose a Ping role: the server default (set in Server settings), no ping, or a specific role for this rule
7. Optionally, enable the rule immediately (you can also enable it later)
8. Click "Create Rule"

Filters: teams and players

Every scoring rule has an optional Filters section (click "Add filters" in the rule form). A rule with no filters alerts on every qualifying play in the league. With filters, the play must match all of the lists you fill in:

• Teams — the scoring team must be one of these (up to 50). Use it for "only my team's games" or a division feed.
• Only these players — the scorer must be one of these (up to 50). Pick a team under Roster to load its current roster, then choose players. Great for a fantasy roster or one star shooter.
• Never these players — skip the alert when one of these scores, even if the other lists match.

• Leave a list empty to not restrict on it. Rosters come from the official league feeds and refresh every 6 hours; players who change teams keep matching by their player id.
• On First-scorer markets a player filter means "only if they score first" — you won't get a message when someone else opens the scoring.
• Active filters show as chips on the rule card, and "Send Test" respects them so you can preview exactly what will post.
• Filters are per rule. Members who just want their own players should use /follow instead — it needs no admin and posts to their DMs.

Step 3: Test Your Alert

Always test your alert before going live to ensure it appears correctly:

1. Find your newly created rule in the alerts list
2. Click the "Send Test" button
3. Check the configured Discord channel for the preview alert
4. The test alert will show:
   • "(Preview)" tag in the title
   • Sample player: "Sample Player"
   • Sample teams: "Sample City Stars" vs "Preview Opponents"
   • Preview message explaining it's a test

Managing Alert Rules

The dashboard provides complete control over your alert rules:

Example Alert Rules

Here are some popular alert rule configurations:

What Alerts Look Like

Every alert includes a beautiful Discord embed with:

• League emoji and name (e.g., "NFL - Anytime Touchdown")
• Player headshot (when the league feed has one)
• Team logo as the embed thumbnail
• Play description ("John Doe scores a touchdown for the Los Angeles Rams vs San Francisco 49ers")
• Current score with the scoring team highlighted
• Game state (quarter/period and clock time)
• Play-by-play details from the official feed (e.g., "15 yard pass from QB to WR")
• Timestamp of when the scoring occurred