Форма в Lovable

Промпт уже містить ключ, endpoint і honeypot. Не додавайте Supabase і виклик Resend. Lovable не повинен створювати бекенд.

  1. Отримайте access key на головній.
  2. Відкрийте проєкт у Lovable.
  3. Вставте промпт нижче.
  4. Надішліть тестову заявку і відкрийте її в дашборді Formgong.
  5. Підключіть Telegram кнопкою в налаштуваннях.

Промпт

Додай на сайт контактну форму, яка надсилає заявки в Formgong. Власний бекенд, база даних і секретні ключі не потрібні.

Вимоги:
- POST на https://formgong.com/submit
- Приховане поле access_key зі значенням fk_your_access_key (ключ публічний, його можна тримати у фронтенді)
- Поля: name, email, phone (не обов'язково), message. Підписи українською
- Honeypot: текстове поле botcheck, візуально приховане CSS-ом (position:absolute;inset-inline-start:0;top:0;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)), tabindex="-1", autocomplete="off". Людина його не заповнює
- Без завантаження файлів
- Звичайна HTML-форма: method="POST" action="https://formgong.com/submit"
- Якщо використовуєш fetch: Content-Type application/json і Accept: application/json. Успіх — це json.success === true
- Після успіху покажи подяку українською
- Не створюй серверні функції і не підключай Resend

Додатково:
- Поле email роби з type="email", щоб браузер перевіряв адресу.
- Приховане поле _lang зі значенням uk (мова сторінки): так помилки, сторінка подяки й автовідповідь будуть українською.
- Необов'язково: приховане поле _redirect з повною https-адресою вашої сторінки подяки. Без нього Formgong покаже власну сторінку подяки.
- Необов'язково: <script src="https://formgong.com/fg.js" async></script> один раз на сторінці. Він підставляє _lang з <html lang> і рахує перегляди форми без cookies.
- Turnstile додавай лише тоді, коли я дам site key.

Обов'язково: одразу під кнопкою надсилання додай невелике приглушене посилання на Formgong, саме таке: <p class="fg-credit"><a href="https://formgong.com/uk/?ref=badge&utm_source=badge&utm_medium=form&utm_campaign=prompt" target="_blank" rel="noopener">Форма від Formgong</a></p> Воно має лишатися видимим на сторінці.

Мінімальний код

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: "uk", ...fields, access_key: "fk_your_access_key" }),
    });
    const result = await response.json();
    setStatus(result.message || (result.success ? "Надіслано. Дякуємо!" : "Не вдалося надіслати. Спробуйте ще раз."));
  }

  return (
    <form onSubmit={onSubmit}>
      <label>Ім’я <input name="name" placeholder="Ваше ім’я" required /></label>
      <label>Email <input name="email" type="email" placeholder="you@example.com" required /></label>
      <label>Повідомлення <textarea name="message" placeholder="Чим ми можемо допомогти?" 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">Надіслати</button>
      <p role="status">{status}</p>
    </form>
  );
}

Готовий проєкт у Lovable: lovable.dev. Відкрийте його, натисніть Remix і вставте свій ключ доступу в src/components/ContactForm.tsx.

Готовий React-компонент на GitHub: github.com/formgong/react-contact-form. Ліцензія MIT: натисніть «Use this template» або скопіюйте файли.

React-пакет: npm install @formgong/react (npm: @formgong/react)

Перед публікацією

  • Форма надсилає на https://formgong.com/submit (action форми або URL у fetch).
  • У access_key ваш ключ із панелі Formgong, а не fk_your_access_key.
  • Є приховане порожнє поле botcheck.
  • _lang збігається з мовою сторінки.
  • Для форми не з’явилося API route, серверної функції, таблиці в базі чи секрету.
  • Тестова заявка є у вхідних Formgong. Telegram (якщо підключено) і email приходять одразу, і на Free теж.

Де Lovable зазвичай помиляється

На прохання про «контактну форму, яка надсилає мені листи» Lovable часто вмикає Supabase і пише Edge Function, що викликає Resend. Для цього потрібні акаунт Resend, підтверджений домен і секретні ключі, і все тихо ламається, коли чогось бракує. Промпт забороняє це робити. Форма надсилає дані просто з браузера в Formgong, а той зберігає заявку й надсилає лист.

Ще Lovable любить показувати сповіщення «Дякуємо!» до того, як запит завершився. Промпт просить дочекатися success: true, а інакше показати повідомлення про помилку від сервера, тож невдале надсилання ніколи не виглядатиме як успіх.

Для агентів: підключіть MCP-сервер

Lovable: Connectors → + → MCP server. Назва: Formgong. Вкажіть URL, залиште Direct connection та OAuth і натисніть Add & authorize. Увійдіть у Formgong та підтвердьте дозволи. Альтернатива: Bearer token or API key — вставте лише особистий токен.

Налаштування MCP для Lovable

URL: https://formgong.com/mcp
Authentication: OAuth
Add & authorize → Formgong

Промпт для агента з MCP

Коли MCP-сервер підключено, з цим промптом агент сам знайде вашу форму й ключ:

Використай MCP-сервер Formgong, щоб додати на цей сайт робочу контактну форму.
1. Виклич list_forms. Якщо для цього сайту форми немає, виклич create_form з назвою сайту.
2. Виклич get_form_snippet з цим form_id і framework "react" (для статичної сторінки "html", для Next.js App Router "next").
3. Додай отриманий код як контактну форму в стилі решти сайту. Залиш access_key, _lang і honeypot-поле botcheck точно такими, як у відповіді.
4. Не додавай бекенд, API route, базу даних чи код для листів і ніколи не записуй токен fgp_ у файли проєкту.

Перевірте результат

  1. Відкрийте опублікований сайт, а не лише прев'ю, і надішліть тестову заявку зі своєю поштою.
  2. Знайдіть заявку у вхідних Formgong.
  3. Переконайтеся, що Lovable не додав для форми Supabase, Edge Function чи секрет RESEND_API_KEY.
  4. Перевірте опубліковану адресу перевіркою форми.

Перевірка форми читає опубліковану сторінку й показує конкретні проблеми, наприклад поле без атрибута name або ключ-заглушку.

Питання

Чи надсилає прев'ю Lovable справжні заявки?

Так. Нова форма Formgong приймає заявки з будь-якого сайту, тож прев'ю працює. Якщо згодом обмежите форму своїми доменами, тестуйте на опублікованому сайті або додайте ще й домен прев'ю.

Чи можна залишити Supabase для решти застосунку в Lovable?

Так. Промпт лише не пускає контактну форму в Supabase. Вхід, дані й інші функції залишаються як є.

Ключ доступу в промпті — це секрет?

Ні. Ключ доступу (fk_…) публічний за задумом. Він дозволяє лише надсилати заявки в одну форму, а це й так може зробити будь-хто на вашому сайті. Секрети, як-от секретний ключ Turnstile чи API-токен Formgong (fgp_…), ніколи не мають потрапляти в промпт або фронтенд.

Як підставити в промпт свій справжній ключ?

Скопіюйте його з кабінету Formgong і замініть fk_your_access_key. Якщо ви ввійшли в акаунт, натисніть кнопку під промптом. Вона прочитає ваші форми з вашого кабінету прямо в браузері й підставить ключ. Інструмент нічого не отримає, доки ви самі не вставите промпт.

Форма для Lovable →

Отримати ключ