Webhooks

يرسل Formgong طلب POST فيه JSON وتوقيع HMAC-SHA256 للجسم الخام. السر في إعدادات النموذج. حتى 5 محاولات، وتنتظر إعادة المحاولة 30 ثانية ثم دقيقتين ثم 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": "sara@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 موقّع يُفتح دون تسجيل الدخول حتى تنتهي صلاحيته. يمكن لأي شخص لديه الرابط تنزيل الملف، لذا فعّل هذا فقط إذا كانت الخدمة التي تستقبل الويب هوك تحتاج إلى الملفات. الإيقاف أو تجديد سر الويب هوك أو حذف الإرسال يوقف الروابط فورًا.

لتفعيلها، افتح إعدادات النموذج واسمح بالمرفقات، ثم في قسم Webhook اختر 24 ساعة أو 7 أيام في حقل «روابط الملفات في الويب هوك» واحفظ. تحمل الروابط فقط طلبات Webhook المرسلة بعد ذلك.

"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 (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");
}

KeyCRM

لا يوجد موصل أصلي. في n8n أو Make، استقبل Webhook الخاص بـ Formgong واستدعِ واجهة برمجة تطبيقات KeyCRM باستخدام مفتاحك الخاص. اقرأ الحقول من submission.fields.

KeyCRM: وصفات خطوة بخطوة (بالإنجليزية)