Chat bot and commands
The bot takes song requests from chat and replies to viewers on its own: added to the queue, song not found, queue full.
How to enable the bot
- Open Settings → Bot and enable the bot (or use the switch on the "General" page).
- In your Twitch chat, run the
/modcommand with the bot's login. It is shown on the page and can be copied with a button. - Done. The bot joins the chat by itself when your stream starts. Setup is one-off: you do not need to do anything for each stream.
If you do not see the bot in the settings, the chat bot is not included in your project's plan.
The bot on YouTube
On YouTube the bot posts from a separate channel, BardWayBot, and joins the chat when your stream starts. Make it a moderator of your channel, once:
- Open YouTube Studio → Settings → Community.
- In the "Standard moderators" block press "Manage" and add the bot's channel by this link https://www.youtube.com/channel/UCf99y9DDs7EFsKLhPFymGiQ (you can copy it on the Settings → Bot page, the YouTube tab).
The standard moderator level is enough. Without it YouTube's filters (links, slow mode, members-only mode) can hide the bot's replies from viewers.
When the chat is quiet, the bot's reply on YouTube may take up to a minute; when the chat is busy, the bot replies quickly.
Built-in commands
| Command | What it does |
|---|---|
!sr | Request a song, for example !sr Zombie |
!song | Show which song is playing now |
!next | Show the next songs in the queue |
!sq | A link to the song queue |
!srs on / !srs off | Open and close the queue |
!balance / !coins | Tell the viewer how many coins they have. Template only, see Activities and minted coins |
!answer, !vote | Answer and vote in Music break games. Template only, see Music break |
The "Postpone order" command (!defer) and "I'm back" (!back, !resume) are also added from the "Templates" in the command editor: they do not
appear in the project on their own. !defer 5 and !defer 10 postpone a viewer's orders for 5 and
10 minutes, !defer without a number postpones them until removed, and !back removes the
postponement. More: How to request a song.
The list of commands for viewers is also shown on the "Bot commands" page of your channel. You and the administrators also see the "admins only" commands there, with a mark. Viewers do not see them.
Your own commands and aliases
In Settings → Bot → Commands you can:
- add a command: a key (for example
!sr), the bot's reply text and a description; - add aliases, that is, other names for the same command;
- make a command admins and owner only. In chat, such a command can be run by you, the moderators of your Twitch channel and the channel administrators in BardWay, if they write from the Twitch account they use to sign in to the site;
- insert placeholders into the reply text with buttons (viewer name, song and so on);
- pick a ready-made template: its settings fill the form, and you only need to save.
The action type "Just reply" outputs text only, with no side effects.
Events
The bot also replies to queue events. They fire when something happens on the channel: the queue is full, the song has already been played, a viewer has used up their limit. In Settings → Bot → Events you can change the reply text or pick a ready-made template. You can turn events off entirely with one switch.
Coin events, "Manual award" and "New shop request", are turned on in the activities settings, see Activities and minted coins.
Plans
On Free the built-in commands and up to 5 of your own are available. On Pro the number of your own commands is unlimited. Details: Plans.
Frequently asked questions
What should I do if the bot does not reply in chat?
Check that the bot is enabled, that you ran /mod with its login, and that the stream is on: the bot
joins the chat when the stream starts. On YouTube also check that the bot's channel is made a moderator.
How does a viewer request a song?
Write !sr and the song title in chat, or pick a song on your public page.
How do I close the queue with a command?
The !srs off command closes the queue, and !srs on opens it.