Documentation
Schedules, live & welcomes
Scheduled summaries
A schedule runs a summary on its own, daily or on a chosen weekday, and delivers it to your DMs or into a channel.
Build a daily or weekly schedule to check the options and minimum plan before setting it up in Discord.
/schedule add every:Every day at:09:00The hour is in your timezone once you've set one with /settings.
- deliverdefault: DM
- To your DMs is private, needs no permissions, and is nobody else’s business. To a channel is public and needs Manage Server.
- sourcedefault: this channel
- Which channel it summarizes.
- server_widedefault: off
- Summarize the whole readable server instead of one channel. Pro and Scale.
- tierdefault: Fast
- Which quality runs it. Higher quality costs more per run, every run, forever — this is the setting to think twice about.
- max_creditsdefault: 3,000
- The standing cap for one run. See below.
| Plan | Schedules | Server-wide schedules |
|---|---|---|
| Free trial | — | — |
| Starter | 1 | — |
| Pro | 5 | Yes |
| Scale | 25 | Yes |
Why Starter includes exactly one
/schedule list shows what’s set up here, /schedule off stops one, and /schedule run runs one immediately so you can see what it produces before committing to it every morning. That last one is worth doing once.
Live channel summaries
/live on keeps a single message current in a busy channel. Rather than posting a new summary every hour, it edits the same one as the conversation builds.
/live on channel:#general messages:100It updates when enough new messages have arrived — not on a timer. The bot counts messages as they come in rather than polling Discord, so a channel that goes quiet costs nothing at all.
- messagesdefault: 50
- New messages needed before it refreshes, between 25 and 500. Pro’s floor is 50; Scale’s is 25.
- post_todefault: the source channel
- Where the single live message lives. Pointing it at a quieter channel is often nicer.
- Minimum gap15 minutes
- Even in a firehose, it will not update more than once every 15 minutes.
| Plan | Live channels | Message floor |
|---|---|---|
| Free trial | — | — |
| Starter | — | — |
| Pro | 1 | 50 |
| Scale | 5 | 25 |
A live channel is a standing bill
messages:25 will update far more often — and cost far more — than the same channel at messages:200./live status lists what’s running. Both on and off need Manage Server.
Welcome summaries
On Pro and Scale, a new member can get a short DM bringing them up to speed — drawn only from sources both that member and the bot can read. Welcomes wait for membership screening to finish; without screening, they are considered on join.
Run /admin welcome to review the private management panel, then explicitly enable or disable the feature. It is off by default. Daily allowances are 25 admitted slots on Pro and 100 on Scale, resetting at midnight UTC. Slots are not confirmed deliveries, and welcomes also spend shared server credits.
A member can opt out everywhere with /privacy welcome receive:false, run in a server. Quiet conversations, access restrictions, or DM settings can mean no welcome arrives.
The new-member welcome setup guide covers source selection, per-welcome credit limits, defaults, and missing-DM checks. This is separate from the setup message sent to the person who installs the bot.
Standing credit caps
A person running /catchup can be asked “this costs 8,000 credits, continue?”. A schedule firing at 09:00 has nobody at the keyboard, so it uses a standing cap you agree to in advance instead.
- max_creditsdefault: 3,000
- The most one scheduled run may spend. From 3,000 to 100,000. You confirm the cap once, when you set the schedule up.
- If a run would cost more
- It doesn’t skip and it doesn’t overspend. It keeps the newest messages that fit inside the cap and summarizes those, so you still get the most recent context.
- Higher quality needs a higher cap
- Deep starts at 800 credits per run before it reads anything. If your cap is below a tier’s minimum, the bot refuses at setup time and tells you the number to use — it will not accept a schedule that could never run.
When an automatic run fails
For scheduled summaries, these are the main failure and recovery paths:
- Out of credits, plan downgraded, or channel blocked — the schedule stops immediately and says so. It does not keep silently failing every morning.
- Nothing to summarize is the one silent case. A quiet day produces no DM rather than a message telling you the channel was quiet.
- Delivery failed after the work was done — you get told exactly what was spent and what’s left, and it will not retry on its own. Usually the destination lost Send Messages or Embed Links.
If a schedule stopped and you want to know why, /schedule list shows its current state, and any error the bot showed you carries a code you can look up in Troubleshooting.
New-member welcomes have different delivery behavior. Use the welcome troubleshooting steps; a completed generation can use credits even if the DM cannot be delivered.