Onboarding: Rollenauswahl, Umfrage und Abschluss-Rolle

Das Onboarding führt neue Mitglieder durch einen kurzen, geführten Einstieg: eine persönliche Begrüßung in einem eigenen Kanal, eine Rollenauswahl über deine Role Panels, auf Wunsch eine Beitritts-Umfrage („Wie hast du zu uns gefunden?“) und ein Fertig-Button, der eine Abschluss-Rolle vergibt.

Das Onboarding ist ein eigenes Modul, getrennt von der Willkommensnachricht. Beide können gleichzeitig laufen. Eine kurze Anleitung findest du in den Ratgebern Onboarding-Fragen einrichten und Server-Onboarding.

Voraussetzungen

• Zugriff auf das Modul: Du meldest dich im Dashboard mit Discord an und brauchst das Recht Server verwalten (oder einen für dieses Modul freigegebenen Zugriff).
• Role Panels: Die Rollenauswahl nutzt Panels aus dem Modul Role Panels. Lege sie dort zuerst an. Ohne Panels fehlt die Rollenauswahl.
• Ein Onboarding-Kanal: Neue Mitglieder müssen ihn sehen und darin lesen können, auch wenn sie sonst noch eingeschränkt sind (zum Beispiel wegen der Verifizierung).
• Rechte von Kage im Kanal: Nachrichten senden und Links einbetten.
• Rollenreihenfolge: Kages Rolle muss über der Abschluss-Rolle und über den Rollen der Panels stehen.

So läuft das Onboarding ab

1. Ein Mitglied tritt bei. Kage prüft, ob das Onboarding aktiv ist und ein Kanal gewählt wurde. Sonst passiert nichts.
2. Kage sucht den Kanal. Ist er gelöscht oder nicht erreichbar, steht eine Warnung im Betriebslog.
3. Kage postet im Onboarding-Kanal die Begrüßung mit Erwähnung des Mitglieds.
4. Ist die Beitritts-Umfrage aktiv und hat mindestens eine Antwortoption, folgt die Frage mit einem Auswahlmenü.
5. Danach postet Kage bis zu 5 Role Panels, die du ausgewählt hast, jeweils mit ihren Schaltflächen oder ihrem Auswahlmenü. Panels ohne Rollenoptionen überspringt Kage.
6. Zuletzt folgt der Fertig-Button. Er gehört dem Mitglied, für das er gepostet wurde: Andere erhalten die Meldung „This onboarding prompt isn't for you.“
7. Klickt das Mitglied auf Fertig, vergibt Kage die Abschluss-Rolle (falls gewählt und noch nicht vorhanden), löscht die Fertig-Nachricht und bestätigt dem Mitglied.
8. Beginn und Abschluss erscheinen im Reiter Logs des Moduls.

Die Begrüßung, die Panels und die Umfrage bleiben im Kanal stehen. Die Buttons und das Auswahlmenü funktionieren auch nach einem Neustart des Bots weiter.

Die Beitritts-Umfrage

• Du formulierst die Frage und legst die Antwortoptionen fest (bis zu 25, jede bis 100 Zeichen).
• Ohne mindestens eine Option bleibt die Umfrage inaktiv, selbst wenn sie eingeschaltet ist.
• Jedes Mitglied hat eine Antwort. Wählt es erneut, ersetzt die neue Antwort die alte.
• Die Auswertung siehst du im Dashboard im Abschnitt Ergebnisse.

Die Texte der Schaltfläche („Done ✅“), des Auswahlmenüs und der Bestätigungen sind englisch.

Einstellungen im Überblick

Das Onboarding hat keine Slash-Befehle.

Zusammenspiel beim Beitritt

Kage verarbeitet einen Beitritt in fester Reihenfolge: Einladungs-Zuordnung, Anti-Raid, Willkommensnachricht, Auto-Rollen, Verifizierung, dann Onboarding und Regeln, zuletzt das Rang-System. Sperrt die Verifizierung den Zugang bis zur Bestätigung, achte darauf, dass der Onboarding-Kanal für die Unverified-Rolle sichtbar ist, sonst sehen neue Mitglieder die Begrüßung nicht.

Ergebnis überprüfen

1. Testbeitritt: Tritt mit einem Zweitkonto bei. Im Onboarding-Kanal erscheinen Begrüßung, Umfrage, Panels und der Fertig-Button.
2. Rollenauswahl: Wähle eine Rolle im Panel und prüfe, ob sie vergeben wird.
3. Abschluss: Klicke Fertig. Die Abschluss-Rolle wird vergeben.
4. Auswertung: Die Umfrage-Antwort steht im Dashboard unter Ergebnisse, der Ablauf im Reiter Logs.

Fehlerbehebung

Es erscheint nichts im Kanal

Prüfe, ob „Onboarding aktiv“ an ist und ein Kanal gewählt und gespeichert wurde. Prüfe die Rechte von Kage im Kanal und ob der Kanal noch existiert.

Das Mitglied sieht den Kanal nicht

Der Kanal muss für neue Mitglieder sichtbar sein, auch für die Unverified-Rolle, falls du die Verifizierung nutzt.

Es werden keine Panels gezeigt

Es sind keine Panels ausgewählt, oder die gewählten Panels haben keine Rollenoptionen. Lege sie im Modul Role Panels an und wähle sie unter Role Panels im Onboarding aus. Mehr als 5 Panels zeigt Kage nicht.

Die Umfrage fehlt

Sie ist ausgeschaltet oder hat keine Antwortoption.

Die Abschluss-Rolle wird nicht vergeben

Kages Rolle steht in der Rollenliste unter der Abschluss-Rolle, oder Kage hat das Recht Rollen verwalten nicht. In Discord erscheint dazu keine Meldung.

Weiterführend

Gestalte die Rollenauswahl mit Role Panels. Ein Regelwerk für neue Mitglieder beschreiben Regeln und Verifizierung.