Home / Features / Webhooks
וובהוקים מובנים

וובהוקים שבאמת מגיעים ליעד

מטעני JSON עם אימות חתימה, שליחה מבוססת תור, ניסיונות חוזרים מעריכיים ויומן שליחות לכל טופס. נבנה למפתחים — בלי שכבת ביניים של Zapier שבולעת לכם את הנתונים.

ללא עלות בכל תוכנית · חתימת HMAC · ניסיונות חוזרים בתור
POST /webhook
{
  "event": "submission.created",
  "delivery_id": "dlv_8aE2k",
  "timestamp": 1730723400,
  "form_id": "f_142",
  "submission_id": "s_9k3X",
  "fields": {
    "name": "Sarah Chen",
    "email": "[email protected]",
    "budget": 25000
  }
}

מה מפעיל וובהוק

מגדירים פעם אחת לכל טופס. אנחנו שולחים בכל אירוע רלוונטי.

submission.created

תגובה חדשה

נשלח ברגע שטופס נשלח, עם מטען התגובה המלא, השדות והמטא-דאטה.

payment.succeeded

תשלום הצליח

כשתשלום Stripe המצורף לתגובה מצליח, הוובהוק כולל את סטטוס התשלום, הסכום והמטבע.

draft.resumed

טיוטה חודשה

כשמשיב חוזר לטיוטה שמורה (בטפסים עם שמירה והמשך), תוכלו לקבל התראה לצורכי ניתוח משפך.

JSON צפוי, עם גרסאות ומבנה מסודר

בלי הפתעות. אותה מעטפה בכל אירוע. סוגי השדות נשמרים כפי שהוגדרו.

{
  "event":         "submission.created",
  "delivery_id":   "dlv_8aE2kF1Ld9zQ",
  "timestamp":     1730723400,
  "form_id":       "f_142",
  "submission_id": "s_9k3XnPq72T",
  "fields": {
    "name":    "Sarah Chen",
    "email":   "[email protected]",
    "company": "Acme Corp",
    "budget":  25000,
    "message": "Looking for a form solution..."
  },
  "payment": {
    "status":   "succeeded",
    "amount":   2500,
    "currency": "usd"
  },
  "meta": {
    "ip":         "203.0.113.42",
    "user_agent": "Mozilla/5.0...",
    "locale":     "en"
  }
}

חתימה מאומתת, בלי זיופים

כל מטען נחתם ב-HMAC-SHA256 באמצעות סוד הוובהוק של הטופס שלכם. אמתו בצד שלכם לפני שאתם סומכים על הנתונים.

חתימת HMAC-SHA256

כותרת X-FormBuilder-Signature בכל בקשה. חשבו את ה-HMAC של הגוף הגולמי עם הסוד שלכם והשוו בזמן קבוע.

סוד נפרד לכל טופס

לכל טופס יש סוד משלו. החליפו אותו מתי שתרצו מהגדרות הטופס — מטענים ישנים נשארים ניתנים לאימות עד שתפיקו סוד חדש.

TLS בלבד

רק נקודות קצה מסוג HTTPS מתקבלות. אנחנו מסרבים לשלוח לכתובות לא מוצפנות כדי להגן על נתוני התגובות בזמן ההעברה.

הגנה מפני שידור חוזר

כל מטען כולל חותמת זמן ומזהה שליחה ייחודי. דחו שליחות ישנות מ-5 דקות כדי למנוע מתקפות שידור חוזר.

לאבטחת הטפסים בכל הפלטפורמה →

אימות ב-3 שורות

בחרו את הסטאק שלכם. העיקרון זהה: מחשבים HMAC לגוף הגולמי עם הסוד ומשווים לכותרת החתימה.

const crypto = require('crypto');

function verify(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(signature)
  );
}
function verify($rawBody, $signature, $secret) {
    $expected = hash_hmac('sha256', $rawBody, $secret);
    return hash_equals($expected, $signature);
}
import hmac, hashlib

def verify(raw_body: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode(), raw_body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)

בנוי לעולם האמיתי

רשתות נופלות, נקודות קצה מגבילות קצב, פריסות קורות. הוובהוקים נכנסים לתור, מנסים שוב ומציגים את מצב השליחה.

שליחה מבוססת תור

התגובה חוזרת מיד למשיב. שליחת הוובהוק מתבצעת בתור ברקע — היא אף פעם לא חוסמת את הטופס.

