Discord Webhooks (ohne Bot)
Manchmal willst du keinen Bot im Server haben oder hast einen Server, in dem du selbst kein Admin bist. Dann nimmst du die Pure-Webhook-Variante. Das ist eine komplett separate Funktion von der Bot-OAuth-Verbindung — beide können parallel existieren, dazu unten mehr.
Einrichten
- In Discord: Server-Settings → Integrations → Webhooks → New Webhook.
- Channel auswählen, Webhook-URL kopieren (die lange
https://discord.com/api/webhooks/...-URL). - Im Chatlix-Dashboard unter Discord → Webhooks auf Webhook hinzufügen.
- Webhook-URL einfügen, Label vergeben (z.B. "Stream-Alerts" oder "Giveaways").
- Speichern.
Chatlix verschlüsselt die Webhook-URL in der Datenbank (Spalte webhook_url_ciphertext + Nonce) — im Dashboard siehst du nur das Label, nie die URL im Klartext. Es gibt einen "Bearbeiten"-Button (aktualisiert denselben Datenbank-Eintrag statt löschen+neu anzulegen) — da die gespeicherte URL nicht entschlüsselt angezeigt wird, musst du beim Bearbeiten aber die komplette Webhook-URL erneut einfügen (nicht nur das Label ändern).
Was über einen Webhook läuft
Ein Pure-Webhook ist ein reiner Nachrichten-Ausgang — er kann nicht auf bestimmte Event-Purposes gemappt werden wie beim Bot (dort wählst du "dieser Channel bekommt Stream-Alerts, jener bekommt Giveaways"). Für unterschiedliche Event-Typen in unterschiedliche Channels brauchst du entsprechend mehrere Webhooks (einen pro Discord-Channel), und ordnest im Dashboard jedem Label die passende Rolle zu.
Bot vs. Webhook — wann welches?
| Frage | Bot | Webhook |
|---|---|---|
| Mehrere Channels mit unterschiedlichen Purposes (Stream-Alerts, Raids, Shoutouts, …)? | ein Setup, Dropdown pro Purpose | mühsam — 1 Webhook pro Channel, keine eingebaute Purpose-Logik |
| Discord-Rollen syncen? | technisch nur mit Bot möglich (Berechtigung "Manage Roles") | nein, geht generell nicht |
| Automatisch tatsächlich Rollen vergeben? | aktuell bei keinem der beiden Wege live — siehe Rollen syncen | |
| Test-Post-Button im Dashboard? | ja | ja |
| Server-Admin nötig? | ja (für den Bot-Invite) | nein — reicht die "Webhooks verwalten"-Permission im Ziel-Channel |
| Rate-Limit | Bot-global 50 req/s (Discord-Seite) | Channel-spezifisch, ca. 5 Posts / 2s (Discord-Seite) |
Bot UND Webhook gleichzeitig?
Technisch ja — aber Vorsicht: wenn du für denselben Zweck (z.B. Stream-Alerts) sowohl ein Bot-Channel-Mapping als auch einen Webhook eingerichtet hast, feuern beide und du bekommst die Nachricht doppelt im Channel. Das ist der häufigste "Bot postet doppelt"-Fall, siehe Troubleshooting.
Test
Bei jedem Webhook gibt es einen Test-Post-Button. Wenn der Test ankommt, ist die Webhook valide. Wenn Discord 401 zurückgibt, ist die URL falsch (Webhook wurde in Discord gelöscht oder resettet).
Webhook ersetzen
Discord rotiert Webhook-URLs nicht automatisch. Wenn du die URL leakst (z.B. in einem Screenshot mit sichtbarer Adresszeile), in Discord:
- Server-Settings → Integrations → Webhooks → den betreffenden Webhook → Reset Webhook URL.
- Alten Eintrag in Chatlix löschen, neue URL als neuen Eintrag anlegen.