Twitch shoutout command and !so for your chat

The short answer

The Twitch shoutout command is /shoutout name. You or a moderator type it in your chat, and Twitch tells your viewers to visit that streamer, with a Follow button for anyone who doesn’t follow them yet. It only works while you are live, and Twitch limits how often you can use it.

Bloopbot adds a !so shoutout command on top. When you or a moderator type !so name (or !shoutout name), Bloopbot posts a shoutout message in chat and sends Twitch’s own /shoutout for you. If your overlay has a Clip player, it also plays one of that streamer’s clips. It is the Shoutout flow in the Starter pack, and you can change its message, who can use it, and when it runs, including an auto shoutout whenever someone raids you.

What Twitch’s /shoutout does

Twitch sends a shoutout to the channel you name. Viewers who don’t follow that channel see a pop-up Follow button in your chat. The Twitch rules, from Twitch’s Send a Shoutout reference:

• Who can send one. The broadcaster, or a moderator of the channel.
• How often. Your channel can send one shoutout every 2 minutes, and a shoutout to the same streamer once every 60 minutes. Past either limit, Twitch refuses it.
• When. Your channel must be live. Twitch also refuses a shoutout to yourself.

These limits belong to Twitch. They hold whether you type /shoutout yourself or a bot sends it.

How !so works in Bloopbot

Type !so pixelpal in your chat. The Shoutout flow then does these things in order:

1. Checks that you are the broadcaster or a moderator. Anyone else is ignored, with no reply.
2. Looks up the streamer on Twitch. If the name isn’t a Twitch account, chat gets “Could not find user: name”.
3. Sends Twitch’s own /shoutout while you are live. Offline, it skips this step and the flow’s Run log says so.
4. Posts the shoutout message in chat. By default it tells chat to check out PixelPal at their Twitch link and names the game they last streamed. When they have no game, the line leaves that part out.
5. Shows your Clip player layer, plays one of the streamer’s clips on it, and hides it again afterwards. With no Clip player on your overlay, this step plays nothing and the rest still works. Play a streamer’s clip when you shout them out sets the player up.

!so with no name replies with its usage line. The command has no cooldown of its own, so Twitch’s limits above are the only ones until you add one.

If you don’t have it yet, open Flows, press Marketplace, add Shoutout (it is in the Starter pack) and switch it on. It arrives paused. Bring your Nightbot !so over with the importer if you are moving; it offers Use Bloopbot’s shoutout (Coming from Nightbot).

Shout out raiders automatically

An auto shoutout is a second flow that starts on a raid instead of a command. Bloopbot has no ready-made one, but it takes four steps:

1. On Flows, make a new flow and start it with Incoming raid. Set Minimum raiders to skip small raids, or leave it at 0 for every raid.
2. Add Shout out a streamer after it.
3. Set Who to $(raiderlogin), the channel that raided you. Leave Twitch shoutout too on.
4. Save and switch the flow on.

Each raid now gets a chat shoutout and Twitch’s own shoutout. To play a clip as well, add Play a shoutout clip with Whose clip set to $(raiderlogin) and the Show a layer steps from Use the step in your own flow. Polls and predictions has the same raid flow with a stream marker added.

Change the message

Open the Shoutout flow and select Shout out a streamer.

• Message is sent when the streamer was last playing a game, and Message (no game) when they weren’t. Write what you like.
• Three details about the streamer fill in by name: $(user) is their display name, $(login) their channel name for the link, and $(game) their last game. $(title) is their last stream title and $(description) their Twitch bio.
• Who is $(1), the first word after the command. Change it to $(raiderlogin) in a raid flow, as above. Name the words after a command explains $(1).
• Twitch shoutout too switches Twitch’s own shoutout off if you only want the chat message.

Change who can use !so

The flow checks Who can trigger for moderators and up. Change that check to Broadcaster only, or delete it to let everyone use the command. Add a Cooldown step before Shout out a streamer if you want chat to wait between shoutouts. Add permissions and cooldowns shows both. A command with no Who can trigger step is listed under Everyone on your public Commands page.

On Kick

Shoutouts are Twitch only. Bloopbot leaves Shoutout out of a Kick channel’s Starter flows, and the Shout out a streamer step is marked Needs Twitch on Kick. Bloopbot on Kick lists what works there.

Troubleshooting

• The chat message appears but Twitch’s shoutout doesn’t. Open the Run log. “Twitch shoutout skipped: channel offline” means you weren’t live. “Twitch shoutout failed” followed by Twitch’s reason usually means a limit: one shoutout every 2 minutes, or the same streamer within 60 minutes. The chat message goes out either way.
• Nothing happens at all. Check the flow is switched on and that the person typing !so is a moderator or you. A viewer’s !so gets no reply.
• Twitch’s shoutout fails and the Run log shows a Twitch error. The bot sends Twitch’s shoutout as a moderator, so it must be one in your chat. The dashboard shows a Not a mod bar until it is, and Make the bot a moderator walks through it.
• “Could not find user”. The name isn’t a Twitch account. Check the spelling; a leading @ is fine.
• No clip plays. The streamer may have no public clips, or your overlay has no Clip player. The clip guide covers each case.