Discord Bot

The Parsertime Discord bot brings your team's scrim data and availability workflows into Discord. It is free for all users, regardless of subscription tier. Use it to pull up player profiles, compare stats, surface team winrates, post weekly availability reminders, and announce new scrims without anyone leaving the server.

Adding the Bot to Your Server

The bot is added to a Discord server through an OAuth invite link generated by Parsertime. To keep the configuration in sync with your team, you should always start the invite flow from within Parsertime rather than crafting the link by hand.

Sign in to parsertime.app as a team owner or manager.
Open Team Settings and select the Integrations tab.
Click the option to add the Discord bot. You will be redirected to Discord's authorization screen.
Choose the Discord server you want the bot to join and approve the permissions.

The bot requests a small set of Discord permissions:

Send Messages: to post notifications and reply to slash commands.
Embed Links: to render the rich embeds used for profiles, leaderboards, and reminders.

You need to have the Manage Server permission in Discord to add the bot. If the invite screen does not list the server you want, ask a server admin to grant you that permission or have them complete the invite flow.

Connecting Your Team

Once the bot is in your Discord server, you need to tell Parsertime which channel to post to.

Go back to Team Settings → Integrations on Parsertime.
Select the Discord server you just authorized.
Pick the channel where the bot should send notifications.
Optionally, choose a role to mention when availability reminders are posted.
Configure the availability reminder schedule (day of week and time) if you want the bot to post the reminder automatically each week.
Save your changes.

The bot will use this configuration for every proactive notification it sends for your team. If you ever want to stop notifications, clear the channel selection or remove the bot from your Discord server.

Linking Your Discord Account

Some slash commands operate on your Parsertime account rather than public data. To use those, you need to link your Discord account to Parsertime.

Sign in to parsertime.app.
Navigate to Settings → Linked Accounts.
Click Link Discord and complete the OAuth flow.

After linking, commands like /teams will be able to identify you and return data scoped to your account.

Linking your Discord account is only required for personal commands such as /teams. Public commands like /profile, /leaderboard, /compare, and /team work for anyone in the server.

Slash Commands

Command	Description	Options
`/profile`	View a player profile with aggregated stats and trends	`player` (required): in-game player name
`/leaderboard`	View top players ranked by hero average stats	`hero` (required); `limit` (optional, default 10)
`/compare`	Side-by-side comparison of two players' stats	`player1`, `player2` (both required)
`/team`	View team winrates overall and by map	`team_id` (required)
`/teams`	List your Parsertime teams and their IDs	None. Requires a linked Discord account.
`/availability setup`	Get a private link to your team's availability settings	`team_id` (required)
`/availability trigger`	Post the weekly availability reminder immediately	`team_id` (required). Admin-only.
`/help`	List all commands and their usage	None

`/profile`

Look up a single player by their in-game name. The embed shows aggregated stats and recent trends across the scrims tracked on Parsertime.

/profile player: Lucas

`/leaderboard`

Rank players by their average stats on a specific hero. Use the limit option if you only want the top few entries; the default is 10.

/leaderboard hero: Tracer limit: 5

`/compare`

Render two players side-by-side for a quick head-to-head view.

/compare player1: Lucas player2: Alex

`/team`

Show a team's overall winrate along with a per-map breakdown. You can find your team's ID with /teams or on the team page on Parsertime.

/team team_id: 123

`/teams`

List every Parsertime team you belong to along with the team IDs you need to pass to other commands. This command requires a linked Discord account. If your account is not linked yet, the bot will respond with "Team not linked yet" and a pointer to the settings page.

/teams

`/availability setup`

Get a private, ephemeral link to your team's availability settings page on Parsertime. Only the user who ran the command can see the reply.

/availability setup team_id: 123

`/availability trigger`

Post this week's availability reminder to the configured channel immediately, without waiting for the scheduled time. This is useful if you need to re-send a reminder after a missed week or a timezone change. It is restricted to team owners and managers.

/availability trigger team_id: 123

`/help`

List every command the bot supports along with its options.

/help

Notifications

In addition to responding to slash commands, the bot posts proactive notifications to the channel you configured on the Integrations page.

Scrim Created

Whenever a new scrim is created for a team linked to Discord, the bot posts an embed titled New Scrim Created with the scrim name and the user who created it. This gives your roster a real-time heads-up that logs are available to review.

Availability Reminder

On the weekly schedule you configured, the bot posts an embed with your team name, the date range for the upcoming week (Monday through Saturday), and a link to the availability form. If you set a role to mention, that role is pinged alongside the embed so the right players see it.

You can also fire this reminder on demand with /availability trigger, the content is identical to the scheduled post.

Availability Reminders

Availability reminders are designed to drop a single, consistent prompt into your server every week so players know when and where to mark their availability.

Schedule: Set the day of week and time of day on Team Settings → Integrations. The reminder is sent in that slot every week until you change the schedule or remove the bot.
Role mention: If you set a role on the integration, the bot pings that role with the reminder so the right players get a notification.
Week window: The embed covers the upcoming Monday through Saturday so the current week's scrims are always in scope.
Manual trigger: Owners and managers can run /availability trigger to post the reminder immediately. This is useful after changing the schedule, recovering from a Discord outage, or nudging the team mid-week.
How it fires: The bot polls Parsertime every 60 seconds for pending reminders, so scheduled reminders may land up to a minute after their configured time.

When players click the link in the reminder, they are taken to the availability form for your team and can submit their availability for each day of the week.

Troubleshooting

"Team not linked yet": You ran /teams without linking your Discord account to Parsertime. Link it at parsertime.app/settings under Linked Accounts and try again.
Missing channel permissions: The bot does not have Send Messages in the configured channel. Notifications will silently fail. Double-check the channel's permission overrides in Discord.
Team not found: The team_id you passed does not match a team the bot can see. Run /teams to list the correct IDs.
No data found: The player name you passed to /profile, /compare, or /leaderboard has no tracked scrims on Parsertime yet.
"Something went wrong": The bot hit an interaction timeout waiting for the API (over 3 seconds). This is usually transient, retry the command in a moment. If it persists, reach out on Discord or email help@parsertime.app.

On this page