Moderation
Outbound webhooks
ModShield does not lock your audit trail inside the bot. Point a URL and receive cases, anti-nuke trips, reports, threats, and watch alerts.
- case · antinuke · report · threat · watch
- Optional HMAC secret
- Async fire-and-forget
- Filter by event list
Why teams turn it on
Your stack, your rules
Forward events into tickets, paging, or SIEM without polling the API.
Signed payloads
Optional shared secret produces X-ModShield-Signature for verification.
Selective
Empty events list = all; or whitelist only the event names you care about.
Safe defaults
Off until you set a URL. Failures log server-side and never block moderation.
How it works
1. Enable + URL
Dashboard → Outbound webhooks. HTTPS recommended.
2. Something fires
A case is written, a report lands, anti-nuke trips, …
3. JSON POST
Body includes event, guild_id, ts, and a data object for that event.
Real situations
Page on-call
Anti-nuke events open a PagerDuty / Slack bridge.
Mirror cases
Every ban/warn streams into an internal audit warehouse.
FAQ
Does it send Discord embeds?
It sends JSON. Use a small adapter if you need Discord-native embeds.