Formular in v0
Verzichten Sie auf Server Actions und Resend. Ein fetch an Formgong reicht.
- Erzeugen Sie den Abschnitt mit dem Prompt unten.
- Prüfen Sie die Header Accept und Content-Type.
- Erfolg erkennen Sie am JSON-Feld success.
- Der Schlüssel bleibt im Frontend.
Prompt
Füge einen Kontaktbereich mit Formular hinzu. Verwende keine Server Actions und kein Resend. Formgong: POST https://formgong.com/submit, access_key fk_your_access_key. Felder name, email, message und verstecktes Honeypot-Feld botcheck. fetch mit Content-Type application/json und Accept: application/json. Erfolg: result.success. Keine Datei-Uploads. Beschriftungen auf Deutsch. 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>
);
}Fertige React-Komponente auf GitHub: github.com/formgong/react-contact-form. MIT-Lizenz: Klicken Sie auf „Use this template“ oder kopieren Sie die Dateien.
React-Paket: npm install @formgong/react (npm: @formgong/react)
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 v0 meist danebenliegt
Bei Formularen schlägt v0 meist eine Server Action oder einen Route Handler in app/api vor, der E-Mails über Resend verschickt. Dieser Code braucht einen API-Schlüssel in Umgebungsvariablen und eine verifizierte Absenderdomain. Der Prompt verlangt stattdessen eine Client-Komponente. Sie sendet per fetch, wartet auf success: true und zeigt die Meldung von Formgong, wenn etwas schiefgeht.
Lassen Sie den Zugriffsschlüssel in der Komponente. Er ist absichtlich öffentlich und braucht keine Umgebungsvariable.
Für Agenten: MCP-Server verbinden
v0: Öffnen Sie das + Menü am Prompt und wählen Sie MCPs. Konfigurieren Sie einen eigenen Server mit der URL unten, wählen Sie Bearer Token und fügen Sie Ihr persönliches Formgong-API-Token ein. OAuth-Rückadressen für v0 sind derzeit in Formgong nicht erlaubt. MCP hilft v0 beim Formularbau; das veröffentlichte Formular sendet direkt an Formgong.
MCP-Einstellungen für v0
URL: https://formgong.com/mcp Authentication: Bearer Token Token: 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
- Prüfen Sie, dass die Komponente mit "use client" beginnt und keine Server Action enthält.
- Veröffentlichen Sie und senden Sie eine Testanfrage von der Live-Seite.
- Suchen Sie die Anfrage im Formgong-Posteingang.
- Stellen Sie sicher, dass für das Formular kein RESEND_API_KEY und kein anderes Secret hinzugefügt wurde.
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
Warum keine Server Action?
Eine Server Action funktioniert auch, aber dann schreiben und pflegen Sie den E-Mail-Teil selbst, mit Schlüsseln und Absenderdomain. Mit Formgong sendet der Browser das Formular direkt, und Speicherung, E-Mail, Telegram und Spamfilter sind schon fertig.
Funktioniert das mit dem Next.js App Router?
Ja. Das Formular ist eine Client-Komponente und funktioniert daher im App Router und im Pages Router. Es braucht keinen Servercode.
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.