🔔 SL-DJ Webhooks & Now Playing Embeds
SL-DJ offers flexible integration options using webhooks and embed code so your station can interact with external services like Discord or your website.
🌐 What Are Webhooks?
A webhook allows SL-DJ to automatically send real-time data (like “Now Playing” or “Song Change”) to another service or app. This is useful for automation, notifications, and updates.
📨 Example Use Cases
- Post “Now Playing” updates to a Discord channel.
- Trigger an alert when a specific track or DJ goes live.
- Integrate with custom bots, Zapier, or other automation tools.
🎮 How to Set Up a Discord Webhook
- Open your Discord server and go to Settings → Integrations → Webhooks.
- Click New Webhook, give it a name (e.g., SL-DJ Updates), choose a channel, and copy the Webhook URL.
- Now in SL-DJ:
- Go to your station → Web Hooks
- Click Add Web Hook
- Choose Generic Web Hook
- Paste your Discord Webhook URL into the field.
- Scroll to Triggers and select:
- Song Changed
- Live DJ Connected (optional)
- Customize the payload (or leave default) and save.
🎉 Now, every time the song changes, a message will be sent to your Discord channel!
💻 Using Embed Code on Your Website
SL-DJ provides HTML code that you can copy and paste directly into your website to show “Now Playing” or full player widgets.
Steps:
- In your station dashboard, go to Embed Widgets.
- Choose:
- Now Playing Info – shows song title, artist, and artwork
- Player Embed – adds a built-in player
- Full Station Page – show entire station listing
- Copy the provided `< iframe >` or `< script >` embed code.
- Paste it into your website's HTML.
🔧 Tips for Success
- Use `< iframe >` width of 100% for mobile-friendly embeds.
- You can add multiple webhooks for different purposes (e.g., Discord + logging bot).
- Test webhooks using the “Test” button in SL-DJ before going live.
- Make sure your webhook endpoint (like Discord) accepts the content format.