Skip to content
JamBot

Admin Guide

As a designated approver, you’ll receive Direct Messages from JamBot to review and approve song selections before playlists are created.

Workflow Overview

  1. Jam leader posts setlist → JamBot detects and parses
  2. JamBot searches Spotify → Finds song matches
  3. Approvers receive DMs → Review and select songs
  4. Final approval → Playlist created and posted

Song Match Types

Pre-Approved Songs (✅)

Songs previously approved and stored in the database:

1. Will the Circle Be Unbroken
✅ Stored Version (Pre-approved)


Track: Will the Circle Be Unbroken
Artist: The Nitty Gritty Dirt Band
Album: Will the Circle Be Unbroken

Action: React with ✅ or provide a different Spotify link

Single Match (✅)

When JamBot finds exactly one match:

2. Blue Moon of Kentucky
✅ 1 match found - React to approve


Track: Blue Moon of Kentucky
Artist: Bill Monroe

Action: React with ✅ to approve or reply with a different link

Multiple Matches (1️⃣ 2️⃣ 3️⃣)

When JamBot finds multiple options:

3. Man of Constant Sorrow
🎵 3 matches found - React to select


1️⃣ Option 1 - Stanley Brothers
2️⃣ Option 2 - Soggy Bottom Boys
3️⃣ Option 3 - Norman Blake

Action: React with 1️⃣, 2️⃣, or 3️⃣ to select your preferred version

No Match Found (❌)

When JamBot can’t find the song:

4. Some Obscure Traditional Song
❌ No matches found
Reply with Spotify track link to add manually.

Action: Search Spotify manually and reply with the track link

Reply to the DM with a Spotify track link:

https://open.spotify.com/track/6rqhFgbbKwnb9MLmUQDhG6

JamBot will validate the link and confirm the selection.

Final Approval

After reviewing all songs:

✅ Review complete! React with ✅ to create the playlist or ❌ to cancel.
  • React with ✅ to create the Spotify playlist
  • React with ❌ to cancel

After Playlist Creation

JamBot will:

  1. Create playlist named “Bluegrass Jam [DATE]”
  2. Add all approved tracks in setlist order
  3. Post the playlist link to Discord
  4. Store song versions for future jams
  5. Send you a confirmation DM

Manual Song Management

Override a Song

Use this command in any channel:

@jambot use this version of Will the Circle Be Unbroken for 11/18/2024 https://open.spotify.com/track/TRACK_ID
  1. Open Spotify
  2. Find the song
  3. Click ••• → Share → Copy Song Link

Best Practices

Song Selection

  1. Consistency: Use the same version across jams when possible
  2. Quality: Choose official releases over covers when available
  3. Availability: Ensure tracks are available in your region

Efficiency Tips

  • Enable Discord notifications for JamBot DMs
  • Keep Spotify open to preview tracks quickly
  • Most songs will use stored versions after the first jam

Troubleshooting

Not Receiving DMs

  • Verify your User ID is in the bot’s configuration
  • Check Discord privacy settings: Allow DMs from server members
  • Ensure you share a server with JamBot

Reactions Not Working

  • React to the correct message
  • Wait a moment after the message appears
  • Remove and re-add your reaction

Playlist Not Created

  • Check your DM for error messages
  • Verify Spotify credentials are valid
  • Check bot logs for API errors

Example Workflow

  1. Jam leader posts:

    Here's the setlist for the 7pm jam on November 18, 2024.
    

    1. Will the Circle Be Unbroken (G)
    2. Blue Moon of Kentucky (F)
    3. Man of Constant Sorrow (A)

  2. You receive 3 DMs with song options

  3. You react:

    • ✅ for stored/single matches
    • 2️⃣ for your preferred version of multiple matches

  4. Final approval: React ✅ to summary message

  5. Playlist created and posted to Discord!