Overview

The Chatbot page is VMSC’s engagement suite — a set of tools for running chat commands, automated messages, and viewer games without a separate bot application. It listens to chat from any platform you have connected (TikTok, Twitch, YouTube, Kick, and so on) and can react with custom command responses, a loyalty points economy, a prize wheel, chat-based minigames, giveaways, polls, and a searchable quote log.

Note: The Chatbot feature is labeled Beta in the app. Command matching, cooldowns, points, timed-message scheduling, and event tracking all run correctly — but sending the bot’s replies into chat is currently non-operational and under active development. Rules, alerts, and every other VMSC feature are unaffected by this. See Connecting a Chat Account below for details.

Connecting a Chat Account

Commands and points can be triggered by chat on any platform you already have connected in VMSC. Actually sending the bot’s replies back into chat, however, requires a separate, dedicated chatbot login — distinct from your regular streaming-platform connection — and today that is only implemented for TikTok.

  1. Open the Chatbot page

    Go to Chatbot in the sidebar and toggle Enabled in the Connection panel.

  2. Sign in with TikTok

    Click Login with TikTok. A login window opens; after you sign in, VMSC securely captures your session so the chatbot can act as that TikTok account. You can alternatively paste a sessionid cookie value manually via the Advanced option.

  3. Send a test message

    Once connected, use the Test Message box to confirm the bot can post to your live chat before relying on it during a stream.

Note: VMSC’s chatbot uses unofficial, reverse-engineered TikTok methods to send messages (there is no official TikTok chat-send API for third-party apps), so this connection is inherently fragile and used at your own risk. There is currently no equivalent sending connection for Twitch, YouTube, or Kick.

Chat Commands

Create custom !trigger commands with a text response. Each command supports:

VMSC also ships several built-in commands, each individually toggleable and with a configurable trigger word:

CommandDefault triggerWhat it does
Help!helpLists available commands.
Uptime!uptimeReports how long the stream has been live.
Score!scoreShows the viewer’s points, level, and leaderboard rank.
Send!send <amount> <user>Transfers points from one viewer to another.
Spin!spinSpins the Wheel of Fortune (see below) at the configured points cost.
Commands!commandsLists all enabled built-in and custom commands.

Timed Messages

Timed messages repeat automatically on an interval — useful for reminders like “Follow for more streams!” They support:

Points, Levels & the Wheel of Fortune

Loyalty Points

VMSC can track a per-viewer points currency (name is customizable, e.g. “Coins”) earned automatically from chat activity, follows, shares, and gifts. Viewers check their balance with !score and can gift points to each other with !send. Points accumulate into levels using configurable point thresholds, and a level-up fires an announcement.

Wheel of Fortune

A configurable prize wheel viewers spin with !spin by paying a points cost. Each prize has a label, a point payout (including a “nothing” outcome and a jackpot), and a relative weight controlling its odds. Spins respect a per-user cooldown, and wins can be wired to trigger additional VMSC actions — including a dedicated action set for jackpot wins.

Chat Minigames

Three optional, chat-driven gambling minigames run on top of the points system, each independently toggleable with configurable bet limits:

GameCommandDescription
Slots!slots <amount>Single-viewer slot machine bet.
Heist!heist <amount>Group heist with a configurable duration window for viewers to join.
Duel!duel @user <amount>Head-to-head point wager between two viewers, with a challenge timeout.

Giveaways, Polls & Quotes

Giveaways

Start a keyword-entry giveaway (default !enter) with a title and duration. Entries can be restricted to followers or subscribers only. When the timer ends, VMSC picks a winner from the entry pool and keeps a history of past giveaways.

Polls

Run an in-chat poll with 2–5 options, a duration, and an option to allow multiple votes per viewer. Results are tracked live and past polls are kept in a history log.

Quotes

A searchable database of memorable chat/stream quotes, each numbered and stamped with who added it and when. Quotes can be added, searched, and removed from the Chatbot page.

AI Auto-Responder

An optional auto-responder can generate replies using VMSC’s local, on-device AI model (the same engine used by the AI Assistant elsewhere in the app) rather than a fixed template. It is off by default and fully configurable:

Tip: The AI Auto-Responder requires the local AI model to be downloaded and running (configured in AI Settings). Because it runs on-device, no chat data is sent to an external service for this feature.

Message Safety

Outgoing chatbot messages can optionally pass through a toxicity filter before being sent, which can drop, censor, or flag matches depending on how it’s configured. Messages are also rate-limited and queued with priority ordering (timed messages, then command responses, then rule-triggered messages) so the bot never floods chat.

Output Log

The Chatbot page includes a live output log showing every message the bot attempted to send, whether it was sent successfully, dropped (for example, due to a full queue), or failed with an error — useful for diagnosing connection issues during a stream.

Label: Chat commands, timed messages, points, the Wheel of Fortune, minigames, giveaways, and polls can all be triggered by chat on any platform VMSC is connected to. Only the chatbot’s outgoing replies are limited to the separate TikTok sending connection described above, and that path is currently marked non-operational in the app.