השהיה מעריכית

שליחות שנכשלו מנוסות שוב עם השהיה מעריכית. אנחנו לא מפציצים את נקודת הקצה שלכם כשהיא כבר מתקשה.

ניסיונות חוזרים מרובים

כל שליחה מנוסה שוב כמה פעמים לאורך שעות. יש לכם זמן להתאושש מתקלות בלי לאבד נתונים.

יומן שליחות

כל ניסיון מתועד — בקשה, קוד תגובה, קטע מהגוף וחותמת זמן. בדקו כשלים בהגדרות הטופס.

מפתחות אידמפוטנטיות

כל שליחה כוללת מזהה ייחודי. השתמשו בו כמפתח אידמפוטנטיות בצד שלכם כדי לסנן כפילויות של ניסיונות חוזרים בבטחה.

מתועד ביומן ביקורת

שינויי כתובת וובהוק, החלפות סודות והפעלה/כיבוי — הכול מתועד ביומן הביקורת של סביבת העבודה שלכם.

מה בונים עם וובהוקים

USE CASE 01

סנכרון CRM מותאם

העבירו לידים ל-CRM הפנימי שלכם עם מיפוי השדות המדויק שהמערכת שלכם מצפה לו.

USE CASE 02

התראות Slack / Discord

מעבר לאינטגרציית Slack המובנית, בנו תהליכי התראה מותאמים עם מטענים עשירים.

USE CASE 03

עיבוד בצד השרת

הפעילו משימות רקע, שלחו מיילים טרנזקציוניים, הריצו אימותים וסנכרנו למחסן הנתונים שלכם.

USE CASE 04

חלופה ל-Zapier / Make

וותרו על דמי שכבת הביניים. וובהוק אחד יכול להתפצל לכל מספר של שירותים פנימיים.

הגדרה ב-4 שלבים

מגדירים פעם אחת, מקבלים לתמיד.

פתחו את הגדרות הטופס

בלוח הבקרה, פתחו את הטופס ועברו אל אינטגרציות ← וובהוקים.

הוסיפו את כתובת נקודת הקצה

הדביקו את כתובת ה-HTTPS שאמורה לקבל את התגובות. אנחנו מוודאים שנקודת הקצה מגיבה לפני השמירה.

העתיקו את סוד החתימה

לכל טופס סוד ייחודי. שמרו אותו בצד השרת והשתמשו בו לאימות המטענים הנכנסים.

שלחו בדיקה

שלחו תגובת בדיקה ובדקו את יומן השליחות. ודאו שנקודת הקצה החזירה 2xx ושבדיקת החתימה עברה.

שאלות נפוצות

האם הוובהוקים בחינם?
כן. וובהוקים כלולים בכל תוכנית. אין חיוב לפי קריאה.
כמה מהר מתבצעת השליחה?
השליחה מבוססת תור ובדרך כלל מסתיימת תוך שניות מרגע התגובה. אנחנו לא חוסמים את תגובת הטופס, כך שהמשיבים רואים אישור מיידי.
מהי מדיניות הניסיונות החוזרים?
שליחות שנכשלו (5xx, פסקי זמן, שגיאות חיבור) מנוסות שוב עם השהיה מעריכית במספר ניסיונות לאורך שעות. לאחר המספר המרבי של ניסיונות, השליחה מסומנת כנכשלה ומתועדת.
אפשר להגדיר כמה וובהוקים לטופס אחד?
כן. הוסיפו כמה נקודות קצה שתצטרכו לטופס אחד. כל אחת נשלחת באופן עצמאי עם סוד ומצב ניסיונות חוזרים משלה.
יש תמיכה ברשימת IP מורשים?
שליחות הוובהוקים יוצאות מקבוצה קבועה של כתובות IP. פנו לתמיכה לקבלת הרשימה העדכנית אם חומת האש שלכם דורשת הרשאה מפורשת.
איך מחליפים את סוד החתימה?
בהגדרות הטופס ← וובהוק ← הפקת סוד חדש. הסוד החדש נכנס לתוקף בשליחה הבאה. עדכנו את נקודת הקצה לאמת עם הסוד החדש לפני ההפקה מחדש.

מוכנים לחבר?

וובהוקים מובנים. ללא עלות בכל תוכנית.

התחילו עכשיו — בחינם