Twitch Chatbot: Commands and Timers

Install the bot in your chat

Before you can create commands or timers, the bot has to be installed in your channel. Open Chatbot in the sidebar and follow Install the Bot in your chat. You are redirected to Twitch to grant Vision the extra permissions it needs.

The bot posts as the shared 1upvision account. If the connection breaks, the chatbot page shows Reconnect Twitch so you can authorize it again.

Create a chat command

1. 1

   Open Commands

   In the sidebar, go to Chatbot → Commands.

2. 2

   Start a new command

   Click Create Command. The dialog has the tabs General, Alias, Conditions and Actions.

3. 3

   Name the command

   Enter the Command Name, for example !discord or !socials. Viewers type this in chat to trigger it.

4. 4

   Write the response

   Choose how the bot replies: Chat message, /me action or Announcement, then write the text (up to 500 characters).

5. 5

   Choose who can use it

   Under Who can trigger this command? pick Everyone, Whitelist or Blacklist and tick the roles: Broadcaster, Moderator, VIP, Subscriber or Viewer.

6. 6

   Save and test

   Click Create Command, then type the command in your chat to check the reply.

Aliases, conditions and variables

Example response: Thanks for watching, {{username}}! Today we're playing {{game}}.

Alias

In the Alias tab, use Add alias to give a command more triggers, for example !dc for !discord.

Conditions

Run a command only when the conditions match. Fields: Stream Title, Game, Viewer Count, Tags, Date & Time, Time of Day and Day of Week. Comparisons include Contains, Equals, Greater than, Less than, At least, At most and Between.

Variables

Use Insert variable… in the response to add live values: {{username}} (who used the command), {{title}} (stream title), {{game}} (current game), {{vision:lobby:participants}} (lobby participants) and an Overlay Variable that reads a value from a layer in your overlay.

Control your overlay from chat

In the Actions tab, a command can change your overlay every time it runs. You can add up to three actions per command.

Overlay

Change a layer in one of your overlays: add to, subtract from, set or reset values such as counters, scores, text and countdowns, toggle visibility, or pause and resume timers.

Rotation

Play a logo from one of your logo rotations.

Variable

Increment, decrement, set or reset a Vision variable.

Post messages on a schedule with timers

Timers post messages or run commands automatically. Go to Chatbot → Timers and click Create Timer. The dialog has the tabs General, Commands & Messages, Conditions and Actions.

Timer name

A name so you can find the timer in the list, for example “Regular shoutout”.

Simple interval

Set an Online interval (seconds) for when you're live and an Offline interval (seconds) for when you're not. Enter 0 to switch a state off. The minimum is 10 seconds.

Custom times

Run the timer at fixed times in your time zone: Every hour, Every day, Weekdays only, Weekends only or Specific days, with separate schedules for live and offline.

Commands & Messages

Pick Linked commands to run and add Chat messages. Send them as a Chat message or an Announcement.

Conditions and Actions

Timers use the same conditions and overlay actions as commands.

Moderation filters

Under Chatbot → Moderation you can create filters that catch messages with a word list or a regular expression and then delete them, warn, time out or ban. Templates cover links, repeated characters and long messages. AI Moderation is a separate add-on that checks the messages your filters let through.