Bolt'ta form
Bolt sık sık kendi veritabanını önerir. İletişim formu için gerekmez.
- Formgong anahtarını alın.
- Promptu Bolt'a yapıştırın.
- Formun /submit adresine gittiğini kontrol edin.
- Başvuru gelen kutusunda görünür.
Prompt
Kendi backend'i olmayan bir iletişim formu yap. Başvurular Formgong'a gitsin. - https://formgong.com/submit - access_key: fk_your_access_key - name, email, message ve gizli botcheck - Dosya, veritabanı ve sunucu fonksiyonu yok - Arayüz Türkçe 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)
Mevcut projeye ekleyin: npx formgong init (npm: formgong)
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.
Bolt genellikle nerede hata yapar
Bolt “form” kelimesini duyunca çoğu zaman bir Supabase tablosu ya da sunucu fonksiyonu ekler veya önizlemede yalnızca konsola yazan bir form yapar. O zaman mesajları kimse almaz. Prompt, gizli erişim anahtarıyla Formgong'a düz bir POST ister; ek bir şey barındırmanız ya da bağlamanız gerekmez.
Bolt projelerinin çoğu Netlify'da yayınlanır. Bu durumda Netlify Forms'a ihtiyacınız yok. Form başına tek bir backend yeterlidir ve Formgong formu her hostingde aynı şekilde çalışır.
Ajanlar için: MCP sunucusunu bağlayın
Bolt: Settings → Connectors (MCP) → Custom MCP server. Ad: Formgong. Transport: HTTP. Authentication: MCP OAuth. Connect seçin, Formgong hesabınıza giriş yapıp izinleri onaylayın, ardından proje için bağlantıyı etkinleştirin. API key ile kişisel Formgong tokenı da kullanılabilir.
Bolt için MCP ayarları
Name: Formgong URL: https://formgong.com/mcp?auth=required Transport: HTTP Authentication: MCP OAuth Connect → Formgong
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
- Bolt önizlemesinden ya da yayınlanan siteden bir test gönderimi yapın.
- Gönderimi Formgong gelen kutusunda açın.
- Form için bir veritabanı tablosu ya da sunucu fonksiyonu eklenmediğinden emin olun.
- Yayınlanan sayfayı form denetleyicisiyle kontrol edin.
Form denetleyicisi yayınlanan sayfayı okur ve name niteliği olmayan bir alan ya da yer tutucu anahtar gibi somut sorunları gösterir.
Sorular
İletişim formu için Bolt veritabanı gerekir mi?
Hayır. Formgong gönderimi saklar ve e-postayı gönderir. Veritabanı yalnızca uygulamanın kendisi gönderimleri göstermeli ya da düzenlemeliyse anlamlıdır.
Siteyi Bolt'tan taşırsam form çalışır mı?
Evet. Form düz HTML ya da bir fetch çağrısıdır, bu yüzden her hostingde çalışır: Netlify, Vercel, GitHub Pages ya da kendi sunucunuz.
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.