שילוב מפתחים

7stamp Webhooks

זָמִין

דחף כל אירוע נאמנות מ-7stamp למערכות שלך בזמן אמת. ללא סקר וללא שיחות API מתוזמנות. אירועים מגיעים כאשר HTTPS POST מבקש בתוך שניות מהתרחשות.

השתמש ב-webhooks כדי לשמור על ה-CRM, ERP או ה-backend המותאם אישית שלך מסונכרנים עם מה שקורה בצד הנאמנות: מי הצטרף, מי קיבל חותמת, מי מימש שובר, מי הפעיל מתנת יום הולדת ומי הפך לבלתי פעיל. ואז המערכות שלך מחליטות מה לעשות עם הנתונים האלה.

פתח את הפניה API פתח את 7stamp Admin

מה אתה יכול לעשות עם webhooks

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

שיקוף היסטוריית נאמנות ל-CRM שלך

כל חותמת, שובר, יום הולדת והפעלת חוסר פעילות נוחתת ברשומת הלקוח ב-CRM שלך. אתה רואה את ציר הזמן המלא של הנאמנות לצד מכירות, שיחות וכרטיסים מבלי להיכנס ל-7stamp.

הפעל מחסנית הודעות משלך

כאשר לקוח מממש שובר, שלח תודה לך 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 
{
  "event_type": "SCAN",
  "scanned_at": "2026-07-23T12:34:56Z",
  "user_card_id": 123,
  "card_template_id": 42,
  "card_template_name": "Coffee Loyalty",
  "stamps_added": 1,
  "stamps_before": 4,
  "stamps_after": 5,
  "amount": 24.5,
  "external_order_id": "order_2048",
  "external_id": "crm_contact_8821",
  "external_source": "hubspot"
}

הגדר ובדוק webhook

01

צור נקודת קצה HTTPS ב-backend שלך, שכבת האינטגרציה CRM, Make webhook, או Zapier Catch Hook. Make ודא שאתה שולט ביעד לפני העתקת ה-URL שלו.

02

ב-7stamp Admin, פתח את Stamp Cards → API & Integrations → Webhooks.

03

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

04

שמור את הגדרות הפרופיל ולאחר מכן הפעל סריקת בדיקה חד פעמית או פעולת כרטיס להפקת אירוע.

05

בדוק את המטען שהתקבל. התאם את External ID ו-External Source לרשומה הצפויה ואשר שהמקלט מחזיר תגובה מוצלחת.

06

הפעל את CRM, שובר או תופעות לוואי של הודעות רק לאחר שיש לך טיפול בטוח ומעקב אחר כשלים.

אפשרויות ללא קוד: Make ו-Zapier

ב-Make, השתמש ב-Webhooks → Custom webhook כדי ליצור URL מקבל ולהדביק אותו בפרופיל 7stamp. ב-Zapier, השתמש ב-Webhooks by Zapier → Catch Hook לאותה מטרה. פרופיל 7stamp הוא הבעלים של המנוי מכיוון שה-API הנוכחי אינו חושף נקודות קצה אוטומטיות של רישום webhook.

חוזה אבטחה ואספקה ​​

השתמש בקטע Webhooks של ההפניה הציבורית של OpenAPI כמקור לסכימת המטען הנוכחית ולמשמעות השדה. דרשו HTTPS, הרחיקו את המקלט URL מיומנים ציבוריים, והפכו את העיבוד לאידמפוטנטי. אשר את הליך אימות הבקשה /signature עבור פרופיל 7stamp שלך במהלך ההטמעה לפני אכיפת שם כותרת ספציפי או מדיניות ניסיון חוזר בייצור.

שאלות נפוצות

האם אוכל לבחור רק אירועי webhook מסוימים?

כן. בחר את סוגי האירועים בהגדרות ה-webhook של פרופיל 7stamp כך שהמקלט יקבל רק את האירועים החשובים לזרימת העבודה שלו.

איך אני מחבר webhooks ל-Make או Zapier?

צור את ה-webhook המקבל ב-Make או Catch Hook ב-Zapier, העתק את ה-URL שנוצר, ואז הדבק אותו בהגדרות ה-webhook של פרופיל 7stamp ושלח אירוע בדיקה.

כיצד עלי להתאים אירוע לאיש הקשר שלי ב-CRM?

השתמש ב-External ID וב-External Source, כאשר קיים. אלו הם המזהים שהשילוב שלך סיפק כאשר הכרטיס נוצר או נסרק.

האם עלי להניח כותרת חתימה או לנסות תזמון חוזר?

לא. השתמש בחוזה המסירה הנוכחי של OpenAPI/profile ואשר את הליך האימות של הפרופיל שלך במהלך ההצטרפות לפני קידוד קשיח של כותרת או הנחה חוזרת.

דפים קשורים

פתח את API מדריך Make מדריך Zapier מדריך REST API מדריך

השלב הבא

מוכן לשלוח את אירוע הכרטיס הראשון?

צור מקלט, הדבק את ה-HTTPS URL שלו בפרופיל, הרץ סריקה חד פעמית, ואמת את ה-External ID התואם לפני הפעלת אוטומציה במורד הזרם.

פתח את 7stamp Admin קרא את ההפניה API