Timers

Timers are scheduled messages that post in your chat at regular intervals. Use them to remind viewers about social media, rules, or promotions.

Creating a Timer

Navigate to Timers in the dashboard sidebar
Click Create Timer
Set the message content
Configure the interval
Save and enable

Properties

Property	Description	Default
Name	A unique name for the timer	Required
Enabled	Toggle the timer on or off without deleting it	`true`
Interval	How often the timer fires, in seconds	`300` (5 min)
Repeat Count	Number of times to fire (leave empty for unlimited)	Unlimited
Offset	Delay before the first fire, in seconds	`0`
Action	An optional action to trigger when the timer fires	None
Message	A text message to send when the timer fires	None

Timer + Action Integration

Timers can trigger actions when they fire. Set the actionId field to link a timer to an action, or use the Timer Tick trigger event in the action’s flow.

This lets you build complex timed automations — for example, a timer that rotates through different social media messages using an action with random sub-actions.

Tips

Keep timer messages concise and valuable to viewers
Use longer intervals (15–30 min) to avoid feeling spammy
Rotate multiple timers rather than using one long message
Link timers to actions for dynamic, variable-driven messages

Dashboard Permissions

Action	Required Permission
View timers	`timers:read` — Viewer and above
Create, edit, delete timers	`timers:manage` — Moderator and above