Streamer Alerts
Posts a ping to a Discord channel when one of your tracked streamers goes live on Twitch, YouTube, Kick, or TikTok.
Supported platforms
| Platform | Detection | Notes |
|---|---|---|
| Twitch | EventSub (push, ~5s latency) + polling backstop | OAuth credentials required for live state. |
| YouTube | Polling (every 2 min) | Detects both live streams and new VODs (configurable). |
| Kick | Polling | No official API; uses Kick's public endpoints. |
| TikTok | Polling | TikTok live state; lower fidelity than Twitch. |
Where it lives
Dashboard: Streamer Alerts → Twitch / YouTube / Kick / TikTok (one page per platform).
Settings per platform
- Channel list — usernames / IDs of streamers to track. Add as many as you want per platform.
- Alert channel — where to post the live notification.
- Ping role — optional role to ping (
@Twitch-Notif-Subsstyle opt-in role). - Custom message — template with placeholders (
{streamer},{title},{game},{url}). - Cooldown — minimum interval between repeated alerts for the same streamer (e.g. 30min — stops ping spam if a streamer disconnects + reconnects).
Twitch specifics
Twitch alerts use EventSub for ~5-second latency. To enable:
- Phantom must have Twitch API credentials configured (server-side; nothing for you to do unless you're self-hosting).
- Per-streamer subscriptions are auto-created when you add a username.
- A polling backstop runs every 60 seconds to catch missed EventSub notifications.
When EventSub isn't configured, Twitch falls back to 15-second polling.
Auto-roles
Optional per-streamer: when a tracked streamer goes live, grant them a role (e.g. @🔴 Live Now). Stripped when they go offline.
Multi-role grants are batched into a single PATCH call so a 10-role apply is one REST call, not 10.
Permissions
community.view— see settings + recent alertscommunity.edit— add / remove streamers, change settings
Tips
- Use a ping role that members opt into (via Reaction Roles), not @everyone. Streamer notifications get muted fast otherwise.
- Set a cooldown of 15-60 minutes. Streamers crash and reconnect; nobody wants 6 "live now!" pings in 5 minutes.
- Twitch + EventSub is the fastest. If responsiveness matters, prioritise Twitch tracking.
Cost & limits
- All platforms free to track.
- Per-platform poll-interval is global, not per-streamer; adding streamers doesn't slow detection.
Related pages
- Reaction Roles — for opt-in ping roles
- Channel Stats — separate; doesn't track streams