The Scheduler capability lets bots send messages on a schedule. Supports both recurring interval schedules and daily schedules at specific times.
Commands
| Command | Description |
|---|---|
!Bot schedule add interval <min> <#channel> <message>
|
Add a recurring schedule |
!Bot schedule add daily <HH:MM> <#channel> <message> |
Add a daily schedule (UTC) |
!Bot schedule list |
List all active schedules |
!Bot schedule remove <id> |
Remove a schedule by ID |
Schedule Types
- Interval — Fires every N minutes (e.g., every 30 minutes). The minimum interval is configurable (default: 5 minutes).
- Daily — Fires once per day at a specific time in UTC (e.g., 09:00). Uses 24-hour format.
Configuration
Admins can configure via /bot set:
sched_max— Maximum active schedules (default: 10)sched_min_interval— Minimum interval in minutes (default: 5)
Examples
!MyBot schedule add interval 60 #general Take a break! !MyBot schedule add daily 09:00 #general Good morning, team! !MyBot schedule list !MyBot schedule remove s1a2b3
Notes
- All times are in UTC
- Schedules persist across bot restarts
- Each schedule has a unique ID shown in the list command
- Timers automatically reschedule after firing