Skip to content

Translate ModMail.md #66

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
106 changes: 106 additions & 0 deletions i18n/de/docusaurus-plugin-content-docs/current/modmail.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,106 @@
# Wie du deinen Modmail-Bot einrichtest

Richte den weltweit fortgeschrittensten Modmail-Bot ein und das in nur ein paar Minuten!

<IncludedInPlan data={{PRO: true, ACTIVE_GUILD: true, STARTER: false}} additionalDetails={{
ACTIVE_GUILD: "24/7 verfügbar, solange dein Plan aktiv ist.",
PRO: "24/7 verfügbar, solange dein Plan aktiv ist."}} />

## 0. Bevor du loslegst {#step-0}

Bevor du deinen eigenen Modmail-Bot auf SCNX erstellen kannst, stelle sicher, dass

* du [deinen Server zu SCNX hinzugefügt hast](./setup).
* dein Server einen bezahlten [Aktiven Server Plan](./scnx/guilds/plans) (<PlanPrice plan="ACTIVE_GUILD" type="MONTHLY"/>)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

outdated plans

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you give me the new type? (Plan="?") or the whole block from new documents?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please check original document for details

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should I include both plans?
-> and idk how to add this to the document :/

oder den [PRO](./scnx/guilds/plans) (<PlanPrice plan="PRO" type="MONTHLY"/>) Plan besitzt oder du die Testphase verwendest, sofern diese
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

outdated plan

