Docs
Talking to your employee
There are two ways to talk to your employee. Members @mention it in any channel it can see and get answers about your server. You and your staff talk to it in its private channel, where you can ask it anything and have it change rules, act on flags and more, always with your confirmation.
Members: @mention it anywhere
Anyone can @mention your employee in a channel it can see, and it replies right there. It answers from your rules, what it knows about your server and anything you've taught it, and it follows the recent conversation so it knows what's being discussed. It doesn't join a conversation unless it's mentioned.
Good questions for it: "what are the rules on advertising?", "how do I join the PD?" (if you've taught it that), or "where do I report a bug?".
A few things it won't do in public:
- It won't bring up anyone's past flags, warnings or moderation history.
- It won't accuse, scold or make rulings on members, or announce that it's flagging someone. Those judgments go to your staff privately. See How moderation works.
- It can't change anything when asked in public. Rules, settings and actions are only handled in its private channel.
- It answers from the text of the conversation. Images posted in the chat aren't part of what it reads when answering.
You: its private channel
Its private channel is your line to it. Every message there is for your employee, so there's no need to @mention it. It follows the recent conversation, so you can hold a real back-and-forth, and it knows about your recent flags. It's candid there: ask about moderation and it tells you what it knows.
Here's what you can do, with the kind of phrasing that works:
- Ask about the server and recent flags: "anything happen overnight?", "who's been causing trouble this week?"
- Add, edit or remove rules: "add a rule: no selling accounts", "remove rule 8", "change rule 3 to say no NSFW anywhere". See Your rules.
- Act on a recent flag: "warn him", "delete that", "time her out for a day", "kick the scammer", "ban him".
- Dismiss flags: "that one's fine, dismiss it", "clear all of those".
- Teach it facts members can ask about: "remember: whitelist applications open every Friday".
- Calibrate how strict it is: "OOC trash talk is fine here", "you're being too strict about swearing".
- Change your report schedule: "make the daily report weekly", "turn off the vitals report". See Reports and check-ins.
- Refresh its read of the server: "re-read the room", "the vibe has changed, take another look".
Nothing happens until you confirm
Every change or action comes back as a proposal: a short message starting "Want me to do this?" that spells out exactly what will happen, with Confirm and Cancel buttons underneath. Nothing changes until someone clicks Confirm. Cancel drops the proposal.
A re-read is slightly different. It takes a fresh look at your server straight away, then shows you what it found with Confirm and Cancel. Confirming updates its understanding of your server's culture. Your rules and calibrations stay as they are.
Anyone who can see the private channel can click Confirm or Cancel. If a click ever gets the reply "That proposal expired", just ask again and it will propose it again.
Limits on actions
- From the private channel, actions work on your recent flags. It can't warn, time out, kick or ban someone who hasn't been flagged.
- Timeouts default to one hour if you don't say how long, and go up to 28 days.
- Deletes, timeouts, kicks and bans need the matching permission (Manage Messages, Moderate Members, Kick Members, Ban Members). See Permissions.
- It can't act on the server owner, an admin, or anyone whose highest role is at or above its own. Bans only work on members who are still in the server.
- If a timeout, kick or ban can't go through, it tells you why and nothing is recorded.
Before you hire it
While it's still an intern, its private channel is also how you point it at your rules. Paste a link to your rulebook there and it reads from that link and posts a fresh review card. Or post your rules in your rules channel (named like #rules), or pin them, and tell it to "re-read". See Getting started.
Who can use the private channel
The server owner and Administrators can see the channel automatically. Nobody else can until you add them in the channel's own settings in Discord. Anyone who can see it can talk to your employee and click its buttons, including flag cards, so add only people you trust to moderate.
If your employee is off the clock after the trial, or has reached its monthly reading limit, it tells you so here. See The trial, hiring and billing and How moderation works.