Formularz w Lovable
Prompt zawiera klucz, endpoint i honeypot. Nie dodawaj Supabase ani wywołania Resend. Lovable nie powinien tworzyć backendu.
- Weź access key na stronie głównej.
- Otwórz projekt w Lovable.
- Wklej prompt.
- Wyślij test i zobacz go w panelu.
- Podłącz Telegram w ustawieniach.
Prompt
Dodaj formularz kontaktowy wysyłający zgłoszenia do Formgong. Nie twórz backendu, bazy ani sekretów. - POST https://formgong.com/submit - Ukryte pole access_key o wartości fk_your_access_key (klucz jest publiczny) - Pola: name, email, phone (opcjonalnie), message. Etykiety po polsku - Honeypot: pole botcheck wizualnie ukryte za pomocą CSS - Bez uploadu plików i bez funkcji serwerowych - Zwykły formularz HTML albo fetch z 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>
);
}Gotowy projekt w Lovable: lovable.dev. Otwórz go, kliknij Remix i wpisz swój klucz dostępu w src/components/ContactForm.tsx.
Gotowy komponent React na GitHubie: github.com/formgong/react-contact-form. Licencja MIT: kliknij „Use this template” albo skopiuj pliki.
Pakiet React: npm install @formgong/react (npm: @formgong/react)
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 Lovable zwykle się myli
Na prośbę o „formularz kontaktowy, który wysyła mi e-maile” Lovable często włącza Supabase i pisze Edge Function wywołującą Resend. To wymaga konta Resend, zweryfikowanej domeny i tajnych kluczy, a całość psuje się po cichu, gdy czegoś brakuje. Prompt tego zabrania. Formularz wysyła dane prosto z przeglądarki do Formgong, który zapisuje zgłoszenie i wysyła e-mail.
Lovable lubi też pokazywać komunikat „Dziękujemy!”, zanim żądanie się zakończy. Prompt każe poczekać na success: true, a w innym razie pokazać komunikat błędu z serwera, więc nieudana wysyłka nigdy nie wygląda na sukces.
Dla agentów: podłącz serwer MCP
Lovable: Connectors → + → MCP server. Nazwa: Formgong. Podaj URL, pozostaw Direct connection i OAuth, kliknij Add & authorize. Zaloguj się do Formgong i zatwierdź uprawnienia. Alternatywnie wybierz Bearer token or API key i wklej sam osobisty token.
Ustawienia MCP dla Lovable
URL: https://formgong.com/mcp Authentication: OAuth Add & authorize → Formgong
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
- Otwórz opublikowaną stronę, nie tylko podgląd, i wyślij zgłoszenie testowe ze swoim e-mailem.
- Znajdź zgłoszenie w skrzynce Formgong.
- Sprawdź, czy Lovable nie dodał dla formularza Supabase, Edge Function ani sekretu RESEND_API_KEY.
- Sprawdź opublikowany adres sprawdzarką formularzy.
Sprawdzarka formularzy czyta opublikowaną stronę i pokazuje konkretne problemy, na przykład pole bez atrybutu name albo klucz-zaślepkę.
Pytania
Czy podgląd w Lovable wysyła prawdziwe zgłoszenia?
Tak. Nowy formularz Formgong przyjmuje zgłoszenia z każdej strony, więc podgląd działa. Jeśli później ograniczysz formularz do swoich domen, testuj na opublikowanej stronie albo dodaj też domenę podglądu.
Czy mogę zostawić Supabase dla reszty aplikacji w Lovable?
Tak. Prompt tylko trzyma formularz kontaktowy z dala od Supabase. Logowanie, dane i inne funkcje zostają bez zmian.
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 Lovable →