Setup Guide

Step 1: Add Bot to Discord Server

Invite SportDataIQ to your Discord server to start accessing live sports data.

1. Visit sportdataiq.com
2. Click the "Add to Discord" button
3. Select your Discord server from the dropdown
4. Authorize the required permissions (View Channels, Send Messages, Embed Links, Attach Files, Use Slash Commands, Mention All Roles)
5. Complete the verification if prompted by Discord

Step 2: Use the Bot in Discord

Once the bot is added, it's immediately ready to use! Try the interactive command:

Fastest: Set up with AI

Say what you want in plain English and get a ready-made plan of channels and alert rules. Free for every server.

1. In the dashboard, open your server's Alerts page and choose ✦ Set up with AI (or run /setup in Discord; Manage Server only).
2. Describe it, e.g. “NHL goals and final scores for the Bruins, and a game thread for every NFL game”.
3. Check the plan: switch items off, rename or move channels, or ask for a change (“also add NBA first basket”).
4. Confirm. You get a line per channel and rule saying what was created; if anything fails, fix it and press Try again: only what's left is done.

Step 3: Configure Real-Time Alerts (Optional)

Set up automatic notifications for when players score touchdowns, goals, home runs, and baskets.

Accessing the Dashboard

1. Visit sportdataiq.com/dashboard
2. Click "Login with Discord" and authorize access
3. Navigate to the Settings tab at the top
4. Scroll down to the "Your Servers" section
5. Click on the server where the SportDataIQ bot is installed

Creating Alert Rules

1. Navigate to the Settings tab in the header
2. Click the "New Alert Rule" button
3. Select a League: NFL, NCAAF, MLB, NBA, WNBA, or NHL
4. Choose a Market Type:
   • First Scorer - First touchdown/goal/home run/basket of the game
   • Anytime Scorer - Every touchdown/goal/home run/3-pointer throughout the game
5. Select the Destination Channel where alerts will be posted
6. Optionally click Add filters to limit the rule to specific teams or players (see the alerts guide)
7. Click "Create Rule" to save

Personal alerts without the dashboard

Any member can run /follow player or /follow team in Discord to get a private DM every time that player or team scores — no rule, no admin permission. See the /follow reference.

Testing Your Alert

Before going live, test your alert to see exactly how it will look:

• Find your newly created rule in the alerts list
• Click the "Send Test" button
• Check the configured channel in Discord for a preview alert
• The test alert will be marked with "(Preview)" and show sample data

Learn more about alert configuration options in the Alert Rules Guide.

Required Bot Permissions

SportDataIQ needs these Discord permissions to function properly:

• View Channels - See available channels in your server
• Send Messages - Post scores, standings, leaderboards, and alerts
• Embed Links - Display rich embeds with player photos and team logos
• Attach Files - Include images in messages
• Use Slash Commands - Enable the /sportdataiq and /follow commands
• Mention @everyone, @here and All Roles - Ping the role you choose in Server settings, even if that role isn't marked mentionable (optional — only needed for alert pings)