First Time Setup Guide
Get BotOfTheSpecter up and running on your Twitch channel in just a few minutes
What is BotOfTheSpecter?
BotOfTheSpecter is a cloud-based Twitch chat bot that runs entirely on our servers. You don't need to install any software, run servers, or manage technical infrastructure. Just connect your Twitch account and start using the bot immediately!
Step 1: Access the Dashboard
Step 2: Connect Your Twitch Account
- Click the "Login with Twitch" button on the dashboard
- You'll be redirected to Twitch's authorization page
- Review the permissions and click "Authorize"
- You'll be redirected back to the dashboard, now logged in
Permissions: When you authorize BotOfTheSpecter, you'll be asked to grant the following permissions:
- Delete chat messages in channels where you have the moderator role
- Read unban requests in channels where you have the moderator role
- Perform moderation actions in a channel
- Grant or remove the moderator role from users in your channel
- Edit your channel's broadcast configuration including extension activations
- Manage Channel Points custom rewards and their redemptions on your channel
- Manage your channel's broadcast configuration, including updating channel configuration and managing stream markers and stream tags
- Read your list of follows
- Send live Stream Chat and Rooms messages
- Read the list of VIPs in your channel
- Grant or remove the VIP role from users in your channel
- Get the details of your subscription to a channel
- Send announcements in channels where you have the moderator role
- Get a list of all users on your block list
- Add and remove users from your block list
- Get your Twitch user ID, username, profile image, profile update date, email address, and email verification status
- Manage your channel's polls
- Read chat messages from suspicious users and see users flagged as suspicious in channels where you have the moderator role
- Read your channel's Hype Train data
- View Channel Points rewards and their redemptions on your channel
- Get a list of all subscribers to your channel and check if a user is subscribed to your channel
- Manage your channel's schedule, including adding, updating, and deleting segments
- Create clips from a broadcast or video
- Join your channel's chat as a bot user
- Read the list of channels you have moderator privileges in
- Read non-private blocked terms in channels where you have the moderator role
- Read chat settings in channels where you have the moderator role
- Read the list of moderators in channels where you have the moderator role
- Read the list of bans or unbans in channels where you have the moderator role and in Shared Chat sessions where you are a moderator for a channel in the Shared Chat
- Read deleted chat messages in channels where you have the moderator role and in Shared Chat sessions where you are a moderator for a channel in the Shared Chat
- Read warnings in channels where you have the moderator role
- Join chat as your user and appear as a bot
- Manage AutoMod in channels where you have the moderator role
- Read charity campaign details and user donations on your channel
- Read your email address and email verification status
- Read chat messages and appear in chat as your user
- Write chat messages as your user
- View live Stream Chat and Rooms messages
- View your channel's moderation data including Moderators, Bans, Timeouts and Automod settings
- Read the list of followers in channels where you are a moderator
- Read the list of chatters in channels where you have the moderator role
- View your channel's Bits information
- Run ads and manage the ads schedule on your channel
- Read the ads schedule and details on your channel
- Ban or unban users in channels where you have the moderator role
- Read shoutouts in channels where you have the moderator role
- Manage shoutouts in channels where you have the moderator role
Why so many permissions?
BotOfTheSpecter is a comprehensive bot that handles moderation, entertainment, analytics, and channel management.
Each permission enables specific features that make your streaming experience better.
Step 3: Set Up Bot Permissions
The bot needs to be a moderator in your channel to function properly. Here's how to add it:
- Go to your Twitch Dashboard
- On the left panel, expand the Community menu
- Click Roles Manager
- Click Add New
- In the search bar, enter:
BotOfTheSpecter - Select the bot user and check the Moderator permission
- Optional: Also check the Editor role to enable VOD video access
Why is this needed? As a moderator, the bot can:
- Delete inappropriate messages
- Timeout or ban users when necessary
- Respond to commands in chat
- Manage channel point redemptions
Editor role benefits: Allows the bot to access VODs and video content for video-related commands.
Step 4: Return to BotOfTheSpecter Dashboard & Configure
Now that the bot has moderator permissions on Twitch, return to the BotOfTheSpecter dashboard to configure and enable the bot:
Basic Settings
Once back in the dashboard, configure your bot:
- Bot Status: The website will detect when you've modded the bot. If you still see a warning, log out and log back in to refresh your permissions. Click the START button to run the bot and WAIT for the system to switch your bot on.
- Channel Information: Set up your channel preferences on the Profile page. Here you can configure:
- Technical terms and advanced options toggle for bot configuration
- Dashboard language (English, French, or German)
- Your Time Zone and Weather Location
- HypeRate.io integration for heart rate display in chat - get your code here
- External connections for Discord, Spotify, and StreamElements
- Command Prefix: The command prefix is set to exclamation point
!and cannot be changed
Control Your Bot:
BotOfTheSpecter is designed with control in mind - you run the bot, you stop the bot.
If you no longer wish to use the bot, simply STOP Specter with the STOP button. It's that simple.
We have purposely built Specter this way - no company or system should tell you how to run your own stream, and we don't want to do that.
It's your stream, you are choosing to use Specter and we can't thank you enough for choosing us.
We know you have a huge choice of bots out there, but a heads up: BotOfTheSpecter gets its name from "BOTS" - it's a bot to replace them all.
As our developer has always said,
BotOfTheSpecter is designed with control in mind - you run the bot, you stop the bot.
If you no longer wish to use the bot, simply STOP Specter with the STOP button. It's that simple.
We have purposely built Specter this way - no company or system should tell you how to run your own stream, and we don't want to do that.
It's your stream, you are choosing to use Specter and we can't thank you enough for choosing us.
We know you have a huge choice of bots out there, but a heads up: BotOfTheSpecter gets its name from "BOTS" - it's a bot to replace them all.
As our developer has always said,
"I built Specter so I'm not running 4 different chat bots on my own stream, now I just run one, that's Specter."
Moderation Settings
Configure how the bot helps moderate your chat on the Modules page:
- Joke Blacklist: Set up joke categories to blacklist from the
!jokecommand - Chat Protection: Enable/disable URL blocking in chat
- When enabled, you can whitelist specific links to allow them
- When disabled, you can still blacklist links that will ALWAYS be removed from chat
Step 5: Set Up Bot Points
Configure the internal point system that rewards your viewers for engagement.
This system is enabled by default and cannot be turned off at the time of writing this help document (feature coming soon):
- Point Name: Set a custom name for your points (e.g., "Coins", "Tokens", "Credits")
- Earning Rates: Configure how many points users earn for:
- Each chat message sent
- Following your channel
- Subscribing to your channel
- Each cheered message
- Each viewer in a raid
- Subscriber Multipliers: Set up bonus multipliers for subscribers (e.g., 2x points for subscribers)
Why set this up?
Bot Points encourage viewer engagement and create a fun, gamified experience in your community.
Points can be redeemed for custom rewards, shoutouts, or special privileges. (Features coming soon)
Bot Points encourage viewer engagement and create a fun, gamified experience in your community.
Points can be redeemed for custom rewards, shoutouts, or special privileges. (Features coming soon)
Step 6: Customize Your Bot (Optional)
Custom Commands
We recommend that you set up some custom commands that users can use, for example your social links, !discord, !youtube, !instagram, etc.
They can be created on our Custom Commands page on the Specter Dashboard.
Want to level up your commands?
Explore Custom Variables to add dynamic features and personalize your command responses.
Note: Custom Variables only work in the response part of your command.
Explore Custom Variables to add dynamic features and personalize your command responses.
Note: Custom Variables only work in the response part of your command.
Auto Messages
We also recommend you set up some auto messages that the bot will post on a timer and after a set amount of messages - you can pick these settings.
They can be created on our Timed Messages page on the Specter Dashboard.
Info: Timed messages are sent automatically by the bot at set intervals and chat activity, but only while your channel is online.
The bot posts timed messages in three ways:
The bot posts timed messages in three ways:
- After a set time interval
- After a certain number of chat messages (line triggers)
- After a certain number of chat messages with a time delay
Troubleshooting
Bot Not Appearing in Chat
- Check that the bot is turned on in the dashboard
- Verify the bot is added as a moderator
- Try refreshing the dashboard and re-starting the bot
- Check the bot status indicator in the dashboard ONLINE/OFFLINE
Commands Not Working
- Ensure you're using the correct command prefix, the bot uses
! - Check if the command is enabled in settings
- Verify the user has permission to use it
- Some commands require premium features, check if this is the case
Login Issues
- Try logging out and back in
- Clear your browser cache and cookies
- Make sure you're using a supported browser, all modern browsers are supported
- Check if Twitch is experiencing issues here as we may be affected by their downtime
Permission Errors
- Ensure the bot is a moderator in your channel
- Check that you have broadcaster permissions, only the broadcaster can start and stop the bot, our moderator dashboard does not have this capability
- Some features require VIP or subscriber status if you've enabled them, check to make sure the user has the appropriate role
Setup Complete!
Congratulations! Your Specter is now set up and running. Once started, the bot automatically joins your channel and remains available 24/7.
Next Steps:
- Explore the dashboard to discover all available features
- Customize commands and settings to match your stream style
- Check out the help documentation for advanced features
- Join our Discord for community support and tips
Premium Features
Some advanced features require a premium subscription:
- AI Chat: Have conversations with an AI in your chat
- Advanced Music: Use
!songwithout connecting Spotify - Shared Bot Name (BotOfTheSpecter): The default shared bot username used across the platform.
- Custom Bot Name (Your Custom Bot Name, Experimental/Coming Soon): Use your own bot username instead of "BotOfTheSpecter". This feature is experimental & is coming soon.
Support the developer on Twitch to unlock these features!
Need Help?
If you encounter issues during setup, don't hesitate to reach out: