Overview
OverviewStarboardAuto-RespondSticky MessagesMessage EmbedderDashboard UI Guide
DASHBOARD GUIDE

Messaging

Six tools for keeping channels clean and on-script — automatic deletion, scripted replies, message recall, sticky pinned content, scheduled posts and bulk auto-purge.

Path
DashboardMessagesMessaging
Module
messaging
Required permission
messaging.autodelete.view

Before you start

A few quick checks before opening the dashboard.

  • You have the relevant messaging.* capability for the tool you want to use
  • The Messaging module is enabled in Modules
  • The bot has Manage Messages in any channel where it will delete or recall
  • Channels you intend to target exist and the bot can read them

What you'll see

The Messaging dashboard is split into six top-level tabs. Each tab has its own sub-tabs.

Auto delete
Auto responder
Recall
Sticky messages
Auto message
Auto purge
Auto delete
Per-channel TTL policies that delete messages after a set duration.
Auto responder
Trigger-based replies — keywords, exact matches, regex and slash-command-like prefixes.
Recall
Recover edited and deleted messages with audit-grade trail.
Sticky messages
Pinned message that stays at the bottom of a channel.
Auto message
Scheduled or interval-based posts to a channel.
Auto purge
Bulk-delete messages older than a retention window with safety guards.

Auto delete

Per-channel TTL policies. Messages older than the channel's TTL are removed by the bot.

Sub-tabs

ChannelsSettingsAudit

Channels sub-tab

  • Stat tiles show Channels with TTL, Deletions today, Failures and Skipped.
  • The policies table lists each channel that has a policy with its TTL, exclusions and on/off state.
  • Click Add channel to attach a TTL policy to a new channel via the modal.

Per-policy fields

ChannelChannel picker

The text channel the policy applies to.

TTLDuration

How long messages live before the bot deletes them.

Example: 7 days

Exclude pinnedToggle

Pinned messages are kept regardless of TTL.

Exclude botsToggle

Messages from bots are kept.

Exclude webhooksToggle

Webhook posts are kept.

Exclude attachmentsToggle

Messages with files survive deletion.

Exclude linksToggle

Messages containing links survive deletion.

EnabledToggle

Pause a policy without losing it. Quick-toggle in the table.

Settings sub-tab

Master switch for the entire feature, the global Max channels cap, and global exclusions for pinned, bots and webhooks. There is also a Conflicts section that explains how Auto delete interacts with AutoMod and other delete-capable modules.

Audit sub-tab

Read-only feed of every TTL deletion the module performed, with channel, message id, reason and outcome.

Auto responder

Reply automatically when a message matches a trigger.

Sub-tabs

RulesBuilderAnalyticsSettings

Rules sub-tab

  • Stats show Total rules, Active rules, Fires today and Cooldown hits.
  • The table lists every rule with its priority, name, trigger, fire count and on/off state.
  • Click New rule or the pencil icon on a row to open the Builder.

Builder sub-tab

NameText input

Internal label only — members never see it.

Example: welcome-newcomer

Trigger typeDropdown

Message contains, equals, starts with, ends with, regex, or member event (join, etc.).

Trigger valueText input

The keyword, phrase or regex pattern to match against.

PriorityNumber

Lower numbers run first when multiple rules could match.

Reply modeDropdown

Plain text reply, embed, or run a sequence of actions.

CooldownDuration

Minimum gap between consecutive fires per member.

Click Update (or Create for new rules) at the top of the Builder card to save.

Analytics sub-tab

Charts of fires per rule, per channel and over time. Use it to spot rules that are being hit too often or never at all.

Settings sub-tab

Global toggles such as a master switch and rate-limit ceilings. Save changes with the button on the card.

Recall

Recover the original content of edited or deleted messages.

Sub-tabs

ConfigChannelsAudit

Config sub-tab

Open recall
Anyone in the channel can run /recall and see the recovered text.
Redacted open
Anyone can recall, but PII (mentions, links, attachments) is masked unless they have moderator permissions.
Mod only
Only members with the messaging.recall.view capability can use /recall.
Retention deleted (min)Number

How long deleted messages stay recallable.

Example: 60

Retention edited (min)Number

How long an edit history is kept.

Example: 60

Cache max per channelNumber

Maximum cached messages per channel.

Cache max per guildNumber

Total cache cap across the whole server.

Recall cooldown (ms)Number

Minimum gap between /recall calls per member.

Max recalls per minuteNumber

Server-wide rate limit.

The Guards collapsible adds a spam guard and reaction cleanup toggle.

Channels sub-tab

Per-channel overrides — set a channel to DENY (no recall here), SENSITIVE (mod-only) or OPEN (anyone). Click Add override to create one.

Audit sub-tab

Every /recall use is logged with who ran it, against which message, and what was returned. Supports moderation reviews.

Sticky messages

Keep an important message permanently visible at the bottom of a channel.

  • Pick a channel and write the sticky content (plain text, markdown or embed).
  • Whenever a new message is posted, the sticky is removed and re-posted at the bottom of the channel.
  • Toggle a sticky off to keep its content for later without removing it from the dashboard.
  • Stickies skip channels in the auto-delete ignore list and respect bot permission to send messages.

Auto message

Scheduled posts — recurring announcements, daily prompts, or interval-based reminders.

Sub-tabs

LibraryBuilderDeliveriesSettings

Library sub-tab

Stats show Scheduled, Enabled and Sent today. The library lists each scheduled rule with its name, status and last run.

Builder sub-tab

NameText input

Label for the rule.

Example: daily-thread-reminder

ChannelChannel picker

Where the message is posted.

Schedule typeDropdown

Cron, fixed interval, or specific timestamps.

Schedule valueText input

Cron expression or interval (e.g. 6h).

Example: 0 9 * * MON

Message bodyText input

Plain text or embed. Supports template variables.

EnabledToggle

Pause without deleting.

Deliveries sub-tab

Recent deliveries with timestamp, channel, success / failure and any error. Use it to confirm a scheduled post actually went out.

Auto purge

Bulk-delete old messages on a schedule. The most destructive tool in this dashboard — guarded with confirmations and exemptions.

Sub-tabs

PoliciesExemptionsRunsSettings

Policies sub-tab

  • Stats: Total policies, Enabled, Bulk-deleted (30d) and Runs (30d).
  • Each row shows the policy name, retention window (e.g. 30d), schedule, mode and state (Active, Paused).
  • Click Add policy to open the modal and configure a new one.
  • The pause icon temporarily disables a policy; the trash icon deletes it.

Exemptions sub-tab

Add user, role or channel exemptions so an auto-purge policy never touches them. Pick a type, paste the Discord ID, click Add exemption.

Runs sub-tab

Recent runs of every policy with timestamp, deleted count and success state. Use it to confirm a purge actually happened.

Settings sub-tab

Master switch, safety caps and global limits — including the maximum messages any single run is allowed to delete.
Auto purge is irreversible
Deleted messages cannot be recovered through Recall. Always pair Auto purge with a Backups snapshot and review the policy with a second pair of eyes before enabling.

Common tasks

Step-by-step recipes for the work most operators do most often.

1

Set a 7-day TTL on a chatty off-topic channel

Auto-delete is the most common Messaging task.

  • Open DashboardMessagingAuto deleteChannels.

  • Click Add channel.
  • Pick the channel, set TTL to 7 days, leave Exclude pinned on so important pins survive.
  • Confirm — the row appears with an On chip. Deletion runs continuously in the background.
2

Reply automatically to common questions

A simple keyword auto-responder for support channels.

  • Open Auto responder → Rules and click New rule.
  • Set Name to refund-policy, Trigger type to MESSAGE_CONTAINS and Trigger value to refund.
  • In Reply mode, pick Plain text and paste your refund-policy text.
  • Set a Cooldown of 5 minutes per member so the rule does not spam during a heated thread.
  • Click Create. Verify the rule fires by typing a test message in any channel the rule applies to.
3

Schedule a daily standup prompt

Use Auto message to post a recurring prompt at a fixed time.

  • Open Auto message → Builder.
  • Pick the standup channel.
  • Set Schedule type to cron and Schedule value to 0 9 * * MON-FRI (9 a.m. on weekdays).
  • Paste the prompt body. Save.
  • Open the Deliveries sub-tab tomorrow morning to confirm the post landed.

Troubleshooting

Auto delete is not removing messages
Confirm the master switch in Auto delete → Settings is on, the policy is Enabled, and the bot has Manage Messages in the channel. Failures appear in the Failures stat tile and the Audit sub-tab.
An auto-responder fires twice or for the wrong message
Check the rule's Trigger type — MESSAGE_CONTAINS matches anywhere, while MESSAGE_EQUALS requires the exact message. Set a higher Priority on the rule that should win when two rules could both match.
Recall returns 'Message not cached'
The cache is bounded by Cache max per channel and Retention deleted / edited. If the original message was older than those windows, it has been evicted and can no longer be recalled.
Auto purge deleted more than expected
Check Runs for the offending run, and look at the policy's Retention window and Mode. Add the missing user, role or channel to Exemptions, then restore from the most recent Backups snapshot via the Migration module if needed.
Logging
Migration