Webhooki
Formgong wysyła JSON metodą POST i podpis HMAC-SHA256 surowego ciała. Sekret jest w ustawieniach formularza. Do 5 prób; ponowienia po 30 s, 2 min, 10 min i 30 min.
Jeśli ostatnia próba też się nie uda, Formgong wysyła e-mail do właściciela formularza. Taki sam list idzie, gdy po tych samych próbach padnie webhook Slacka lub Discorda, dowolny inny webhook, Google Sheets albo Telegram. Najwyżej jeden e-mail dziennie na formularz i kanał, w każdym planie, także Free. List o Telegramie mówi zwykłymi słowami, co się stało (na przykład bota usunięto z grupy, nie znaleziono czatu albo użytkownik zablokował bota) i jak połączyć ponownie: utwórz nowy kod w ustawieniach formularza, otwórz link do bota albo dodaj bota do grupy i wyślij /connect z tym kodem.
{
"event": "submission.created",
"form": { "id": "…", "name": "…" },
"submission": {
"id": "…",
"created_at": "2026-09-29T12:00:00.000Z",
"page_url": "https://example.com/",
"fields": { "name": "Anna", "email": "anna@example.pl" },
"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);
}
Linki do plików w webhookach
Każdy przesłany plik w webhooku dostaje podpisany link download_url, który otwiera się bez logowania, dopóki nie wygaśnie. Każdy, kto ma link, może pobrać plik, więc włącz to tylko wtedy, gdy usługa odbierająca webhook potrzebuje plików. Wyłączenie, zmiana sekretu webhooka albo usunięcie zgłoszenia od razu zatrzymuje linki.
Aby to włączyć, otwórz ustawienia formularza, zezwól na załączniki, potem w sekcji webhooków wybierz 24 godziny lub 7 dni w polu „Linki do plików w webhookach” i zapisz. Linki dostaną tylko webhooki wysłane później.
"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"
}]
Wtedy każdy plik w submission.attachments ma też download_url i download_expires_at. Usługa odbierająca webhook pobiera plik zwykłym żądaniem GET, bez nagłówków i logowania. Po terminie ważności link zwraca 404, a jeden plik można pobrać do 60 razy na godzinę. E-maile, Telegram ani wiadomości w Slacku czy Discordzie nigdy nie dostają tych linków.
Slack i Discord
Wklej w pole webhooka adres przychodzącego webhooka Slack (https://hooks.slack.com/services/…) albo webhooka kanału Discord (https://discord.com/api/webhooks/…). Wtedy Formgong zamiast JSON z przykładu wyżej wysyła krótką wiadomość na czat: nazwę formularza, odpowiedzi, stronę i link do zgłoszenia.
Wzmianki takie jak @everyone, @here i @channel są rozbrajane, odwiedzający nie ukryje linku pod innym tekstem, a długie zgłoszenia są przycinane do limitów platformy z linkiem do pełnego zgłoszenia. Pliki są pokazywane z nazwy. Nagłówek X-Signature nadal jest wysyłany, ponowienia i dziennik dostaw działają jak dla każdego webhooka, a „Wyślij test” pokazuje, jak wygląda wiadomość.
Linki workflow Slack (hooks.slack.com/triggers/…) i wszystkie inne adresy dostają JSON.
Make, n8n, Zapier
Utwórz moduł webhook (Make), węzeł Webhook (n8n) albo Catch Hook (Zapier) i wklej ten adres w ustawieniach formularza. Pola zmapuj z submission.fields.
Poradniki krok po kroku: 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");
}
Formularz HTML do Google Sheets: 2 sposoby →
KeyCRM
Nie ma gotowego konektora. W n8n albo Make odbierz webhook Formgong i wywołaj API KeyCRM własnym kluczem. Pola czytaj z submission.fields.