Docs › Integrations & Analytics

Integrations & Analytics

Twitch live notifications, YouTube upload alerts, and a 30-day server analytics dashboard.

Twitch & YouTube Notifications

Get notified in Discord whenever a Twitch streamer goes live or a YouTube channel uploads a new video.

Required Plan Social Integrations require the social_integrations feature on your subscription.
Server Requirements Twitch and YouTube API keys must be configured in the bot's environment variables (TWITCH_CLIENT_ID, TWITCH_CLIENT_SECRET). If these are blank, the social module is disabled globally.

Twitch Notifications

/
addtwitch <username> <channel>
Subscribe to a Twitch streamer. When they go live, a notification embed is posted in the specified Discord channel. Custom message supported.
/
removetwitch <username>
Remove live notifications for a specific Twitch streamer.

YouTube Notifications

/
addyoutube <channel-id> <notify-channel>
Subscribe to a YouTube channel. New video uploads trigger a notification embed in the Discord channel. Use the YouTube channel ID (starts with UC…).
/
removeyoutube <channel-id>
Remove YouTube upload notifications for a channel.
/
socials
List all active Twitch and YouTube integrations for this server — shows platform, streamer/channel name, notify channel, and enabled status.

How Polling Works

Poller runs every few minutes
→
Check Twitch / YouTube API
→
New stream / video detected?
→
Post notification embed

The bot tracks the last known event ID per integration to avoid duplicate notifications. If the bot restarts, polling resumes automatically from the clientReady event.

Notification Embed

The notification includes the streamer/creator name, stream title or video title, thumbnail, and a direct link. You can set a custom message text per integration to customize the ping (e.g. @everyone is live!).

Managing via Dashboard

Go to Dashboard → Social for a full management UI — add, remove, enable/disable integrations, and set custom notification messages — without any commands.

Analytics

30-day charts tracking your server's activity, growth, and moderation — visible in the dashboard with interactive Chart.js graphs.

Required Plan The Analytics dashboard page requires the analytics feature on a Pro subscription. The /stats command is always available.

Dashboard Charts

👥 Member Count

Daily snapshot of total server member count over 30 days — spot growth and churn trends.

Messages Sent

Daily total message volume across all tracked channels.

Joins & Leaves

Daily new member joins and leaves side by side — correlate with events or announcements.

Mod Actions

Breakdown of moderation actions: warns, bans, kicks, timeouts, automod triggers.

/stats Command

/
stats
Post a server analytics embed showing member count, total messages, joins, leaves, and mod actions. Useful for a public #server-info channel. Available without the analytics Pro feature.

Data Tracked

MetricGranularityRetention
Member count, messages, joins, leaves, voice minutesDailyIndefinite
Active users (unique per day)DailyIndefinite
Messages per hourHourly (0–23)Indefinite
Messages per channelDaily per channelIndefinite
Data starts from bot join date Analytics data begins accumulating from the day the bot joins your server. There is no retroactive data for activity before the bot was added.
Next: Subscription Plans & Admin Panel →