⏰ Timers

Automated timed messages that post to your chat at regular intervals, perfect for reminders, promotions, and engagement.

---

Overview

Timers automatically send messages to chat based on:

• Time interval (minutes between messages)
• Chat activity (minimum messages before posting)

This ensures messages go out regularly but not during quiet moments.

---

How Timers Work

1. You create a timer with a message and interval
2. Timer waits for the interval to pass
3. Timer checks if minimum chat lines occurred
4. If both conditions met, message posts
5. Timer resets and waits again

---

Timer Settings

Each timer has:

Setting	Description	Default
Name	Timer identifier (for you)	—
Message	Text to post in chat	—
Interval	Minutes between messages	15
Chat Lines	Minimum chat activity required	2
Active	Enable/disable timer	On

---

Creating Timers

Step 1: Navigate to Timers

1. Go to Chat Bot → Timers in your dashboard
2. Click Add Timer or the + button

Step 2: Configure the Timer

1. Name: Give it a descriptive name (viewers don't see this)
2. Message: Write the message to post
3. Interval: Set minutes between posts
4. Chat Lines: Minimum activity required
5. Active: Toggle ON

Step 3: Save

Click Save to activate the timer.

---

Timer Examples

Social Reminders

Discord Timer

Name: Discord Promo
Message: Join our Discord community for updates and chat! discord.gg/yourserver
Interval: 30 minutes
Chat Lines: 5

Follow Reminder

Name: Follow Reminder
Message: If you're enjoying the stream, consider dropping a follow! ❤️
Interval: 45 minutes
Chat Lines: 10

Stream Information

Commands Timer

Name: Commands Info
Message: Type !commands to see available chat commands!
Interval: 20 minutes
Chat Lines: 3

Schedule Timer

Name: Schedule
Message: I stream Mon/Wed/Fri at 7pm EST! Follow to get notified!
Interval: 60 minutes
Chat Lines: 5

Engagement

Lurker Check

Name: Lurker Love
Message: Lurkers welcome! No pressure to chat, just enjoy the vibes 🌙
Interval: 45 minutes
Chat Lines: 5

Interaction Prompt

Name: Engagement
Message: How's everyone doing today? Let me know in chat!
Interval: 30 minutes
Chat Lines: 10

---

Best Practices

Interval Timing

Content Type	Recommended Interval
Socials/Links	30-60 minutes
Rules/Info	45-90 minutes
Engagement	20-40 minutes
Promotions	60+ minutes

Chat Line Requirements

Stream Size	Recommended Lines
Small (< 20 viewers)	2-5 lines
Medium (20-100)	5-10 lines
Large (100+)	10-20 lines

Content Tips

1. Vary Your Messages: Don't repeat the same thing constantly
2. Be Natural: Write like you're talking, not advertising
3. Include Value: Every timer should help viewers
4. Don't Overdo It: 3-5 timers is usually enough

---

Managing Timers

Editing Timers

1. Find the timer in your list
2. Click Edit or the pencil icon
3. Make changes
4. Save

Disabling Timers

1. Toggle Active to OFF
2. Timer stops until re-enabled

Deleting Timers

1. Click Delete or trash icon
2. Confirm deletion

Organizing Timers

• Use clear names to identify purpose
• Group by category mentally
• Disable timers not relevant to current content

---

Timer Variables

Some variables work in timer messages:

Variable	Description
{channel}	Your channel name
{game}	Current game
{uptime}	Current stream duration

Example:

Message: We've been live for {uptime} playing {game}! Thanks for hanging out!

---

Troubleshooting

Timer Not Posting

Issue	Solution
Timer inactive	Check Active toggle is ON
Not enough chat	Lower Chat Lines requirement
Interval too long	Reduce interval minutes
Bot disconnected	Reconnect bot in settings

Timer Posting Too Often

Issue	Solution
Spammy	Increase interval
Always posting	Increase Chat Lines
Too many timers	Reduce number of active timers

Message Issues

Issue	Solution
Message cut off	Keep under 500 characters
Link not working	Verify URL is correct
Variables showing literally	Check variable spelling

---

Advanced Tips

Stagger Your Timers

If you have multiple timers, set different intervals so they don't all fire together:

• Timer A: 15 minutes
• Timer B: 20 minutes
• Timer C: 30 minutes

Seasonal Timers

Create timers for specific events:

• Holiday promotions
• Special stream events
• Limited-time content

Disable them when not relevant.

Test Mode

Before going live:

1. Enable timers
2. Wait for interval
3. Verify messages appear correctly
4. Adjust as needed

---

FAQ

Q: Do timers work when I'm offline? A: No, timers only run during active streams.

Q: Can I have multiple timers post the same message? A: Yes, but it's usually not needed.

Q: What's the minimum interval? A: 1 minute, but 10+ minutes is recommended.

Q: Do timers count their own messages for chat lines? A: No, only viewer messages count.

Q: Can I schedule timers for specific times? A: Currently no, only interval-based.

Q: How many timers can I have? A: No strict limit, but 5-10 is practical.