> For the complete documentation index, see [llms.txt](https://zoomiescore.gitbook.io/zoomiescore-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zoomiescore.gitbook.io/zoomiescore-docs/docs/features/scheduled-messages.md).

# scheduled messages

Time-based announcements the bot posts on your behalf.

## Schedule kinds

| Kind     | Config                 | Example use                       |
| -------- | ---------------------- | --------------------------------- |
| `once`   | Specific ISO timestamp | Event announcement                |
| `repeat` | Every N minutes        | Hourly reminders, giveaway ticker |
| `weekly` | Day-of-week + time     | "Monday hydration check"          |

## Message payload

Each scheduled message has:

* **Channel** — target text channel.
* **Content** — plain text, up to 2000 chars.
* **Embed** (optional) — same builder as the Embed page.
* **Enabled** toggle — pause without deleting.
* **Optional webhook identity** — post as a custom name + avatar (requires Manage Webhooks on the target channel).

## Runtime

* One-shot messages fire once and mark themselves complete.
* Repeat messages honour their interval to the second.
* Weekly messages fire in the guild's timezone (set in Dashboard → Settings).
* Missing a fire time (bot offline) does NOT backfill — the next scheduled slot fires normally.

## Limits

* Up to **50 scheduled messages** per guild.
* Repeat interval minimum: 5 minutes (prevents spam).