כיצד לשלוח את אישורי ההגעה, הצ'ק-אינים והתמונות של האירוע לאפליקציות אחרות
Webhooks מאפשרים לאירוע שלכם לספר לאפליקציות אחרות מה קורה ברגע שזה קורה. כשאורח משיב לאישור ההגעה, נרשם בכניסה או כשתמונה חדשה מופיעה בגלריה, Fotify שולחת הודעה קטנה לכתובת שבחרתם. משם היא יכולה להגיע ל-CRM, לגיליון Google, לערוץ Slack, לרצף אימיילים או לשרת שלכם.
אפשר להתחבר בשתי דרכים:
- Zapier או Make, בלי קוד: מתחברים עם מפתח API ובוחרים מה יקרה.
- כתובת webhook משלכם: Fotify שולחת אליה הודעת JSON חתומה.
Webhooks, Zapier ו-Make כלולים מתוכנית Professional ומעלה, ובכל אירוע שפועל במסגרת מנוי אירועים.
מה Fotify יכולה לשלוח
כל webhook מאזין לרגע אחד או יותר מאלה:
- התקבל אישור הגעה: אורח השיב או שינה את אישור ההגעה שלו. כולל את שמו, האימייל, הטלפון, התשובה, מספר המשתתפים, ההערות והתשובות לשאלות המותאמות שלכם.
- אורח נרשם בכניסה: אורח נרשם בכניסה לאירוע, עם הקבוצה והאדם שהגיע.
- תמונה או סרטון חדשים: משהו חדש הופיע בגלריה. התמונות מגיעות עם קישור לתמונה שתקף ל-7 ימים. תמונות שממתינות לאישור נשלחות לאחר שאישרתם אותן, ותמונות באלבומים פרטיים לא נשלחות לעולם.
- האירוע התחיל: הפעלתם את האירוע והאורחים יכולים להעלות.
- האירוע הסתיים: סיימתם את האירוע, או שחלון ההעלאה שלו נסגר.
שלב 1: חיבור Zapier או Make
- בלוח הבקרה של Fotify, פתחו הגדרות חשבון → אינטגרציות.
- הקלידו שם למפתח, לדוגמה "Zapier", ולחצו על צור מפתח.
- העתיקו את המפתח מיד. מטעמי אבטחה הוא מוצג פעם אחת בלבד.
- פתחו את אפליקציית Fotify ב-Zapier או ב-Make דרך הקישורים האלה (היא עדיין לא מופיעה בספריות האפליקציות שלהם), והדביקו את המפתח כשתתבקשו להתחבר.
- בחרו טריגר, כמו New RSVP response או New photo or video, ובחרו את האירוע שלכם מהרשימה.
רשימת האירועים מציגה את האירועים שאתם מנהלים והתוכנית שלהם כוללת webhooks. כל Zap או תרחיש שתפעילו מופיע בעמוד Webhooks של האירוע, מסומן כ-Zapier או כ-Make.
אפשר גם להשתמש ב-Webhooks by Zapier → Catch Hook של Zapier או ב-Custom webhook של Make במקום באפליקציית Fotify: העתיקו את הכתובת שהם נותנים והוסיפו אותה ככתובת webhook בשלב 2.
שלב 2: הוספת כתובת webhook
- פתחו את האירוע בלוח הבקרה וגללו אל הכרטיס Webhooks, Zapier ו-Make.
- לחצו על הגדר webhooks, ואז על הוסף webhook.
- הדביקו את הכתובת שאמורה לקבל את ההודעות. היא חייבת להתחיל ב-
https://ולהיות נגישה מהאינטרנט. - סמנו מה לשלוח, הוסיפו תווית אם תרצו, ולחצו על הוסף webhook.
- העתיקו את סוד החתימה שמוצג מעל ה-webhook החדש ושמרו אותו אצל המקבל.
- לחצו על שלח אירוע בדיקה כדי לוודא שהכול מגיע.
רק מי שיכול לנהל את האירוע יכול להוסיף או לשנות את ה-webhooks שלו, וכל רגע דורש גישה לנתונים שלו: רגעים של אורחים דורשים גישה לרשימת האורחים, ורגעים של תמונות דורשים גישה לגלריה.
איך נראית הודעה
כל הודעה היא POST עם גוף JSON:
{
"id": "4f1c2e9a-7b2d-4c1e-9a8f-2d3b4c5e6f70",
"type": "rsvp.responded",
"createdAt": "2026-06-01T18:24:05.000Z",
"event": { "id": "…", "name": "Ana & Leo's Wedding" },
"data": {
"rsvp": {
"firstName": "Alex",
"lastName": "Rivera",
"email": "alex@example.com",
"status": "accepted",
"confirmedGuests": 2
}
}
}
סטטוס (status) של RSVP הוא אחד מהבאים: accepted, declined, not_answered, attended, pending_approval (ממתין לאישורכם) או waitlisted. לאורח שממתין לאישור או שנמצא ברשימת ההמתנה יש confirmedGuests ב-0, והקבוצה שביקש מופיעה ב-requestedGuests; rsvp.responded מופעל שוב כשאתם מאשרים או דוחים אותו.
ה-id נשאר זהה כשהודעה נשלחת שוב, כך שהמקבל שלכם יכול לדלג על כפילויות. הכותרות מציינות את הרגע (Fotify-Event) ואת ההודעה (Fotify-Delivery).
תאריכים של האירוע עצמו, כמו eventDate ו-eventTime, ניתנים באזור הזמן של המקום, כפי שהאורחים שלכם רואים אותם.
איך לוודא שהודעה הגיעה מ-Fotify
כל הודעה נושאת כותרת Fotify-Signature כמו t=1780000000,v1=5257a8…. כדי לבדוק אותה:
- קחו את
t(זמן השליחה) ואת גוף הבקשה הגולמי. - חשבו HMAC-SHA256 של
t+.+ הגוף, באמצעות סוד החתימה של ה-webhook שלכם. - השוו את התוצאה ל-
v1, ודחו הודעות ש-tשלהן ישן ביותר מ-5 דקות.
ב-Node.js:
const crypto = require("crypto");
function isFromFotify(rawBody, header, secret) {
const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
const expected = crypto
.createHmac("sha256", secret)
.update(`${parts.t}.${rawBody}`)
.digest("hex");
const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
return fresh && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
}
אפשר להציג את הסוד שוב או ליצור חדש מהכרטיס של ה-webhook. סוד חדש מחליף את הישן מיד.
ניסיונות חוזרים, יומן המשלוחים ו-webhooks שמתכבים
- השיבו בסטטוס 2xx תוך 10 שניות כדי לאשר הודעה.
- הודעות שנכשלו נשלחות שוב 8 פעמים במשך כ-4 שעות.
- יומן המשלוחים בכל webhook מציג כל הודעה מ-30 הימים האחרונים, עם הסטטוס, התגובה והגוף המלא. לחצו על שלח שוב כדי לשלוח הודעה מחדש.
- webhook מכבה את עצמו כשהכתובת שלו נכשלת 50 פעמים ברצף, כשהמקבל משיב
410 Gone(כך Zapier ו-Make מודיעים שנמחק Zap או תרחיש), או כשמי שהוסיף אותו כבר אין לו גישה לאירוע. הכרטיס שלו מסביר מדוע. הפעילו אותו מחדש לאחר שהבעיה נפתרה: אתם הופכים לאדם שבשמו הוא פועל.
הגדרת webhooks עם עוזר AI
אם חיברתם עוזר AI כמו Claude, אפשר לבקש ממנו להציג את ה-webhooks של האירוע, להוסיף אחד, לשלוח בדיקה או למחוק אחד. הוא צריך ממכם את הכתובת, והוא מציג לכם את סוד החתימה פעם אחת.
שאלות נפוצות
ש: איזו תוכנית אני צריך? ת: Webhooks, Zapier ו-Make כלולים מתוכנית Professional ומעלה ובכל מנוי אירועים. בתוכניות אחרות הכרטיס Webhooks מציין את התוכנית שכוללת אותם.
ש: האם אני צריך חשבון ב-Zapier או ב-Make? ת: כן, כדי להשתמש ב-Zapier או ב-Make צריך שם חשבון. Webhooks לכתובת משלכם לא דורשים דבר נוסף.
ש: כמה webhooks יכולים להיות לאירוע? ת: עד 25, כולל אלה ש-Zapier ו-Make יוצרים.
ש: למה תמונה לא הגיעה ל-webhook שלי? ת: תמונות נשלחות כשהן מופיעות בגלריה. תמונה שממתינה לאישור נשלחת לאחר שאישרתם אותה, ותמונות באלבומים פרטיים לא נשלחות לעולם.
ש: אפשר להשתמש בכתובת על המחשב שלי כדי לבדוק?
ת: לא. Fotify שולחת רק לכתובות https:// ציבוריות. השתמשו בשירות מנהרה, או בכלי לבדיקת בקשות, כדי לבדוק מהמחשב שלכם.
ש: מה קורה ל-webhooks שלי אם אבטל מפתח API? ת: Zapier ו-Make מפסיקים להיות מסוגלים ליצור או להסיר מנויים באמצעות המפתח הזה. מחקו את המנויים שאינכם רוצים מעמוד ה-Webhooks של האירוע.
האם מאמר זה היה מועיל?