Webhooks
Formgong שולח POST עם JSON וחתימת HMAC-SHA256 של הגוף הגולמי. הסוד בהגדרות הטופס. עד 5 ניסיונות; ניסיון חוזר אחרי 30 שניות, 2 דקות, 10 דקות ו-30 דקות.
אם גם הניסיון האחרון נכשל, Formgong שולח מייל לבעל הטופס. אותו מייל נשלח כש-webhook של Slack או Discord, webhook אחר, Google Sheets או 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": "נועה", "email": "noa@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);
}
קישורים לקבצים ב-Webhooks
כל קובץ שהועלה ב-Webhook מקבל קישור download_url חתום שנפתח בלי התחברות עד שתוקפו פג. כל מי שיש לו את הקישור יכול להוריד את הקובץ, לכן הפעילו זאת רק אם השירות שמקבל את ה-Webhook צריך את הקבצים. כיבוי, החלפת הסוד של ה-Webhook או מחיקת השליחה עוצרים את הקישורים מיד.
כדי להפעיל, פתחו את הגדרות הטופס, אפשרו קבצים מצורפים, ואז באזור ה-Webhook בחרו 24 שעות או 7 ימים בשדה „קישורים לקבצים ב-Webhooks” ושמרו. רק Webhooks שנשלחים אחרי כן יכילו את הקישורים.
"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
הדביקו בשדה ה-webhook כתובת webhook נכנס של Slack (https://hooks.slack.com/services/…) או כתובת webhook של ערוץ Discord (https://discord.com/api/webhooks/…). אז Formgong שולח במקום ה-JSON שלמעלה הודעת צ׳אט קצרה עם שם הטופס, התשובות, הדף וקישור לשליחה.
אזכורים כמו @everyone, @here ו-@channel מנוטרלים, מבקר לא יכול להסתיר קישור מאחורי טקסט אחר, ושליחות ארוכות נחתכות למגבלות הפלטפורמה עם קישור לשליחה המלאה. קבצים מופיעים בשמם. הכותרת X-Signature עדיין נשלחת, ניסיונות חוזרים ויומן המסירות עובדים כמו בכל webhook, ו„שליחת בדיקה” מראה איך ההודעה נראית.
קישורי תהליכי עבודה של Slack (hooks.slack.com/triggers/…) וכל כתובת אחרת מקבלים JSON.
Make, n8n, Zapier
צרו מודול webhook ב-Make, Webhook node ב-n8n או Catch Hook ב-Zapier, והדביקו את הכתובת בהגדרות הטופס. ממפו את 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");
}
KeyCRM
אין מחבר מובנה. ב-n8n או ב-Make קבלו את ה-webhook של Formgong וקראו ל-API של KeyCRM עם המפתח שלכם. השדות ב-submission.fields.