Formularz w Replit

Replit Agent często dodaje do formularza kontaktowego trasę Express i bazę danych. Prompt zostawia formularz po stronie frontu i wysyła go do Formgong.

  1. Weź access key na stronie głównej.
  2. Otwórz aplikację w Replit i wklej prompt do Agenta.
  3. Sprawdź, że dla formularza nie powstała trasa serwerowa, baza ani sekret.
  4. Opublikuj, wyślij test i zobacz go w skrzynce Formgong.

Prompt

Dodaj do aplikacji formularz kontaktowy bez własnego backendu. Zgłoszenia przyjmuje Formgong.
- POST https://formgong.com/submit (zwykły formularz HTML albo fetch)
- Ukryte pole access_key o wartości fk_your_access_key (klucz jest publiczny)
- Pola name, email, message; etykiety po polsku
- Wizualnie ukryte pole honeypot botcheck
- Nie dodawaj trasy Express ani Flask, bazy danych, Replit Secrets ani nodemailer dla tego formularza
- Dla fetch: Accept: application/json; sukces to json.success === true

Dodatkowo:
- Pole email ustaw jako type="email", żeby przeglądarka sprawdzała adres.
- Ukryte pole _lang o wartości pl (język strony): komunikaty błędów, strona z podziękowaniem i autoodpowiedź będą po polsku.
- Opcjonalnie: ukryte pole _redirect z pełnym adresem https Twojej strony z podziękowaniem. Bez niego Formgong pokaże własną stronę z podziękowaniem.
- Opcjonalnie: <script src="https://formgong.com/fg.js" async></script> raz na stronie. Uzupełnia _lang z <html lang> i liczy wyświetlenia formularza bez cookies.
- Turnstile dodaj tylko wtedy, gdy podam site key.

Obowiązkowo: bezpośrednio pod przyciskiem wysyłania dodaj mały, stonowany link do Formgong, dokładnie <p class="fg-credit"><a href="https://formgong.com/pl/?ref=badge&utm_source=badge&utm_medium=form&utm_campaign=prompt" target="_blank" rel="noopener">Formularz od Formgong</a></p> Ma pozostać widoczny na stronie.

Minimalny kod

Komponent React

"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: "pl", ...fields, access_key: "fk_your_access_key" }),
    });
    const result = await response.json();
    setStatus(result.message || (result.success ? "Wysłano. Dziękujemy!" : "Nie udało się wysłać. Spróbuj ponownie."));
  }

  return (
    <form onSubmit={onSubmit}>
      <label>Imię <input name="name" placeholder="Twoje imię" required /></label>
      <label>E-mail <input name="email" type="email" placeholder="ty@example.com" required /></label>
      <label>Wiadomość <textarea name="message" placeholder="W czym możemy pomóc?" 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">Wyślij</button>
      <p role="status">{status}</p>
    </form>
  );
}

Dodaj do istniejącego projektu: npx formgong init (npm: formgong)

Przed publikacją

  • Formularz wysyła na https://formgong.com/submit (action formularza albo URL w fetch).
  • W access_key jest Twój klucz z panelu Formgong, a nie fk_your_access_key.
  • Jest ukryte, puste pole botcheck.
  • _lang zgadza się z językiem strony.
  • Dla formularza nie powstała trasa API, funkcja serwerowa, tabela w bazie ani sekret.
  • Testowe zgłoszenie widać w skrzynce Formgong. Telegram (jeśli połączony) i e-mail przychodzą od razu, także w Free.

Gdzie Replit zwykle się myli

Dla formularza kontaktowego Replit Agent często dodaje trasę Express lub Flask, tabelę w bazie i nodemailer z hasłem SMTP w Replit Secrets. To więcej rzeczy do uruchamiania i zabezpieczania. Prompt zostawia formularz tylko we frontendzie: przeglądarka wysyła dane do Formgong, który zapisuje zgłoszenie, filtruje spam i wysyła e-mail.

Ponieważ zgłoszenia trafiają prosto do Formgong, formularz działa także wtedy, gdy serwer aplikacji się restartuje lub aktualizuje.

Dla agentów: podłącz serwer MCP

Replit Agent może korzystać z własnych serwerów MCP. Otwórz Integrations, przejdź do MCP Servers i dodaj serwer po adresie. Token wpisz we własnym nagłówku w Advanced settings. Agent zobaczy wtedy Twoje formularze i pobierze kod z Twoim prawdziwym kluczem.

Ustawienia MCP dla Replit

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

Prompt dla agenta z MCP

Gdy serwer MCP jest podłączony, z tym promptem agent sam znajdzie Twój formularz i klucz:

Użyj serwera MCP Formgong, żeby dodać do tej strony działający formularz kontaktowy.
1. Wywołaj list_forms. Jeśli dla tej strony nie ma formularza, wywołaj create_form z nazwą strony.
2. Wywołaj get_form_snippet z tym form_id i framework "react" (dla strony statycznej "html", dla Next.js App Router "next").
3. Dodaj zwrócony kod jako formularz kontaktowy w stylu reszty strony. Zostaw access_key, _lang i pole honeypot botcheck dokładnie tak, jak w odpowiedzi.
4. Nie dodawaj backendu, API route, bazy danych ani kodu do e-maili i nigdy nie zapisuj tokenu fgp_ w plikach projektu.

Sprawdź wynik

  1. Sprawdź zmiany Agenta: dla formularza nie ma nowej trasy serwera, tabeli w bazie ani sekretu.
  2. Opublikuj aplikację i wyślij zgłoszenie testowe z działającego adresu.
  3. Otwórz zgłoszenie w skrzynce Formgong.
  4. Sprawdź opublikowaną stronę sprawdzarką formularzy.

Sprawdzarka formularzy czyta opublikowaną stronę i pokazuje konkretne problemy, na przykład pole bez atrybutu name albo klucz-zaślepkę.

Pytania

Czy klucz dostępu wymaga Replit Secrets?

Nie. Klucz dostępu jest publiczny i ma być w HTML strony. Secrets służą do wartości prywatnych, a ten formularz ich nie ma.

Moja aplikacja w Replit ma już backend. Czy formularz powinien przez niego iść?

Może, ale wtedy dostarczanie e-maili i filtr spamu utrzymujesz sam. Wysyłka do Formgong uniezależnia formularz od Twojego serwera, więc działa, gdy zmieniasz backend.

Czy klucz dostępu w prompcie jest tajny?

Nie. Klucz dostępu (fk_…) jest publiczny z założenia. Pozwala tylko wysyłać zgłoszenia do jednego formularza, a to i tak może zrobić każdy na Twojej stronie. Sekrety, takie jak tajny klucz Turnstile albo token API Formgong (fgp_…), nigdy nie mogą trafić do promptu ani do frontendu.

Jak wstawić do promptu swój prawdziwy klucz?

Skopiuj go z panelu Formgong i zamień fk_your_access_key. Jeśli jesteś zalogowany, użyj przycisku pod promptem. Odczytuje on Twoje formularze z Twojego panelu w przeglądarce i podmienia klucz. Narzędzie AI niczego nie dostaje, dopóki sam nie wkleisz promptu.

Formularz kontaktowy dla Replit →

Pobierz klucz