# ModSignal

**Voice support alerts, done right.**

Pick a waiting voice channel, a staff ping channel, and a staff role. The moment a member joins the waiting room, ModSignal posts a clean alert with **Handled**, **Dismiss**, and **Join voice** buttons. That's the whole product. Everything else is optional.

## Why ModSignal

- **60-second setup.** `/setup support` and you're live.
- **Slash-only.** No prefix clutter.
- **Survives restarts.** Handled and Dismiss buttons keep working after a redeploy, so pending calls never get lost.
- **Invisible until needed.** Bot appears as mobile-online by default, stays out of your staff list's spotlight.

## What's Inside

- Staff alerts when a member joins a configured voice support room
- Persistent **Handled / Dismiss / Join voice** controls
- Escalation to a senior role if nobody handles within your window
- Custom message templates with `{user}`, `{voice}`, `{wait}`, `{staff}`, `{guild}` placeholders
- Up to 3 extra staff ping roles on free, 10 on Premium
- Auto-threads under each alert for private staff coordination
- Confirmation DM to waiting members with the current average wait time
- Cooldowns, alert delay, auto-delete, and a live **`/setup preview`**
- Response time, handle time, claim rate, top-handler leaderboards
- Post-call member feedback with a positive/negative bar chart
- Full **`/dashboard`** overview with 7-day stats
- Call history lookup per member with **`/calls history`**
- English and Deutsch for every member-facing message
- Clean Components v2 layouts across every panel

## Quick Start

```
/setup support
waiting_channel: Support Waiting
ping_channel: staff-pings
staff_role: Support Team
```

Then verify:

```
/calls test
```

Need a hand? `/setup checklist` reports every permission and config issue in one place.

## Commands

**Setup** — `/setup support` · `/setup checklist` · `/setup advanced` · `/setup escalation` · `/setup message` · `/setup preview` · `/setup language` · `/setup autothread` · `/setup dm-member` · `/setup roles` · `/setup enable` · `/setup disable`

**Calls** — `/calls test` · `/calls active` · `/calls recent` · `/calls stats` · `/calls history` · `/calls feedback` · `/calls close`

**Info** — `/dashboard` · `/ping` · `/stats` · `/about` · `/botinfo` · `/invite` · `/support` · `/vote` · `/share` · `/privacy`

## Premium (optional)

ModSignal is fully usable on the free plan. Premium exists so teams who want to support development can unlock extras without hitting paywalls on the core product.

- Up to **10 staff ping roles**
- **Custom alert color** per server
- **Voice counter** — waiting count live in a voice channel name
- **Server-specific bot branding** — nickname, avatar, bio

Activate in seconds with `/premium buy`. Ko-fi monthly membership or one-time lifetime donation, whichever fits.

## Privacy

ModSignal stores only what alerts require: guild ID, channel IDs, role IDs, settings, and call timestamps. Message content is never read. Full policy available via `/privacy`.


ModSignal

Staff alerts for voice support rooms. Ping staff when members wait for help.


为ModSignal投票

你想要支持我们吗？