Форма в Bolt

Bolt часто пропонує власну базу. Для контактної форми вона не потрібна.

  1. Візьміть ключ Formgong.
  2. Вставте промпт у Bolt.
  3. Перевірте, що форма постить на /submit, а не в локальну таблицю.
  4. Заявка має з’явитися в інбоксі без редеплою налаштувань.

Промпт

Зроби контактну форму без власного бекенду. Заявки має приймати Formgong.

- action/fetch: https://formgong.com/submit
- access_key: fk_your_access_key
- Поля name, email, message
- Приховане поле botcheck (honeypot), користувач його не бачить
- Не додавай файли, базу і серверні функції
- Відповідь JSON: {"success": true} або редірект, якщо це звичайний POST форми
- Текст інтерфейсу українською

Додатково:
- Поле 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>
  );
}

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

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

Додати в наявний проєкт: npx formgong init (npm: formgong)

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

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

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

Коли Bolt чує слово «форма», він часто додає таблицю в Supabase чи серверну функцію або форму, яка в прев'ю лише пише в консоль. Тоді заявки ніхто не отримує. Промпт просить звичайний POST у Formgong із прихованим ключем доступу, тож нічого додатково розміщувати чи підключати не треба.

Багато проєктів із Bolt публікують на Netlify. Netlify Forms вам при цьому не потрібні. Одного бекенду на форму достатньо, а форма Formgong працює однаково на будь-якому хостингу.

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

Bolt: Settings → Connectors (MCP) → Custom MCP server. Назва: Formgong. Transport: HTTP. Authentication: MCP OAuth. Натисніть Connect, увійдіть у Formgong та підтвердьте дозволи, потім увімкніть конектор для проєкту. API key також працює з особистим токеном Formgong.

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

Name: Formgong
URL: https://formgong.com/mcp?auth=required
Transport: HTTP
Authentication: MCP OAuth
Connect → 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. Надішліть тестову заявку з прев'ю Bolt або з опублікованого сайту.
  2. Відкрийте заявку у вхідних Formgong.
  3. Переконайтеся, що для форми не з'явилося таблиці в базі чи серверної функції.
  4. Перевірте опубліковану сторінку перевіркою форми.

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

Питання

Чи потрібна база даних Bolt для контактної форми?

Ні. Formgong зберігає заявку й надсилає лист. База даних має сенс, лише якщо сам застосунок має показувати чи редагувати заявки.

Чи працюватиме форма, якщо перенести сайт із Bolt?

Так. Форма — це звичайний HTML або виклик fetch, тому вона працює на будь-якому хостингу: Netlify, Vercel, GitHub Pages чи вашому сервері.

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

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

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

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

Форма для Bolt →

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