Вебхуки
Formgong надсилає POST JSON і підпис HMAC-SHA256 сирого тіла. Секрет є в налаштуваннях форми. До 5 спроб; повтори через 30 с, 2 хв, 10 хв і 30 хв.
Якщо остання спроба теж не вдається, Formgong пише власнику форми на пошту. Такий самий лист іде, коли після тих самих повторів падає вебхук Slack чи Discord, будь-який інший вебхук, Google Таблиці або Telegram. Не більше одного листа на добу для кожної форми й каналу, на будь-якому тарифі, включно з Free. У листі про Telegram причина простими словами (наприклад, бота видалили з групи, чат не знайдено або користувач заблокував бота) і як підключити знову: створіть новий код у налаштуваннях форми, відкрийте посилання на бота або додайте бота в групу й надішліть /connect із цим кодом.
{
"event": "submission.created",
"form": { "id": "…", "name": "…" },
"submission": {
"id": "…",
"created_at": "2026-09-29T12:00:00.000Z",
"page_url": "https://example.com/",
"fields": { "name": "Olena", "email": "olena@example.com" },
"is_spam": false
}
}
Header X-Signature: sha256=…. Header X-Formgong-Event: submission.created.
import { createHmac, timingSafeEqual } from "node:crypto";
function verified(rawBody, signature, secret) {
const digest = createHmac("sha256", secret).update(rawBody).digest();
const got = Buffer.from(String(signature).replace(/^sha256=/, ""), "hex");
return got.length === digest.length && timingSafeEqual(got, digest);
}
Посилання на файли у вебхуках
Кожен завантажений файл у вебхуку отримує підписане посилання download_url, яке відкривається без входу, поки не мине його строк. Будь-хто з цим посиланням може завантажити файл, тож вмикайте це, лише якщо сервісу, що приймає вебхук, потрібні файли. Вимкнення, заміна секрету вебхука або видалення заявки одразу зупиняють посилання.
Щоб увімкнути, відкрийте налаштування форми, дозвольте вкладення файлів, потім у розділі вебхуків виберіть 24 години або 7 днів у полі «Посилання на файли у вебхуках» і збережіть. Посилання матимуть лише вебхуки, надіслані після цього.
"attachments": [{
"id": "…", "field": "photo", "filename": "cart.jpg", "size": 182044, "content_type": "image/jpeg",
"url": "https://formgong.com/dashboard/forms/…/attachments/…",
"download_url": "https://formgong.com/files/…?exp=…&sig=…",
"download_expires_at": "2026-11-02T12:00:00.000Z"
}]
Тоді кожен файл у submission.attachments має ще download_url і download_expires_at. Сервіс, що приймає вебхук, завантажує файл звичайним GET-запитом, без заголовків і входу. Після строку дії посилання повертає 404, а один файл можна завантажити до 60 разів на годину. Листи, Telegram і повідомлення в Slack чи Discord цих посилань ніколи не отримують.
Slack і Discord
Вставте в поле вебхука URL вхідного вебхука Slack (https://hooks.slack.com/services/…) або вебхука каналу Discord (https://discord.com/api/webhooks/…). Тоді Formgong надсилає замість JSON вище коротке повідомлення в чат: назву форми, відповіді, сторінку й посилання на заявку.
Згадки на кшталт @everyone, @here і @channel знешкоджуються, відвідувач не може сховати посилання під іншим текстом, а довгі заявки обрізаються до лімітів платформи з посиланням на повну заявку. Файли показуються назвами. Заголовок X-Signature надсилається й далі, повтори та журнал доставок працюють як для будь-якого вебхука, а «Надіслати тест» показує, як виглядатиме повідомлення.
Посилання воркфлоу Slack (hooks.slack.com/triggers/…) і всі інші URL отримують JSON.
Make, n8n, Zapier
Створіть webhook-модуль (Make), Webhook node (n8n) або Catch Hook (Zapier) і вставте його URL у налаштування форми. Далі зіставте поля submission.fields.
Покрокові інструкції: Make, n8n, Zapier, KeyCRM.
Google Sheets
// Webhook URL: the web app URL + "?key=" + the same SECRET (Apps Script cannot read headers).
const SECRET = "change-me";
function doPost(e) {
if (e.parameter.key !== SECRET) return reply();
const body = JSON.parse(e.postData.contents);
if (body.event !== "submission.created") return reply(); // the dashboard test sends "webhook.test"
const lock = LockService.getScriptLock();
lock.waitLock(20000);
try {
const sheet = SpreadsheetApp.getActive().getSheetByName("Leads");
const id = body.submission.id;
// A retry after a timeout carries the same id: skip rows that are already there.
if (!sheet.getRange("A:A").createTextFinder(id).matchEntireCell(true).findNext()) {
const fields = body.submission.fields;
sheet.appendRow([id, body.submission.created_at, fields.name, fields.email, fields.message]);
}
} finally {
lock.releaseLock();
}
return reply();
}
// HtmlService, not ContentService: ContentService answers with a redirect, and a webhook counts a redirect as a failure.
function reply() {
return HtmlService.createHtmlOutput("ok");
}
HTML-форма в Google Таблиці: 2 безкоштовні шляхи →
KeyCRM
Нативного конектора немає. У n8n або Make прийміть вебхук Formgong і викличте API KeyCRM своїм ключем. Поля беріть із submission.fields.