Skip to content

EventSub

vtor.bot uses Twitch EventSub to listen for real-time events on your channel. This powers Discord notifications, automatic shoutouts, and chat alerts.

The bot listens for the following events:

  • Stream Online: Triggers a Discord notification and a chat alert.
  • Stream Offline: Triggers a Discord notification.
  • Follow: Syncs “Follower” role on Discord and triggers a chat alert.
  • Subscribe: Syncs “Subscriber” (and Tier/Prime) roles on Discord and triggers a chat alert.
  • Gift Sub: Triggers a chat alert. Supports mass gifting detection.
  • Resub: Triggers a chat alert with message and cumulative months.
  • Raid: Triggers an automatic shoutout (if enabled) and a chat alert.
  • Cheer: Triggers a chat alert with bit amount and message.
  • Hype Train: Triggers chat alerts for Begin, Progress, and End.
  • Polls: Triggers chat alerts for Begin and End.
  • Predictions: Triggers chat alerts for Begin and End.
  • Charity: Triggers chat alerts for donations.
  • Goals: Triggers chat alerts for Goal Begin and End.
  • Ad Break: Triggers a chat alert when an ad break begins.

Most EventSub features work automatically once you authenticate the bot.

  • Discord Notifications: Configure in the Discord tab of the dashboard.
  • Auto Shoutouts: Configure in the Shoutouts tab of the dashboard.
  • Chat Alerts: Configure custom messages for each event type in the Alerts tab of the dashboard.