Форма в Replit
Replit Agent часто додає для контактної форми Express route і базу даних. Промпт лишає форму у фронтенді й надсилає її в Formgong.
- Отримайте access key на головній.
- Відкрийте застосунок у Replit і вставте промпт в Agent.
- Перевірте, що для форми не з’явилося серверного route, бази чи секрету.
- Опублікуйте, надішліть тестову заявку і відкрийте її у вхідних Formgong.
Промпт
Додай у застосунок контактну форму без власного бекенду. Заявки приймає Formgong. - POST на https://formgong.com/submit (звичайна HTML-форма або fetch) - Приховане поле access_key зі значенням fk_your_access_key (ключ публічний) - Поля name, email, message; підписи українською - Візуально приховане honeypot-поле botcheck - Не додавай Express чи Flask route, базу даних, Replit Secrets і nodemailer для цієї форми - Для fetch: Accept: application/json; успіх — json.success === true Додатково: - Поле 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>
);
}Додати в наявний проєкт: 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 теж.
Де Replit зазвичай помиляється
Для контактної форми Replit Agent часто додає маршрут Express або Flask, таблицю в базі й nodemailer з паролем SMTP у Replit Secrets. Це більше того, що треба запускати й захищати. Промпт залишає форму лише на фронтенді: браузер надсилає дані в Formgong, а той зберігає заявку, фільтрує спам і надсилає лист.
Оскільки заявки йдуть просто в Formgong, форма працює й тоді, коли сервер застосунку перезапускається чи оновлюється.
Для агентів: підключіть MCP-сервер
Replit Agent вміє працювати з власними MCP-серверами. Відкрийте Integrations, перейдіть у MCP Servers і додайте сервер за адресою. Токен вкажіть у власному заголовку в Advanced settings. Тоді Agent бачитиме ваші форми й отримуватиме код із вашим справжнім ключем.
Налаштування MCP для Replit
URL: https://formgong.com/mcp Advanced settings → custom header Authorization: Bearer fgp_your_token
Промпт для агента з 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_ у файли проєкту.
Перевірте результат
- Перевірте зміни Agent: для форми немає нового серверного маршруту, таблиці в базі чи секрету.
- Опублікуйте застосунок і надішліть тестову заявку з живої адреси.
- Відкрийте заявку у вхідних Formgong.
- Перевірте опубліковану сторінку перевіркою форми.
Перевірка форми читає опубліковану сторінку й показує конкретні проблеми, наприклад поле без атрибута name або ключ-заглушку.
Питання
Чи потрібні Replit Secrets для ключа доступу?
Ні. Ключ доступу публічний і має стояти в HTML сторінки. Secrets — для приватних значень, а в цій формі їх немає.
У моєму застосунку в Replit уже є бекенд. Може, форма має йти через нього?
Може, але тоді доставку листів і фільтр спаму підтримуєте ви. Надсилання в Formgong робить форму незалежною від вашого сервера, тож вона працює, поки ви змінюєте бекенд.
Ключ доступу в промпті — це секрет?
Ні. Ключ доступу (fk_…) публічний за задумом. Він дозволяє лише надсилати заявки в одну форму, а це й так може зробити будь-хто на вашому сайті. Секрети, як-от секретний ключ Turnstile чи API-токен Formgong (fgp_…), ніколи не мають потрапляти в промпт або фронтенд.
Як підставити в промпт свій справжній ключ?
Скопіюйте його з кабінету Formgong і замініть fk_your_access_key. Якщо ви ввійшли в акаунт, натисніть кнопку під промптом. Вона прочитає ваші форми з вашого кабінету прямо в браузері й підставить ключ. Інструмент нічого не отримає, доки ви самі не вставите промпт.