für dich verfügbar ist.
* du der Inhaber des Servers bist, in dem du diese Funktion aktivieren willst ([warum?](./scnx/guilds/trusted-admins#troubleshooting)) - falls du nicht der Inhaber des Servers bist, frage bitte den Inhaber,
diese Funktion zu aktivieren und dir Zugriff als [Trusted Admin](./scnx/guilds/trusted-admins) zu geben.
* du ein paar Minuten Zeit hast (es sollte ca. 2 Minuten dauern) um diese Anleitung zu beenden - hör nicht in der Mitte auf; dein Fortschritt wird nicht gespeichert.

## 1. Erstelle deine Discord-Anwendung & -Bot 🤖 {#step-1}

:::caution
Verwende **keinen** bereits existierenden Bot. Du benötigst eine neue Anwendung für deinen Modmail-Bot auf SCNX. SCNX unterstützt es nicht,
mehrere Bots (wie den Discord-Bot und den Modmail-Bot oder auch Tokens von Bots aus anderen Unternehmen, wie txadmin) mit demselben Token / mit der gleichen Anwendung zu verwenden -
Bitte erstelle für jeden Bot eine neue Anwendung.
:::

Als Erstes öffnest du das [Discord Developer Portal](https://discord.com/developers/applications). Dort kannst du eine neue Anwendung erstellen, indem du auf
"Neue Anwendung" oben rechts in deinem Developer-Portal klickst. Nun wird sich ein Fenster öffnen. Gib den Namen, wie der Bot später heißen soll an (du kannst ihn aber jederzeit später ändern),
Lese und akzeptiere die [Discord Developer Terms of Service](https://discord.com/developers/docs/policies-and-agreements/terms-of-service)
und die [Discord Developer Policy](https://discord.com/developers/docs/policies-and-agreements/developer-policy) (diese Richtlinien gelten auch für deine Nutzung
der Discord API als Teil von SCNX) und erstelle den Bot, indem du auf "Erstellen" klickst.

![](@site/docs/assets/setup/custom-Bot-1.png)

Als Nächstes öffnest du die "Bot"-Einstellungen in der Navigation-Bar auf der linken Seite.
Dort kannst du den Avatar und den Benutzernamen einstellen – das musst du nicht, denn das [geht auch direkt bei SCNX](./scnx/guilds/Bots#change-profile); bei Erstellung deines Bots werden wir dich auch dazu auffordern, dies zu tun.
Der letzte Schritt im Discord Developer Portal ist einen Token zu generieren und diesen zu kopieren. Um dies zu tun, öffne die "Bot" Seite in der Navigation-Bar auf der linken Seite
und klicke auf "Token zurücksetzen" und bestätige deine Anfrage in dem Fenster, das sich gerade geöffnet hat. Es kann sein, dass du nach dem 2FA-Code für deinen Discord-Account gefragt wirst.

Wenn dies fertig ist, **kopiere bitte den Token von deinem Bot**. Du wirst ihn gleich benötigen.

![](@site/docs/assets/setup/custom-Bot-3.png)

:::danger
Füge deinen Token **nur** im Dashboard ein. Sende **niemals** deinen Token an einen anderen Nutzer, Trusted-Admin oder an einen unserer Team-Mitglieder.
Dein Token ist wie ein Passwort - Nutzer können mit deinem Bot alles machen, wenn sie den Token haben. Falls du deinen Token doch aus Versehen weitergegeben hast, setze **sofort**
den Token im Developer Portal zurück.
:::

## 2. Erstelle deinen Modmail-Bot auf SCNX 🚀 {#step-2}

Öffne das [SCNX Dashboard](https://scnx.app/user/guilds/) und wähle den Server aus, für den du den Modmail-Bot erstellen willst. Als Nächstes
wähle "Modmail" in der Seitenleiste aus. Du wirst ein Tutorial finden, wie man den Discord Bot erstellen sollte. Wenn du dieser Anleitung gefolgt bist,
kannst du das Video überspringen, indem du auf den "Ich habe einen Bot erstellt"-Button klickst.

![](@site/docs/assets/setup/modmail-1.png)

Als Nächstes wirst du dazu aufgefordert, den Token einzugeben, den du in Schritt 1 erhalten hast.
Füge deinen Token dort ein und klicke auf "Prüfe meinen Token & erstelle den Bot". SCNX wird deinen Token überprüfen und dich zum nächsten Schritt weiterleiten,
falls der Token gültig ist.

![](@site/docs/assets/setup/modmail-2.png)

Nun kannst du ein paar Standardeinstellungen vornehmen. Als Erstes musst du eine Kategorie auswählen, in welcher dein Modmail-Bot später Tickets erstellen soll
(du kannst dieses später ändern).
Die Rechte des Discord-Kanals werden mit der Kategorie synchronisiert. Wenn du damit fertig bist, musst du einen Log-Kanal auswählen. Logs von geschlossenen Tickets werden
in diesen Kanal zusammen mit wichtigen Informationen gesendet.
Wenn du diese beiden Sachen eingestellt hast, klicke auf "Modmail-Bot erstellen".

![](@site/docs/assets/setup/modmail-3.png)

SCNX wird nun die Verwaltung für deinen Modmail-Bot einstellen
und deinen Discord Bot automatisch einstellen.
![](@site/docs/assets/setup/modmail-4.png)

Nachdem SCNX deinen Modmail-Bot eingestellt hat, musst du deinen Modmail-Bot auf deinen Server einladen. Um dies zu tun, musst du nur auf
den "Füge den Bot zu deinem Discord Server hinzu"-Knopf. Dies wird ein Fenster öffnen. SCNX hat bereits deinen Server ausgewählt. Klicke einfach auf "Weiter" und
"Autorisieren" um den Prozess fertigzustellen. Wenn du möchtest, kannst du die "Administrator" Berechtigung entfernen, aber dies wird es schwieriger machen,
den Bot normal zu nutzen, da SCNX noch nicht zeigen kann, welche Funktion welche Berechtigung benötigt und Fehler, die auf fehlende Berechtigungen zurückzuführen sind, zu erkennen.

![](@site/docs/assets/setup/modmail-5.png)

Wenn dies erledigt ist, ist dein Modmail-Bot vollkomend auf SCNX einsatzbereit. Kehre zu der Einrichtung zurück, um das Profil mit dem "Profil bearbeiten"-Button zu bearbeiten.
([du kannst dies auch später machen](./scnx/guilds/Bots#change-profile)), stelle deinen neuen Modmail-Bot ein oder erkunde alle Funktionen deines Modmail-Bots.

![](@site/docs/assets/setup/modmail-6.png)

:::tip Werden Fehler angezeigt?
Wir haben eine [Anleitung zur Fehlerbehebung für Modmail-Bots](./modmail/troubleshooting) für dich erstellt. Wenn diese Anleitung zur Fehlerbehebung nichts bringt,
helfen wir dir jederzeit hier: [scnx.app/help](https://scnx.app/help).
:::

## 3. Genieße deinen neuen Modmail-Bot🎉 {#done}

Wenn du alles richtig gemacht hast, sollte dein Modmail-Bot jetzt online auf Discord sein. Dafür kannst du dir jetzt mal auf die Schulter klopfen 💪. Du hast gute Arbeit geleistet und kannst
nun das Universum eines hoch fortschrittlichen und voll anpassbaren Modmail-Bot für deine Community erkunden - es ist nicht nur ein Modmail-Bot,
es ist DEIN Modmail-Bot[.](https://cdn.scderox.de/IUopj39jjiOPASDioh/7xpodw.jpg)

Hier sind ein paar Dinge, die du jetzt tun könntest:

* Teste deinen Modmail-Bot: Sende ihm eine Privatnachricht und beobachte, wie er ein Ticket öffnet, in dem dein Team mit dir schreiben kann.
* [stelle deinen Modmail-Bot ein](./modmail/configuration) und aktiviere mehr Modmail-Funktionen.
* Verbessere dein Support System, indem du [fortgeschritte Modmail-Funktionen](./modmail/advanced-features) erkundest.
* und sehr viel mehr. Öffne die [Modmail-Documentation](./modmail/intro), um dir jede Option anzuschauen.