Replit'te form
Replit Agent iletişim formu için sık sık Express route ve veritabanı ekler. Prompt formu frontend'de tutar ve Formgong'a gönderir.
- Ana sayfadan access key alın.
- Replit uygulamasını açın ve promptu Agent'a yapıştırın.
- Form için yeni sunucu route'u, veritabanı veya secret eklenmediğini kontrol edin.
- Yayınlayın, test başvurusu gönderin ve Formgong gelen kutusunda açın.
Prompt
Uygulamaya kendi backend'i olmayan bir iletişim formu ekle. Başvuruları Formgong alır. - POST https://formgong.com/submit (düz HTML form veya fetch) - Değeri fk_your_access_key olan gizli access_key alanı (anahtar herkese açıktır) - Alanlar name, email, message; etiketler Türkçe - Görsel olarak gizli honeypot alanı botcheck - Bu form için Express veya Flask route, veritabanı, Replit Secrets ya da nodemailer ekleme - fetch için: Accept: application/json; başarı: json.success === true 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>
);
}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.
Replit genellikle nerede hata yapar
İletişim formu için Replit Agent çoğu zaman bir Express ya da Flask rotası, bir veritabanı tablosu ve SMTP şifresi Replit Secrets'ta duran nodemailer ekler. Bu, çalıştırılması ve korunması gereken daha fazla şey demektir. Prompt formu yalnızca frontend'de tutar: tarayıcı verileri Formgong'a gönderir, Formgong da gönderimi saklar, spam'i filtreler ve e-postayı yollar.
Gönderimler doğrudan Formgong'a gittiği için uygulama sunucusu yeniden başlarken ya da güncellenirken de form çalışır.
Ajanlar için: MCP sunucusunu bağlayın
Replit Agent özel MCP sunucularıyla çalışabilir. Integrations'ı açın, MCP Servers bölümüne gidin ve sunucuyu adresiyle ekleyin. Token'ı Advanced settings içinde özel bir başlıkta belirtin. Ardından Agent formlarınızı görür ve gerçek anahtarınızla kodu alır.
Replit için MCP ayarları
URL: https://formgong.com/mcp Advanced settings → custom header Authorization: Bearer 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
- Agent'ın değişikliklerini kontrol edin: form için yeni sunucu rotası, veritabanı tablosu ya da gizli anahtar yok.
- Uygulamayı yayınlayın ve canlı adresten bir test gönderimi yapın.
- Gönderimi Formgong gelen kutusunda açın.
- 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
Erişim anahtarı için Replit Secrets gerekir mi?
Hayır. Erişim anahtarı herkese açıktır ve sayfanın HTML'inde durmalıdır. Secrets özel değerler içindir; bu formda öyle bir değer yok.
Replit uygulamamda zaten bir backend var. Form onun üzerinden mi gitmeli?
Gidebilir, ama o zaman e-posta teslimatını ve spam filtresini siz sürdürürsünüz. Formgong'a göndermek formu sunucunuzdan bağımsız kılar, böylece backend'i değiştirirken de çalışır.
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.