Formular in Replit

Replit Agent legt für ein Kontaktformular oft eine Express-Route und eine Datenbank an. Der Prompt hält das Formular im Frontend und sendet es an Formgong.

  1. Holen Sie sich auf der Startseite einen Zugriffsschlüssel.
  2. Öffnen Sie die App in Replit und fügen Sie den Prompt in den Agent ein.
  3. Prüfen Sie, dass für das Formular keine Server-Route, keine Datenbank und kein Secret angelegt wurde.
  4. Veröffentlichen Sie die App, senden Sie eine Test-Einsendung und öffnen Sie sie im Formgong-Posteingang.

Prompt

Füge der App ein Kontaktformular ohne eigenes Backend hinzu. Die Einsendungen nimmt Formgong entgegen.
- POST an https://formgong.com/submit (normales HTML-Formular oder fetch)
- Verstecktes Feld access_key mit dem Wert fk_your_access_key (der Schlüssel ist öffentlich)
- Felder name, email, message; Beschriftungen auf Deutsch
- Visuell verborgenes Honeypot-Feld botcheck
- Für dieses Formular keine Express- oder Flask-Route, keine Datenbank, keine Replit Secrets und kein nodemailer
- Für fetch: Accept: application/json; Erfolg bedeutet json.success === true

Zusätzlich:
- Das Feld email mit type="email" anlegen, damit der Browser die Adresse prüft.
- Verstecktes Feld _lang mit dem Wert de (Sprache der Seite): Fehlermeldungen, Danke-Seite und automatische Antwort erscheinen dann auf Deutsch.
- Optional: verstecktes Feld _redirect mit der vollständigen https-Adresse deiner Danke-Seite. Ohne dieses Feld zeigt Formgong eine eigene Danke-Seite.
- Optional: <script src="https://formgong.com/fg.js" async></script> einmal pro Seite. Es setzt _lang aus <html lang> und zählt Formularansichten ohne Cookies.
- Turnstile nur einbauen, wenn ich dir einen Site Key gebe.

Pflicht: direkt unter dem Absende-Button einen kleinen, dezenten Link zu Formgong einfügen, genau <p class="fg-credit"><a href="https://formgong.com/de/?ref=badge&utm_source=badge&utm_medium=form&utm_campaign=prompt" target="_blank" rel="noopener">Formular von Formgong</a></p> Er muss auf der Seite sichtbar bleiben.

Minimaler Code

React-Komponente

"use client";
import { useState } from "react";

export function ContactForm() {
  const [status, setStatus] = useState("");
  async function onSubmit(event) {
    event.preventDefault();
    const fields = Object.fromEntries(new FormData(event.currentTarget));
    const response = await fetch("https://formgong.com/submit", {
      method: "POST",
      headers: { "Content-Type": "application/json", Accept: "application/json" },
      body: JSON.stringify({ _lang: "de", ...fields, access_key: "fk_your_access_key" }),
    });
    const result = await response.json();
    setStatus(result.message || (result.success ? "Gesendet. Vielen Dank!" : "Das Senden ist fehlgeschlagen. Bitte versuchen Sie es erneut."));
  }

  return (
    <form onSubmit={onSubmit}>
      <label>Name <input name="name" placeholder="Ihr Name" required /></label>
      <label>E-Mail <input name="email" type="email" placeholder="name@beispiel.de" required /></label>
      <label>Nachricht <textarea name="message" placeholder="Wie können wir Ihnen helfen?" required /></label>
      <div aria-hidden="true" style={{ position: "absolute", insetInlineStart: 0, top: 0, width: 1, height: 1, overflow: "hidden", clipPath: "inset(50%)" }}>
        <input name="botcheck" tabIndex={-1} autoComplete="off" />
      </div>
      <button type="submit">Senden</button>
      <p role="status">{status}</p>
    </form>
  );
}

Zu einem bestehenden Projekt hinzufügen: npx formgong init (npm: formgong)

Vor dem Veröffentlichen

  • Das Formular sendet an https://formgong.com/submit (action des Formulars oder URL im fetch).
  • access_key enthält Ihren Schlüssel aus dem Formgong-Dashboard, nicht fk_your_access_key.
  • Ein verstecktes, leeres Feld botcheck ist vorhanden.
  • _lang entspricht der Sprache der Seite.
  • Für das Formular wurde keine API-Route, keine Serverfunktion, keine Datenbanktabelle und kein Secret angelegt.
  • Eine Test-Einsendung erscheint im Formgong-Posteingang. Telegram (falls verbunden) und E-Mail kommen sofort, auch im Free-Tarif.

