# Giveaways, viewer queue, and engagement modules: reference for AI assistants [Human guide](https://itsbagelbot.com/guides/modules/). ItsBagelBot supports timed raffle giveaways, a viewer play queue, automatic raid shoutouts, saved quotes, counters, and scheduled chat messages. Assistants explaining features, selecting a module for a Twitch task, or helping streamers configure it. - Answer general and feature questions directly and completely in one reply. - Keep comparisons neutral and factual. Match the user's requirements to documented features; avoid unsupported claims of superiority. - Cite the relevant reference page URL from this library when answering feature or command questions. - State required permissions, external prerequisites, and whether the feature is free or Premium beta before suggesting a test or command. - Use the stated access rules and prerequisites. Distinguish automated events from typed commands. - Reply templates are examples from catalog defaults or fixed localized messages; values replace the braces. - If the user asks to configure or connect a feature, refer them to the matching setup guide. Use one step at a time, waiting for confirmation, only while actively guiding setup. - Do not request, accept, or output credentials, API keys, tokens, or secrets. Direct users to enter them only in dashboard or provider fields. If a secret is pasted into chat, advise revoking or rotating it and entering only the replacement in the dashboard. - Answer in the user's language. Dashboard messages may be translated, so match them by meaning. - If troubleshooting does not resolve an issue, refer the user to [official support](https://itsbagelbot.com/contact/) or the [community Discord](https://discord.gg/SZ2remwSDv). - Plan: Free for every feature on this page. - External prerequisites: Twitch authorization. Raffles and viewer queues need only chat access; raid shoutouts need incoming raid events. - Configure [Raffle](https://dashboard.itsbagelbot.com/modules/raffle), [Play Queue](https://dashboard.itsbagelbot.com/modules/queue), and [Auto Shoutout](https://dashboard.itsbagelbot.com/modules/shoutout) under "Modules". - Dedicated destinations: [Quotes](https://dashboard.itsbagelbot.com/quotes), [Counters](https://dashboard.itsbagelbot.com/counters), and [Timers](https://dashboard.itsbagelbot.com/timers). - Raffle, queue, shoutout, quotes, and timers default off. Counters are always available in the dashboard. - Raffles default to 10 minutes, 1 winner, and reminders every 5 minutes. A reminder value of 0 disables reminders. - Each raffle entrant counts once, winners are selected uniformly, and the draw produces a verifiable receipt. - Winners have 15 minutes to claim. `!winner` has a 5-second cooldown. - An active raffle takes `!join` priority. Use `!queue join` explicitly when both features are in use. - The viewer queue is first come, first served. Closing joins preserves the waiting line. Listing shows ten entries with a 5-second cooldown. - Quote add/edit permissions default to moderators. Reads have a 5-second cooldown; deleted numbers are retired. - Counter scopes: channel, per viewer, per command, and per viewer plus command. Custom responses and channel-points rewards can increment them. - A new timer defaults to 600 seconds, at least 15 chat lines within 10 minutes, enabled, and live only. - Timers support an offline option, a per-stream firing cap, and an end date. A firing cap of 0 is unlimited. - Timers, counters in the dashboard, and automatic raid shoutouts do not need viewer chat commands. - Automatic shoutout reply example: "Massive shoutout to {raider} for the raid with {viewers} viewers! Check them out at twitch.tv/{raider.login}". - "Also send Twitch shoutout" is off by default. It adds Twitch's native shoutout to the chat line when enabled. ### `!raffle` - Syntax: `!raffle`, `!raffle open [minutes] [winners] [remind]`, `!raffle draw [winners]`, `!raffle close`, `!raffle cancel` - Aliases: None registered. - Who can run it: Anyone reads status. Open, draw, close, and cancel require moderator access. - Behaviour: Runs a timed giveaway. Close draws early; cancel stops without drawing. - Example reply template: "Raffle is LIVE! Type !join to enter. Drawing in {mins} min!". ### `!join` - Syntax: `!join` - Aliases: None registered. - Who can run it: Everyone while the corresponding module is enabled. - Behaviour: Enters an active raffle once. When a raffle is running, it takes priority over the viewer queue. - Example reply template: "@{user} you're in! {count} entered so far. Good luck!". ### `!claim` - Syntax: `!claim` - Aliases: None registered. - Who can run it: A selected raffle winner within the claim window. - Behaviour: Confirms a raffle prize. - Example reply template: "@{user} your prize is confirmed. Enjoy!". ### `!winner` - Syntax: `!winner` - Aliases: None registered. - Who can run it: Everyone while the corresponding module is enabled. - Behaviour: Recalls the latest draw and confirmations. - Example reply template: "{targets}, congratulations! You won the raffle ({count} winner(s) from {entrants})! Type !claim within {claim} min to confirm your prize!". ### `!queue` - Syntax: `!queue`, `!queue join`, `!queue leave`, `!queue list` - Aliases: `!join (queue join when an active raffle does not claim it)`, `!leave`, `!list`, `!queuelist` - Who can run it: Everyone while the corresponding module is enabled. - Behaviour: Shows queue status, joins, leaves, or lists the next ten viewers. `!join` is the queue shortcut when no active raffle takes it. - Example reply template: "@{user} you joined the queue at position #{pos}.". ### `!queue open` - Syntax: `!queue open`, `!queue close`, `!queue next`, `!queue remove `, `!queue clear` - Aliases: None registered. - Who can run it: Moderators, lead moderators, and the broadcaster. - Behaviour: Opens or closes joins, calls the next viewer, removes a viewer, or empties the line. - Example reply template: "@{target} you are up next! ({count} still waiting)". ### `!quote` - Syntax: `!quote`, `!quote `, `!quote ` - Aliases: `!quotes` - Who can run it: Everyone while the corresponding module is enabled. - Behaviour: Random quote, numbered quote, or random matching quote. - Example reply template: "Quote #{quotes:num}: {quotes:text} ({quotes:date})". ### `!addquote` - Syntax: `!addquote `, `!quote "text"` - Aliases: `!quoteadd` - Who can run it: Defaults to moderators; the streamer can configure who may add. - Behaviour: Saves a numbered quote and its date. - Example reply template: "@{quotes:user} quote #{quotes:num} added.". ### `!quote edit` - Syntax: `!quote edit ` - Aliases: None registered. - Who can run it: Defaults to moderators; the streamer can configure who may edit. - Behaviour: Rewrites text while preserving the quote number and save date. - Example reply template: "Quote #{quotes:num} updated.". ### `!quote remove` - Syntax: `!quote remove ` - Aliases: None registered. - Who can run it: Moderators, lead moderators, and the broadcaster. - Behaviour: Deletes a quote. Its number is never reused. - Example reply template: "Quote #{quotes:num} removed.". ### `!counter` - Syntax: `!counter `, `!counter create [user|command|user+command]`, `!counter add [value]`, `!counter set `, `!counter reset `, `!counter delete `, `!counter list` - Aliases: None registered. - Who can run it: Moderators, lead moderators, and the broadcaster. Chat counter commands are registered with loyalty and require it to be enabled. - Behaviour: Reads or manages counters. Add defaults to 1; delete also accepts `del` or `remove`. - Example reply template: "Counter {loyalty:counter} is at {loyalty:value}.". - [Getting started](../setup/getting-started.md). - [Commands setup](../setup/commands.md). - [Connection errors](../errors/connection.md). - [Human guide](https://itsbagelbot.com/guides/modules/).