Webhook'lar
Formgong JSON'u POST eder ve ham gövdenin HMAC-SHA256 imzasını ekler. Gizli anahtar form ayarlarındadır. En fazla 5 deneme yapılır; tekrarlar arasında 30 sn, 2 dk, 10 dk ve 30 dk beklenir.
Son deneme de başarısız olursa Formgong form sahibine e-posta gönderir. Aynı e-posta, aynı yeniden denemelerden sonra bir Slack veya Discord webhook’u, başka bir webhook, Google Sheets ya da Telegram başarısız olunca da gider. Her form ve kanal için günde en fazla bir e-posta, Free dahil her planda. Telegram e-postası sorunu düz sözcüklerle söyler (örneğin bot gruptan çıkarıldı, sohbet bulunamadı ya da kullanıcı botu engelledi) ve nasıl yeniden bağlanılacağını anlatır: form ayarlarında yeni bir kod oluşturun, bot bağlantısını açın ya da botu gruba ekleyip bu kodla /connect gönderin.
{
"event": "submission.created",
"form": { "id": "…", "name": "…" },
"submission": {
"id": "…",
"created_at": "2026-09-29T12:00:00.000Z",
"page_url": "https://example.com/",
"fields": { "name": "Ayşe", "email": "ayse@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);
}
Webhook'larda dosya bağlantıları
Webhook'taki her yüklenen dosya, süresi dolana kadar giriş yapmadan açılan imzalı bir download_url alır. Bağlantıya sahip olan herkes dosyayı indirebilir; bu yüzden yalnızca webhook'u alan hizmetin dosyalara ihtiyacı varsa açın. Kapatmak, webhook sırrını yenilemek veya gönderimi silmek bağlantıları hemen durdurur.
Açmak için formun ayarlarını açın, dosya eklerine izin verin, ardından webhook bölümünde “Webhook'larda dosya bağlantıları” alanından 24 saat veya 7 gün seçip kaydedin. Bağlantılar yalnızca bundan sonra gönderilen webhook'larda yer alır.
"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"
}]
Bundan sonra submission.attachments içindeki her dosyada download_url ve download_expires_at da bulunur. Webhook'u alan servis dosyayı başlık veya giriş gerekmeden düz bir GET isteğiyle indirir. Süre dolduktan sonra bağlantı 404 döndürür ve bir dosya saatte en fazla 60 kez indirilebilir. E-postalar, Telegram ve Slack ya da Discord mesajları bu bağlantıları asla almaz.
Slack ve Discord
Webhook alanına bir Slack gelen webhook adresi (https://hooks.slack.com/services/…) ya da bir Discord kanal webhook adresi (https://discord.com/api/webhooks/…) yapıştırın. Formgong bu durumda yukarıdaki JSON yerine kısa bir sohbet mesajı gönderir: form adı, yanıtlar, sayfa ve başvuruya bağlantı.
@everyone, @here ve @channel gibi bahsetmeler etkisiz hale getirilir, ziyaretçi bir bağlantıyı başka bir metnin arkasına gizleyemez ve uzun başvurular tam başvuruya bağlantıyla platform sınırlarına kısaltılır. Dosyalar adlarıyla listelenir. X-Signature başlığı yine gönderilir, yeniden denemeler ve teslimat kayıtları her webhook'taki gibi çalışır, “Test gönder” mesajın nasıl göründüğünü gösterir.
Slack iş akışı bağlantıları (hooks.slack.com/triggers/…) ve diğer tüm adresler JSON alır.
Make, n8n, Zapier
Bir webhook modülü (Make), Webhook düğümü (n8n) veya Catch Hook (Zapier) oluşturun ve bu URL'yi form ayarlarına yapıştırın. Alanları oradan submission.fields ile eşleyin.
Adım adım tarifler (İngilizce): 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 formdan Google Sheets'e: 2 ücretsiz yol →
KeyCRM
Hazır bir bağlayıcı yok. n8n veya Make'te Formgong webhook'unu alın ve kendi anahtarınızla KeyCRM API'sini çağırın. Alanları submission.fields içinden okuyun.