# Discord

Poste jede Formulareinreichung mit Erwähnungen in einem Discord-Kanal.

## Discord

Poste jede Formulareinreichung in einem Discord-Kanal — erwähne Nutzer und Rollen, füge Feldwerte ein und benachrichtige dein Team in Echtzeit.

<h2 id="overview">Übersicht</h2>

<p>
  Die Discord-Integration postet Einreichungen, sobald sie eingehen, in einen Kanal. Stelle die Nachricht mit eingebetteten Erwähnungen von
  Formularfeldern, Discord-Nutzern und Rollen zusammen.
</p>

<p>
  Formstep verbindet sich per OAuth als Bot — keine Webhook-URLs zum Kopieren, keine IDs zum Einfügen. Sobald der Bot in deinem Server ist,
  kannst du jeden Text- oder Ankündigungskanal auswählen, auf den er Zugriff hat.
</p>

> ℹ️ **Benachrichtigungen, kein Archiv**
> <p>
>     Nur neue Einreichungen werden gepostet, nachdem die Integration aktiv ist. Für historische Daten nutze{' '}
>     <a href="/de/integrations/google-sheets">Google Sheets</a> oder <a href="/de/integrations/notion">Notion</a>.
>   </p>

<h2 id="set-up-discord">Discord einrichten</h2>

<h2 id="features">Funktionen</h2>

<ul>
  <li>
    <strong>Kanalauswahl</strong> — Text- und Ankündigungskanäle, gruppiert nach Discord-Kategorie.
  </li>
  <li>
    <strong>Nutzer- und Rollenerwähnungen</strong> — Erwähne Nutzer oder Rollen, damit die richtigen Personen benachrichtigt werden.
    <code>@everyone</code> und <code>@here</code> werden nicht unterstützt (siehe FAQ).
  </li>
  <li>
    <strong>Formatierung</strong> — Fett, Kursiv, Durchgestrichen, Inline-Code und Links werden als Discord-Markdown übernommen.
    Unterstrichen nicht; Discord kennt kein Unterstrichen.
  </li>
  <li>
    <strong>Testnachricht</strong> — Sende eine Beispielnachricht mit Platzhalterdaten, um deine Einrichtung zu überprüfen.
  </li>
</ul>

<h2 id="limits">Einschränkungen</h2>

<ul>
  <li>
    <strong>Nachrichteninhalt:</strong> 2.000 Zeichen (bei Überschreitung mit Auslassungspunkten gekürzt)
  </li>
  <li>
    <strong>Erwähnungen:</strong> nur Nutzer und Rollen — <code>@everyone</code> und <code>@here</code> werden nicht unterstützt
  </li>
  <li>
    <strong>Kanäle:</strong> nur Text- und Ankündigungskanäle — Formstep schließt Sprach-, Bühnen-, Forum- und Thread-Kanäle aus
  </li>
</ul>

<h2 id="bot-permissions">Bot-Berechtigungen</h2>

<p>Formstep fordert nur die Berechtigungen an, die zum Zustellen von Nachrichten erforderlich sind.</p>

<p>
  <strong>Der Bot benötigt:</strong>
</p>
<ul>
  <li>Kanäle anzeigen</li>
  <li>Nachrichten senden</li>
  <li>Nachrichten in Threads senden</li>
  <li>Öffentliche Threads erstellen</li>
  <li>Links einbetten</li>
</ul>

<p>
  <strong>Der Bot fordert nicht an:</strong>
</p>
<ul>
  <li>Alle erwähnen</li>
  <li>Nachrichtenverlauf lesen</li>
  <li>Administrator</li>
  <li>Nachrichten oder Kanäle verwalten</li>
</ul>

> 💡 **Bot auf einen Kanal beschränken**
> <p>
>     Beschränke den Bot auf einen einzelnen Kanal, indem du die Kanal-Berechtigungsüberschreibungen in Discord für die Formstep-Bot-Rolle
>     anpasst.
>   </p>

<h2 id="abandoned-responses">Ereignisse bei abgebrochenen Antworten</h2>

<p>
  Wenn eine befragte Person dein Formular beginnt, aber nicht abschließt, kann Formstep eine separate Nachricht posten. Stelle{' '}
  <strong>Abbruch-Ereignis senden nach</strong> auf 12 Stunden, 1 Tag, 3 Tage oder 1 Woche und verfasse eine eigene{' '}
  <strong>Abgebrochene Nachricht</strong> — sie kann nicht leer bleiben. <strong>Erforderliche Felder</strong> schränkt sie weiter ein: Die
  Nachricht wird nur ausgelöst, wenn mindestens eines der von dir gewählten Felder ausgefüllt wurde.