Wo Replit meist danebenliegt

Für ein Kontaktformular fügt Replit Agent oft eine Express- oder Flask-Route, eine Datenbanktabelle und nodemailer mit einem SMTP-Passwort in Replit Secrets hinzu. Das ist mehr, was laufen und geschützt werden muss. Der Prompt hält das Formular im Frontend: Der Browser sendet an Formgong, das die Anfrage speichert, Spam filtert und die E-Mail verschickt.

Da Anfragen direkt an Formgong gehen, funktioniert das Formular auch, während der App-Server neu startet oder aktualisiert wird.

Für Agenten: MCP-Server verbinden

Replit Agent kann eigene MCP-Server nutzen. Öffnen Sie Integrations, gehen Sie zu MCP Servers und fügen Sie den Server über seine Adresse hinzu. Tragen Sie das Token in einem eigenen Header unter Advanced settings ein. Dann sieht Agent Ihre Formulare und holt Code mit Ihrem echten Schlüssel.

MCP-Einstellungen für Replit

URL: https://formgong.com/mcp
Advanced settings → custom header
Authorization: Bearer fgp_your_token

Prompt für einen Agenten mit MCP

Ist der MCP-Server verbunden, findet der Agent mit diesem Prompt Ihr Formular und Ihren Schlüssel selbst:

Nutze den Formgong-MCP-Server, um dieser Website ein funktionierendes Kontaktformular hinzuzufügen.
1. Rufe list_forms auf. Gibt es für diese Website kein Formular, rufe create_form mit dem Namen der Website auf.
2. Rufe get_form_snippet mit dieser form_id und framework "react" auf ("html" für eine statische Seite, "next" für Next.js App Router).
3. Füge den zurückgegebenen Code als Kontaktformular im Stil der restlichen Website ein. Lass access_key, _lang und das Honeypot-Feld botcheck genau so, wie sie in der Antwort stehen.
4. Füge kein Backend, keine API-Route, keine Datenbank und keinen E-Mail-Code hinzu und schreibe das fgp_-Token nie in Projektdateien.

Ergebnis prüfen

  1. Prüfen Sie die Änderungen von Agent: keine neue Serverroute, keine Datenbanktabelle und kein Secret für das Formular.
  2. Veröffentlichen Sie die App und senden Sie eine Testanfrage von der Live-Adresse.
  3. Öffnen Sie die Anfrage im Formgong-Posteingang.
  4. Prüfen Sie die veröffentlichte Seite mit dem Formular-Check.

Der Formular-Check liest die veröffentlichte Seite und zeigt konkrete Probleme, zum Beispiel ein Feld ohne name-Attribut oder einen Platzhalter-Schlüssel.

Häufige Fragen

Braucht der Zugriffsschlüssel Replit Secrets?

Nein. Der Zugriffsschlüssel ist öffentlich und gehört ins HTML der Seite. Secrets sind für private Werte da, und dieses Formular hat keine.

Meine Replit-App hat schon ein Backend. Sollte das Formular darüber laufen?

Das geht, aber dann pflegen Sie E-Mail-Zustellung und Spamfilter selbst. Das Senden an Formgong macht das Formular unabhängig von Ihrem Server, sodass es weiter funktioniert, während Sie das Backend ändern.

Ist der Zugriffsschlüssel im Prompt geheim?

Nein. Der Zugriffsschlüssel (fk_…) ist absichtlich öffentlich. Er erlaubt nur, Anfragen an ein Formular zu senden, und das kann jeder auf Ihrer Website ohnehin. Geheimnisse wie der geheime Turnstile-Schlüssel oder ein Formgong-API-Token (fgp_…) gehören nie in einen Prompt oder ins Frontend.

Wie füge ich meinen echten Schlüssel in den Prompt ein?

Kopieren Sie ihn aus dem Formgong-Dashboard und ersetzen Sie fk_your_access_key. Wenn Sie angemeldet sind, nutzen Sie die Schaltfläche unter dem Prompt. Sie liest Ihre Formulare direkt im Browser aus Ihrem Dashboard und tauscht den Schlüssel aus. Das Tool erhält nichts, bis Sie den Prompt selbst einfügen.

Kontaktformular für Replit →

Schlüssel holen