שיקוף היסטוריית נאמנות ל-CRM שלך
כל חותמת, שובר, יום הולדת והפעלת חוסר פעילות נוחתת ברשומת הלקוח ב-CRM שלך. אתה רואה את ציר הזמן המלא של הנאמנות לצד מכירות, שיחות וכרטיסים מבלי להיכנס ל-7stamp.
שילוב מפתחים
7Stamp Webhooks
זָמִיןדחף כל אירוע נאמנות מ-7stamp למערכות שלך בזמן אמת. ללא סקר וללא שיחות API מתוזמנות. אירועים מגיעים כאשר HTTPS POST מבקש בתוך שניות מהתרחשות.
השתמש ב-webhooks כדי לשמור על ה-CRM, ERP או ה-backend המותאם אישית שלך מסונכרנים עם מה שקורה בצד הנאמנות: מי הצטרף, מי קיבל חותמת, מי מימש שובר, מי הפעיל מתנת יום הולדת ומי הפך לבלתי פעיל. ואז המערכות שלך מחליטות מה לעשות עם הנתונים האלה.
מה אתה יכול לעשות עם webhooks
Webhooks הם הצד היוצא של ערימת האינטגרציה. הם משקפים את פעילות הלקוחות והתגמולים למערכות שאתה כבר סומך עליהן עבור מכירות, שירות, ניתוח והודעות.
הפעל מחסנית הודעות משלך
כאשר לקוח מממש שובר, שלח תודה לך SMS משער SMS הקיים שלך. כאשר לקוח מגיע למטרה, פרסם חגיגה ב-Slack. כאשר מישהו הופך ללא פעיל, נתב את התיק למנהל החשבון שלך.
ניתוח כוח ופיוס
הזרם אירועים לתוך הכלי, המחסן או צינור הפיוס BI שלך. התאם מימושי שוברים מול קבלות POS וחשב נאמנות ROI במדדים שלך.
סוגי אירועי כרטיס
SCAN — כרטיס קיבל פעולת scan/stamp.
REWARD_EARNED - פרס הושג בכרטיס.
VOUCHER_ISSUED — הונפק שובר.
VOUCHER_REDEEMED — שובר מומש.
LOTTERY_WIN — הגרלה הביאה לזכייה.
DELIVERY_INSERT — נרשמה זרימת מסירה-הוספה.
CARD_JOINED — לקוח הצטרף לכרטיס.
CARD_CAMPAIGN — התרחש אירוע מסע פרסום בכרטיסים.
BIRTHDAY_GREETING - התרחש אירוע ברכת יום הולדת.
ADMIN_VOUCHER_ISSUE — מנהל מערכת הוציא שובר.
CARD_ADDED_TO_WALLET - לקוח הוסיף את הכרטיס לארנק שלו.
CARD_REMOVED_FROM_WALLET - לקוח הסיר את הכרטיס מהארנק שלו.
בניית מקלט אינטרנט בטוח
אישור לאחר טיפול עמיד
נקודת הקצה שלך צריכה לקבל את HTTPS POST, לאמת את הצורה של אירוע מוצלח או להחזיר צורה של אירוע מוצלח. אל תבצע שיחת CRM איטית או שיחת הודעות לפני האישור, אם ניתן לעמוד בתור בבטחה.
מתאם עם External ID
כל אירוע קשור יכול לשאת את ה-External ID וה-External Source האופציונלי שבהם השתמשת בעת יצירה או סריקה של הכרטיס. השתמש בזוג זה כדי לעדכן את רשומת ה-CRM, POS או ההזמנה שלך מבלי לנחש מתוך שם או דוא"ל.
Make אספקה אימפוטנטית
אחסן מפתח עיבוד עמיד או טביעת אצבע של אירוע לפני הפעלת תופעות לוואי. אם המקלט שלך רואה שוב את אותה מסירה, הוא לא אמור להוסיף פתק, שובר או הודעה כפולים מסוג CRM. התייחס לנקודת הקצה URL כאל סוד.
דוגמה לצורת עומס אירוע
העתק זאת לשלב האוטומציה שלך
json {
"entity": "card_event",
"action": "created",
"entity_id": 707,
"event_id": "8f05e58decec48e09d328f0edebbacf6",
"profile_id": 2,
"profile_name": "Your Business",
"profile_lang": "en",
"data": {
"event_type": "SCAN",
"scanned_at": "2026-10-01T09:19:24.179424",
"user_card_id": 10,
"card_template_id": 14,
"card_template_name": "Collect your stamps!",
"stamps_added": 3,
"stamps_before": 1,
"stamps_after": 4,
"amount": null,
"external_order_id": "ORDER-1001",
"workplace": { "id": 4, "name": "Bar Counter" },
"device_type": null,
"external_id": "odoo_contact_8821",
"external_source": "odoo",
"issued_vouchers": [
{
"id": 174,
"unique_code": "100425813507",
"stamp_number": 4,
"issued_at": "2026-10-01T09:19:24.191836",
"expires_at": "2027-01-01T23:59:59",
"status": "ACTIVE",
"voucher_template_id": 58,
"voucher_description": "Free coffee",
"voucher_image_url": "https://..."
}
],
"achieved_goals": [],
"user": {
"id": 2,
"name": "Anna",
"full_name": "Anna Smith",
"email": "anna@example.com",
"telegram_chat_id": null,
"telegram_username": null,
"whatsapp_phone": null,
"birth_date": null
}
}
}הגדר ובדוק webhook
צור נקודת קצה HTTPS ב-backend שלך, שכבת האינטגרציה CRM, Make webhook, או Zapier Catch Hook. Make ודא שאתה שולט ביעד לפני העתקת ה-URL שלו.
ב-7stamp Admin, פתח את Stamp Cards → API & Integrations → Webhooks.
הוסף את ה-URL של נקודת הקצה. ה-webhook מקבל את כל אירועי הכרטיס של הפרופיל, לכן סנן לפי data.event_type במערכת המקבלת.
שמור את הגדרות הפרופיל ולאחר מכן הפעל סריקת בדיקה חד פעמית או פעולת כרטיס להפקת אירוע.
בדוק את המטען שהתקבל. התאם את External ID ו-External Source לרשומה הצפויה ואשר שהמקלט מחזיר תגובה מוצלחת.
הפעל את CRM, שובר או תופעות לוואי של הודעות רק לאחר שיש לך טיפול בטוח ומעקב אחר כשלים.
אפשרויות ללא קוד: Make ו-Zapier
ב-Make, השתמש ב-Webhooks → Custom webhook כדי ליצור URL מקבל ולהדביק אותו בפרופיל 7Stamp. ב-Zapier, השתמש ב-Webhooks by Zapier → Catch Hook לאותה מטרה. פרופיל 7Stamp הוא הבעלים של המנוי מכיוון שה-API הנוכחי אינו חושף נקודות קצה אוטומטיות של רישום webhook.
חוזה אבטחה ואספקה
השתמש בקטע Webhooks שבתיעוד OpenAPI הציבורי כמקור לסכמת הנתונים הנוכחית. גוף הבקשה הוא מעטפה: profile_id ו-profile_name מציינים את פרופיל 7Stamp, event_id מזהה את האירוע, ואירוע הכרטיס עצמו נמצא ב-data (עבור URL של Make או Zapier המפתח הוא card_event). כל מסירה נחתמת בכותרת אחת, X-Webhook-Signature: t=…,s=…. חשב HMAC-SHA256 באמצעות הסוד של ה-webhook על t ועוד גוף הבקשה הגולמי, קודד את התוצאה ב-hex והשווה אותה ל-s; הסוד נמצא בדף ה-webhook ב-7Stamp Admin. השתמש ב-X-Webhook-Event-Id כדי להתעלם ממסירות חוזרות: ניסיון חוזר נחתם מחדש עם t חדש. אפשר גם להגן על נקודת הקצה באמצעות Basic Auth. דרוש HTTPS והרחק את ה-URL של המערכת המקבלת מלוגים ציבוריים.
שאלות נפוצות
האם אוכל לבחור רק אירועי webhook מסוימים?
לא. webhook של 7Stamp מקבל את כל אירועי הכרטיס של הפרופיל. סנן לפי data.event_type במערכת המקבלת; ב-Make וב-Zapier האירוע מגיע תחת card_event, לכן סנן לפי card_event.event_type.
איך אני מחבר webhooks ל-Make או Zapier?
צור את ה-webhook המקבל ב-Make או Catch Hook ב-Zapier, העתק את ה-URL שנוצר, ואז הדבק אותו בהגדרות ה-webhook של פרופיל 7Stamp ושלח אירוע בדיקה.
כיצד עלי להתאים אירוע לאיש הקשר שלי ב-CRM?
השתמש ב-data.external_id, ואם קיים, גם ב-data.external_source: הם חוזרים בכל webhook עבור כרטיסים שהנפקת דרך ה-API עם ID משלך. ללקוח שלקח את הכרטיס בעצמו אין External ID, לכן התאם אותו לפי data.user.email. כתובת “Hide My Email” של Apple היא כתובת ממסר, ולא הכתובת שב-CRM שלך.
איך לוודא ש-webhook הגיע מ-7Stamp?
פצל את הכותרת X-Webhook-Signature ל-t ול-s, חשב HMAC-SHA256 באמצעות הסוד של ה-webhook מ-7Stamp Admin על t ועוד גוף הבקשה הגולמי, קודד את התוצאה ב-hex והשווה אותה ל-s. קח את t בדיוק כפי שנשלח ואת הגוף כבתים הגולמיים שהתקבלו, לפני כל ניתוח JSON. התעלם ממסירה שאת ה-X-Webhook-Event-Id שלה כבר עיבדת: ניסיון חוזר נחתם מחדש עם t חדש.
דפים קשורים
השלב הבא
מוכן לשלוח את אירוע הכרטיס הראשון?
צור מקלט, הדבק את ה-HTTPS URL שלו בפרופיל, הרץ סריקה חד פעמית, ואמת את ה-External ID התואם לפני הפעלת אוטומציה במורד הזרם.