</p>

<p>
  Ein Durchlauf läuft jede Stunde, sodass die Nachricht beim ersten Durchlauf nach Ablauf des Leerlauffensters ankommt. Nur Entwürfe von
  einem Freigabe-Link werden erfasst — die empfangende Person einer <a href="/de/requests/overview">Anfrage</a>, die sich nicht mehr meldet,
  wird stattdessen von den eigenen Erinnerungen der Anfrage verfolgt.
</p>

> ℹ️ **Pro-Funktion**
> <p>
>     Die Zustellung bei abgebrochenen Antworten erfordert einen Pro- oder Business-Plan. Die grundlegende Discord-Integration ist in allen
>     Plänen verfügbar. Siehe <a href="/de/subscription-billing/plans-pricing">Pläne & Preise</a>.
>   </p>

<h2 id="faq">FAQ</h2>

  <p>
    Klicke während der Einrichtung auf <strong>Bot einladen</strong>. Wähle den Zielserver, bestätige die Berechtigungen und kehre dann zu
    Formstep zurück und aktualisiere die Serverliste.
  </p>

  <p>Häufige Ursachen:</p>
  <ul>
    <li>Der Bot wurde vom Server entfernt</li>
    <li>Der Zielkanal wurde gelöscht</li>
    <li>Die Bot-Berechtigungen für diesen Kanal wurden entzogen</li>
    <li>Die OAuth-Verbindung wurde widerrufen</li>
  </ul>
  <p>
    Wenn die Integration in einen Fehlerzustand wechselt, erhält die Person, die sie eingerichtet hat, eine Benachrichtigungs-E-Mail.
    Verbinde die Integration neu oder lösche sie und erstelle sie neu. Das Ereignisprotokoll im Detailblatt zeigt den genauen Fehler.
  </p>

  <p>
    Nein. Formstep fordert die Berechtigung „Alle erwähnen" nicht an, und implizite Erwähnungen sind auf API-Ebene deaktiviert. Verwende
    stattdessen eine Rollenerwähnung für breite Benachrichtigungen.
  </p>

  <p>Server und Kanal sind nach der Erstellung festgelegt. Lösche die Integration und erstelle eine neue, die auf den neuen Kanal zeigt.</p>

  <p>
    Ja. Jede Integration zielt auf einen Server und einen Kanal ab. Um an mehrere Server zu posten, erstelle mehrere Discord-Integrationen
    für dasselbe Formular.
  </p>

  <p>
    Ja. Discord-Verbindungen sind workspace-weit gültig. Jedes Workspace-Mitglied kann jedes verbundene Discord-Konto beim Einrichten einer
    Integration verwenden.
  </p>

  <p>
    Nein. Nur neue Einreichungen werden gepostet, nachdem die Integration aktiv ist. Für historische Daten nutze{' '}
    <a href="/de/integrations/google-sheets">Google Sheets</a> oder <a href="/de/integrations/notion">Notion</a>.
  </p>

  <p>
    Gehe zu Formulareinstellungen → Integrationen → Discord und lösche die Integration. Um den Bot auch von deinem Discord-Server zu
    entfernen, gehe in Discord zu Servereinstellungen → Integrationen und entferne Formstep.
  </p>

  <p>
    Ja, nach etwa 7 Tagen. Formstep erneuert sie direkt vor jeder Zustellung statt nach dem täglichen Zeitplan, den andere Anbieter nutzen.
    Schlägt die Erneuerung fehl — die Verbindung wurde widerrufen, oder der Bot wurde entfernt —, wird die Verbindung als abgelaufen
    markiert, und jede Integration, die sie nutzt, stoppt mit einem Fehler. Drücke Erneut verbinden, um sie alle auf einmal
    wiederherzustellen.
  </p>

<h2 id="next-steps">Nächste Schritte</h2>
<div class="not-prose grid gap-3 sm:grid-cols-2">
  - [Webhooks](/de/integrations/webhooks) — Signiertes JSON per POST an eine beliebige URL senden
  - [Airtable](/de/integrations/airtable) — Einreichungen in eine Airtable-Base übertragen
</div>
