v0'da form
Server Actions ve Resend kullanmayın. Formgong'a fetch yeter.
- Bölümü aşağıdaki promptla üretin.
- Accept ve Content-Type başlıklarını kontrol edin.
- Başarı JSON success alanıdır.
- Anahtarı frontend'de bırakın.
Prompt
İletişim bölümü ekle. Server Actions veya Resend kullanma. Formgong: POST https://formgong.com/submit, access_key fk_your_access_key. Alanlar: name, email, message, gizli botcheck. fetch: Content-Type application/json ve Accept: application/json. Başarı: result.success. Dosya yok. Ayrıca: - email alanını type="email" yap, böylece tarayıcı adresi kontrol eder. - Değeri tr olan gizli _lang alanı (sayfanın dili): hata mesajları, teşekkür sayfası ve otomatik yanıt Türkçe olur. - İsteğe bağlı: teşekkür sayfanızın tam https adresini taşıyan gizli _redirect alanı. Yoksa Formgong kendi teşekkür sayfasını gösterir. - İsteğe bağlı: sayfaya bir kez <script src="https://formgong.com/fg.js" async></script>. _lang alanını <html lang> değerinden doldurur ve form görüntülemelerini çerezsiz sayar. - Turnstile'ı yalnızca site key verirsem ekle. Zorunlu: gönder düğmesinin hemen altına Formgong'a küçük, soluk bir bağlantı ekle, tam olarak <p class="fg-credit"><a href="https://formgong.com/tr/?ref=badge&utm_source=badge&utm_medium=form&utm_campaign=prompt" target="_blank" rel="noopener">Formgong ile yapıldı</a></p> Sayfada görünür kalsın.
En kısa kod
React bileşeni
"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: "tr", ...fields, access_key: "fk_your_access_key" }),
});
const result = await response.json();
setStatus(result.message || (result.success ? "Gönderildi. Teşekkürler!" : "Gönderilemedi. Lütfen tekrar deneyin."));
}
return (
<form onSubmit={onSubmit}>
<label>Ad <input name="name" placeholder="Adınız" required /></label>
<label>E-posta <input name="email" type="email" placeholder="siz@ornek.com" required /></label>
<label>Mesaj <textarea name="message" placeholder="Size nasıl yardımcı olabiliriz?" 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">Gönder</button>
<p role="status">{status}</p>
</form>
);
}GitHub'da hazır React bileşeni: github.com/formgong/react-contact-form. MIT lisansı: “Use this template” düğmesine tıklayın veya dosyaları kopyalayın.
React paketi: npm install @formgong/react (npm: @formgong/react)
Yayınlamadan önce
- Form https://formgong.com/submit adresine gönderiyor (form action'ı veya fetch URL'si).
- access_key alanında fk_your_access_key değil, Formgong panelindeki anahtarınız var.
- Gizli ve boş bir botcheck alanı var.
- _lang sayfanın diliyle aynı.
- Form için API route, sunucu fonksiyonu, veritabanı tablosu veya secret eklenmedi.
- Test başvurusu Formgong gelen kutusunda görünür. Telegram (bağlıysa) ve e-posta anında gelir, Free’de de.
v0 genellikle nerede hata yapar
Formlar için v0 genellikle Resend ile e-posta gönderen bir Server Action ya da app/api içinde bir route handler önerir. Bu kod, ortam değişkenlerinde bir API anahtarı ve doğrulanmış bir gönderen alan adı gerektirir. Prompt bunun yerine v0'dan istemci tarafı bir bileşen ister. Bileşen verileri fetch ile gönderir, success: true bekler ve bir şeyler ters giderse Formgong'un mesajını gösterir.
Erişim anahtarını bileşenin içinde tutun. Tasarım gereği herkese açıktır, bu yüzden ortam değişkenine ihtiyaç duymaz.
Ajanlar için: MCP sunucusunu bağlayın
v0: prompt yanındaki + menüsünden MCPs seçin. Aşağıdaki URL ile özel sunucu ekleyin, Bearer Token seçip kişisel Formgong API tokenınızı yapıştırın. v0 OAuth geri dönüş adresleri Formgong’da şu anda izinli değildir. MCP v0’ın formu oluşturmasına yardım eder; yayımlanan form başvuruları doğrudan Formgong’a gönderir.
v0 için MCP ayarları
URL: https://formgong.com/mcp Authentication: Bearer Token Token: fgp_your_token
MCP'li ajan için prompt
MCP sunucusu bağlıyken bu promptla ajan formunuzu ve anahtarınızı kendisi bulur:
Bu siteye çalışan bir iletişim formu eklemek için Formgong MCP sunucusunu kullan. 1. list_forms çağır. Bu site için form yoksa site adıyla create_form çağır. 2. Bu form_id ve framework "react" ile get_form_snippet çağır (statik sayfa için "html", Next.js App Router için "next"). 3. Dönen kodu sitenin geri kalanının stilinde bir iletişim formu olarak ekle. access_key, _lang ve botcheck honeypot alanını yanıttaki gibi aynen bırak. 4. Backend, API route, veritabanı ya da e-posta kodu ekleme ve fgp_ token'ını asla proje dosyalarına yazma.
Sonucu kontrol edin
- Bileşenin "use client" ile başladığını ve Server Action içermediğini kontrol edin.
- Siteyi yayınlayın ve canlı sayfadan bir test gönderimi yapın.
- Gönderimi Formgong gelen kutusunda bulun.
- Form için RESEND_API_KEY ya da başka bir gizli anahtar eklenmediğinden emin olun.
Form denetleyicisi yayınlanan sayfayı okur ve name niteliği olmayan bir alan ya da yer tutucu anahtar gibi somut sorunları gösterir.
Sorular
Neden Server Action değil?
Server Action da çalışır, ama o zaman e-posta kısmını anahtarlar ve gönderen alan adıyla birlikte siz yazar ve sürdürürsünüz. Formgong ile tarayıcı formu doğrudan gönderir; saklama, e-posta, Telegram ve spam filtresi zaten hazırdır.
Bu Next.js App Router ile çalışır mı?
Evet. Form bir istemci bileşenidir, bu yüzden hem App Router'da hem Pages Router'da çalışır. Sunucu koduna ihtiyaç duymaz.
Prompttaki erişim anahtarı gizli mi?
Hayır. Erişim anahtarı (fk_…) tasarım gereği herkese açıktır. Yalnızca tek bir forma gönderim yapmaya izin verir; bunu sitenizdeki herkes zaten yapabilir. Turnstile gizli anahtarı ya da Formgong API token'ı (fgp_…) gibi gizli bilgiler asla prompta veya frontend'e girmemelidir.
Prompta gerçek anahtarımı nasıl eklerim?
Anahtarı Formgong panelinden kopyalayın ve fk_your_access_key yerine yazın. Giriş yaptıysanız promptun altındaki düğmeye basın. Düğme formlarınızı tarayıcıda doğrudan panelinizden okur ve anahtarı ekler. Promptu kendiniz yapıştırana kadar araç hiçbir şey almaz.