Scheduled Messages

Create automated messages that fire on a schedule, either once at a specific time or repeating on an interval. Scheduled Messages use the Message Builder for rich formatting and can target channels, specific users via DM, or role-based audiences.

How It Works

InfiniTea evaluates all enabled schedules every 60 seconds. When a schedule's configured time arrives, the bot sends the associated Message Builder template to the configured targets (channel, DMs, or both).

Setup

Mode

Choose between two scheduling modes:

• One-time: Fires once at a specific date and time, then becomes inactive.
• Repeating: Fires on a recurring interval with optional day-of-week filtering and start/end boundaries.

Timezone

All schedule times are interpreted in your selected timezone. If no timezone is set, UTC is used by default.

Targets

Each schedule needs at least one target:

• Channel: The message is posted to the selected text channel.
• Direct Users: Up to 25 specific users receive the message as a DM.
• Role Targets: Up to 5 roles whose members receive DMs.

Repeating schedules that target DMs must have an interval of at least 24 hours to prevent spam.

Schedule Configuration

One-time schedules:

• Set a specific Run At date and time.

Repeating schedules:

• Set the repeat interval (minutes, hours, or days).
• Optionally restrict to specific days of the week.
• Set a start time for when repeating begins.
• Optionally set an end time to stop the schedule automatically.

Message Content

Each schedule links to a Message Builder configuration. Use the Message Builder to create rich embed messages with formatting, images, and variable support.

Use Cases

• Daily announcements: Post a recurring reminder in an announcements channel every morning.
• Weekly event notices: Notify role members about weekly events on specific days.
• One-time launches: Schedule a product launch or event announcement for a precise time.
• Shift handoff DMs: DM moderators at shift change times with handoff information.

Permissions

Scheduled Messages requires InfiniTea to have Send Messages permission in target channels. For DMs, users must have DMs enabled from server members.