⚙️ Bot Setup
The Citrus Chat Bot provides automated responses, commands, moderation, and engagement features across all your connected streaming platforms.
Overview
The Citrus bot joins your chat channels and provides:
- Custom commands
- Automated moderation
- Timed messages
- Giveaway management
- Widget command processing
Supported Platforms
| Platform | Status |
|---|---|
| Twitch | ✅ Full Support |
| Kick | ✅ Full Support |
| YouTube | 🔜 Coming Soon |
Initial Setup
Step 1: Connect Your Platforms
Before the bot can work, connect your streaming platforms:
- Go to Account Settings
- Connect your Twitch and/or Kick accounts
- Verify connections are active (green checkmarks)
See Connecting Platforms for detailed instructions.
Step 2: Enable the Bot
- Go to Chat Bot → Settings in your dashboard
- Ensure the Bot Enabled toggle is ON
- The bot will automatically join your channels
Step 3: Verify Bot is Active
Check that the bot has joined:
- Look for "CitrusBot" or the bot username in your chat
- Try a test command like
!commands - Check the bot status indicator in your dashboard
Bot Status Indicators
In your dashboard, you'll see:
| Status | Meaning |
|---|---|
| 🟢 Connected | Bot is in your channel |
| 🔴 Disconnected | Bot needs to reconnect |
| ⚠️ Error | Connection issue |
Bot Features Overview
Commands
Create custom chat commands with variables and responses.
Moderation
Automated moderation for caps, links, spam, and more.
Timers
Send automated messages at intervals.
→ Timers
Giveaways
Run keyword-based giveaways with entry tracking.
Bot Permissions
Twitch Permissions
For full functionality on Twitch, the bot needs:
- Read messages: To see and respond to commands
- Send messages: To post responses
- Moderate: For moderation features and widget timeouts
Kick Permissions
The bot uses your Kick connection to:
- Read chat messages
- Post responses
- Execute moderation actions
Broadcast Settings
Control what the bot announces in chat:
| Setting | What It Announces |
|---|---|
| Broadcast TTS | TTS message played |
| Broadcast Sounds | Sound alerts triggered |
| Broadcast Media | Media shares playing |
| Broadcast Payphone | Calls connected |
| Broadcast Wheel | Prize wheel results |
| Broadcast Tip | Juice donations received |
| Broadcast Timeouts | Viewer timeouts |
| Broadcast Overlay | Interactive overlay access |
Configure these in Chat Bot → Settings.
Reconnecting the Bot
If the bot disconnects:
- Go to Chat Bot → Settings
- Click Reconnect Bot or Force Join
- Wait 10-30 seconds
- Verify the bot appears in chat
Automatic Reconnection
The bot attempts to reconnect automatically when:
- You start streaming
- Connection is lost temporarily
- Dashboard is refreshed
Troubleshooting
Bot Not Responding
| Issue | Possible Solution |
|---|---|
| Bot not in chat | Click "Reconnect" in bot settings |
| Commands ignored | Check command is enabled and spelled correctly |
| Wrong platform | Verify correct platform is connected |
| Permissions | Ensure bot has moderator permissions |
Connection Issues
| Issue | Possible Solution |
|---|---|
| Won't connect | Check platform connection in Account Settings |
| Keeps disconnecting | Check your internet stability |
| Shows offline | Refresh dashboard and reconnect |
Platform-Specific Issues
Twitch
- Ensure OAuth is valid (re-connect if needed)
- Bot needs moderator status for some features
Kick
- Verify username is entered correctly
- Check Kick connection status
Best Practices
- Make Bot a Moderator: Give the bot mod status for full functionality
- Test Commands: Try commands before going live
- Monitor Logs: Check bot activity in the dashboard
- Update Connections: Reconnect platforms periodically to refresh tokens
- Set Up Moderation: Configure filters before enabling
FAQ
Q: Does the bot work when I'm offline? A: The bot only runs when you're active in the dashboard or streaming.
Q: Can I change the bot's name? A: The bot name is fixed as the Citrus bot account.
Q: Does the bot work on mobile? A: The dashboard is mobile-friendly; bot functions work regardless of your device.
Q: Why isn't the bot responding to widget commands? A: Ensure widgets are enabled and the bot has moderator permissions.
Q: Can I have the bot on multiple channels? A: The bot works on your connected channels only.