# GitHub Issues

Öffne bei jeder Einreichung ein GitHub Issue.

## GitHub Issues

Wandle Einreichungen automatisch in GitHub Issues um. Jede Einreichung erstellt ein Issue im Repository deiner Wahl – mit benutzerdefiniertem Titel, Inhalt und Meilenstein.

<h2 id="what-you-get">Was du erhältst</h2>

<ul>
  <li>Ein GitHub Issue pro Einreichung, zugeordnet dem verbindenden Benutzer</li>
  <li>
    Titel und Inhalt werden im Vorlageneditor erstellt — tippe <strong>@</strong>, um einen beliebigen Formularfeldwert einzufügen
  </li>
  <li>Der Inhalt unterstützt GitHub-Flavored Markdown (Fett, Listen, Überschriften, Code-Blöcke, Links)</li>
  <li>Optionaler Standard-Meilenstein, der auf jedes Issue angewendet wird</li>
  <li>
    Test-Schaltfläche, die ein echtes Issue mit dem Präfix <code>[Test]</code> erstellt, damit du vor dem Live-Gang überprüfen kannst
  </li>
</ul>

<h2 id="connect">GitHub verbinden</h2>

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

<p>
  Wenn eine befragte Person dein Formular startet, aber nicht abschließt, kann Formstep ein separates Issue für die teilweise erfassten
  Daten erstellen. Stelle <strong>Abbruch-Ereignis senden nach</strong> auf 12 Stunden, 1 Tag, 3 Tage oder 1 Woche und fülle dann Titel und
  Inhalt des abgebrochenen Issues aus — keins von beiden darf leer bleiben. Abgebrochene Issues erhalten das Label{' '}
  <code>partial-submission</code>, das beim ersten Mal erstellt wird.
</p>

<p>
  Ein stündlicher Durchlauf sucht nach untätigen Entwürfen, sodass das Issue beim ersten Durchlauf nach Ablauf des Fensters erscheint. Nur
  Entwürfe von einem Freigabe-Link werden erfasst, und <strong>Erforderliche Felder</strong> schränkt es weiter ein: Das Issue wird nur
  erstellt, wenn mindestens eines der von dir gewählten Felder ausgefüllt wurde.
</p>

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

<h2 id="tokens">Tokens</h2>

<p>
  GitHub-OAuth-App-Tokens <strong>laufen nicht ab</strong> — es gibt keine Refresh-Token-Rotation. Wenn du die Berechtigung auf der Seite
  der autorisierten OAuth Apps deines GitHub-Kontos widerrufst, schlägt der nächste Versand fehl, Formstep markiert die Zugangsdaten als
  abgelaufen, und du erhältst eine Fehlerbenachrichtigungs-E-Mail. Verbinde dich über die Workspace-Integrationsseite erneut, um die
  Verbindung wiederherzustellen.
</p>

<h2 id="removing">Integration entfernen</h2>

<ul>
  <li>
    <strong>Aus Formstep</strong> — Formulareinstellungen → Integrationen → GitHub Issues → Löschen. Neue Einreichungen erstellen sofort
    keine Issues mehr.
  </li>
  <li>
    <strong>Aus GitHub</strong> — Widerrufe die OAuth-Berechtigung auf der Seite der autorisierten OAuth Apps deines Kontos. Formstep
    widerruft das Token auf seiner Seite nicht automatisch.
  </li>
</ul>

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

<ul>
  <li>Ein Issue pro Einreichung — kein Modus zum Kommentieren bestehender Issues</li>
  <li>Kein Nachfüllen — nur neue Einreichungen erstellen Issues</li>
  <li>Titel ist Klartext, wird nach 256 Zeichen mit einem Auslassungszeichen gekürzt; Inhalt ist nur Markdown</li>
  <li>
    Ein leerer Titel greift auf <code>New submission to &lt;form name&gt;</code> zurück
  </li>
  <li>
    Datei-Upload-Antworten werden als Dateiname gefolgt von ihrem Download-Link dargestellt, sodass die Datei über das Issue erreichbar ist
  </li>
  <li>
    Antworten der befragten Person werden unverändert in den Issue-Inhalt eingefügt — enthält eine Antwort <code>@benutzername</code>,
    benachrichtigt GitHub diese Person, und <code>#123</code> erzeugt eine Issue-Referenz
  </li>
</ul>

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

  <p>
    Drei GitHub-Berechtigungen: <code>repo</code> (Issues erstellen), <code>read:user</code> (dein Konto identifizieren) und{' '}
    <code>read:org</code> (Organisations-Repositories auflisten). Dies ist eine Standard-OAuth-App — keine GitHub-App-Installation
    erforderlich.
  </p>

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

  <p>
    Ja. Öffne das Integrations-Detailblatt und ändere eines der Felder. Beim Wechsel des Repositories wird der Meilenstein zurückgesetzt, da
    Meilensteine repository-spezifisch sind.
  </p>

  <p>
    Die nächste Einreichung schlägt mit einem „nicht gefunden"-Fehler fehl, und die Integration zeigt einen Fehlerstatus an. Bearbeite die
    Integration, um ein anderes Repository auszuwählen.
  </p>

  <p>
    Die Integration wird automatisch pausiert, und eine E-Mail geht an die Person, die sie eingerichtet hat. Ein widerrufenes Token, eine
    verlorene Berechtigung oder ein gelöschtes Repository wartet nicht auf fünf Fehler — die Integration stoppt sofort. So oder so: Behebe
    die Ursache und drücke dann Fortsetzen.
  </p>

<h2 id="next-steps">Nächste Schritte</h2>
<div class="not-prose grid gap-3 sm:grid-cols-2">
  - [Entwicklerübersicht](/de/developers/overview) — REST API, Webhooks und MCP-Server
  - [Pläne & Preise](/de/subscription-billing/plans-pricing) — Free-, Pro- und Business-Funktionen vergleichen
</div>