צור כרטיס לאחר איש קשר חדש CRM
השתמש באיש הקשר CRM ID בתור External ID, צור הזמנה לכרטיס 7stamp, ולאחר מכן שלח את ההתקנה המוחזרת URL דרך האימייל הרגיל שלך, SMS, או SMS.
מדריך לאוטומציה ללא קוד
חבר את 7stamp ל-Make - צעד אחר צעד
מדריך יישוםהשתמש ב-Make כדי לחבר את 7stamp עם CRM, POS, חנות מקוונת, גיליון אלקטרוני, כלי הודעות או כל מערכת שיכולה לשלוח נתונים לתרחיש. המסלול המוכן לייצור היום הוא אפליקציית HTTP של HTTP לשיחות 7stamp API וה-Custom webhook של Make לאירועי 7stamp נכנסים.
אין עדיין אפליקציית 7stamp ציבורית בבורר האפליקציות של Make. אל תחכה לאחד: הוסף HTTP → Make a request, השתמש בשיטה המדויקת URL, כותרת Bearer ו-JSON למטה, ולאחר מכן מפה את השדות ממודול המקור שלך. זהו אותו 7stamp Integration API שמחבר עתידי ישתמש בו.
Choose the first scenario that matches your workflow
התחל עם אירוע אחד ותוצאה אחת. לאחר שנתוני הבדיקה נכונים, הוסף מסננים, נתבים, עדכוני CRM והודעות מעקב סביבו.
הוסף חותמות לאחר הזמנה בתשלום
הפעל את התרחיש מהזמנת POS בתשלום או מסחר אלקטרוני. מפה את הלקוח היציב שלה ID והזמינו ID לתוך סרוק כרטיס, ולאחר מכן השתמש בכמות או בספירת חותמות מפורשת.
שלח מעקב תגמול
כאשר אירוע כרטיס מדווח על פרס או שובר, ענף את התרחיש: עדכן את ה-CRM, הודע לצוות ושלח דחיפה של כרטיס ארנק או אימייל רק בעת הצורך.
טפל במערכת ללא אפליקציית Make מקורית
השתמש במודול HTTP של Make כדי להתקשר ישירות ל- 7stamp. זוהי הבחירה האוניברסלית עבור POS, ERP, מנוע הזמנה, או כל שירות ראשון מסוג API.
7stamp להתקשר מ- Make HTTP
עבור כל כרטיס למטה, הוסף את HTTP → Make a requestCON, ולאחר מכן הגדר את השיטה ו-TMXST6 בדיוק כפי שמוצג. השתמש באותו מפתח Bearer עבור כל בקשה. המיפוי הנדרש אומר לך מה לספק מהטריגר CRM, POS או מסחר אלקטרוני.
Make טריגר
Webhooks → Custom webhook קבל אירוע כרטיס
צור Custom webhook ב-Make, העתק את ה-URL שלו, ואז הדבק את ה-URL הזה בהגדרות ה-webhook של פרופיל 7stamp. זה מתחיל תרחיש כאשר 7stamp שולח אירוע כגון SCAN, REWARD_EARNED או VOUCHER_ISSUED.
- ב-Make
- Webhooks → Custom webhook → הוסף; תן לו שם ברור והעתק את ה-URL שנוצר שלו.
- ב-7stamp
- Admin → API & Integrations → Webhooks; הדבק את ה-URL, בחר סוגי אירועים, שמור ואז צור אירוע בדיקה.
HTTP פעולת
POST /cards/invite יצירת Card Invite
יצירת התקנה אישית חדשה של URL וקוד הוסף מסירה עבור איש קשר חיצוני אחד.
- נדרש
- external_id - מפה את ה-CRM/contact היציבה שלך ID, לא שם.
- לאחר מכן השתמש ב-
- Map install_url מהתגובה אל שלב העדכון שלך בדוא"ל, SMS או CRM.
פעולה HTTP
POST /cards/invite/bulk בכמות גדולה צור Card Invites
יוצר עד 100 קישורי הזמנה בבקשה אחת. השתמש בו עבור העברה מבוקרת או מסע פרסום, לא לייצוא של אנשי קשר בלתי מוגבל.
- פריטי
- נדרשים - מערך JSON של 1-100 אובייקטים בודדים של בקשת הזמנה.
- בדוק את
- קרא את success_count, error_count וכל תוצאה לפני שליחת קישורים כלשהם.
HTTP פעולה
GET /cards Find Cards
מוצא רשומות כרטיס על ידי External ID, עם מסנני תבנית ומקור אופציונליים.
- נדרש פרמטר שאילתה
- external_id.
- אופציונלי
- external_source ו-template_id מצמצמים את החיפוש כאשר למערכת אחת יש תוכניות מרובות.
פעולת HTTP
GET /cards/{user_card_id} קבל פרטי כרטיס
קורא את המצב המלא של כרטיס אחד כאשר שלב קודם החזיר את ה-User Card ID הפנימי שלו.
- נדרש
- החלף את {user_card_id} ב-ID הפנימי שהוחזר על ידי תגובת 7stamp מהימנה.
- הימנע מ-
- אל תנחש או אחסן כרטיס ID מפרופיל אחר.
HTTP פעולה
POST /cards/scan סרוק כרטיס
מוסיפה חותמות מסכום רכישה או ספירה מפורשת. הוא מקבל User Card ID או External ID ויכול לשמור את הפניה להזמנה החיצונית. זהות
- Identity
- השתמש ב-external_id וב-external_source אופציונלי; user_card_id מנצח אם שניהם מסופקים.
- רכישה
- השתמש בסכום עבור כרטיסים מבוססי סכום או stamps_count עבור מספר מפורש; stamps_count מקבל עדיפות.
- עקיבות
- מפה את external_order_id מההזמנה בתשלום /receipt כך שניתן יהיה להתאים אירועי 7stamp בחזרה.
HTTP פעולה
GET /templates List Templates
מפרט את תבניות הכרטיס הזמינות למפתח API. השתמש בו כדי לבדוק את החיבור או כדי לבחור תבנית באופן דינמי.
- בדיקה ראשונה
- זוהי הבקשה הראשונה הבטוחה ביותר: אין לה גוף והיא אינה משנה את נתוני הלקוח.
- מפה מאוחר יותר
- השתמש במזהה של תבנית פעילה בתור template_id רק כאשר לפרופיל יש יותר מתבנית פעילה אחת.
HTTP פעולה
GET /templates/{template_id}/design Get Template Design
מחזירה את הגדרות העיצוב החזותי עבור תבנית ידועה, שימושית כאשר מערכת אחרת צריכה להציג בחירת כרטיס עקבית.
HTTP פעולה
POST /vouchers/issue הנפקת שובר
מנפיקה שובר לבעל כרטיס המזוהה על ידי External ID או User Card ID.
- שובר
- נדרש.short_description. כוון את הכרטיס עם external_id או user_card_id ידוע. תוקף
- Validity
- השתמש ב-validity_type עם validity_value, או קרא את הפניה OpenAPI לקבלת תאריך תפוגה קבוע.
HTTP פעולה
POST /messages/send שלח הודעה
שולח תוכן לבעל הכרטיס באמצעות דחיפה של כרטיס ארנק ודוא"ל /or, בכפוף לערוצים המוגדרים ולכללי ההסכמה.
- דחיפת כרטיס
- card_push_text מוגבל ל-20 תווים ודורש כרטיס ארנק מותקן.
- דוא"ל
- שלח נושא פלוס גוף; HTML בסיסי נתמך בגוף.
Make מודול
Full 7stamp endpoint URL HTTP → Make a request
זהו מודול Make שקורא לכל מסלול 7stamp למעלה. השתמש ב-URL מלא, בחר את השיטה המתועדת, הוסף את הכותרת Bearer והשתמש ב-JSON רק כאשר המסלול זקוק לגוף.
- כותרת בסיס URL
- https://api.7loc.com/cards-api
- Header
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json עבור בקשות POST.
שלושה תרחישי Make שאתה יכול לבנות בדיוק כפי שנכתב
השמות שלהלן הם מודולי Make האמיתיים. התחל מהתרחיש הראשון, הפעל אותו כנגד איש קשר חד פעמי, ורק לאחר מכן הוסף נתבים, מסננים או תזמון ייצור.
1. איש קשר חדש CRM → שלח קישור לכרטיס 7stamp
תוצאה צפויה: הלקוח מקבל את ה-install_url המוחזר על ידי 7stamp; ה-CRM שלך יכול לשמור את ה-URL הזה באותה רשומת איש קשר.
- 1 צור תרחיש והוסף את ה-New/Created Contact טריגר של CRM שלך. עבור Kommo, בחר את טריגר יצירת הקשר והפעל אותו פעם אחת כדי לטעון איש קשר לדוגמה.
- 2 הוסף HTTP → Make a request. הגדר את השיטה ל-POST ו-URL ל-https://api.7loc.com/cards-api/cards/invite.
- 3 הוסף Authorization: Bearer YOUR_7STAMP_API_KEY ו-Content-Type: application/json. בגוף JSON, מפה את איש הקשר CRM ID לתוך external_id והגדר את external_source לתווית קבועה כגון kommo.
- 4 הפעל את מודול HTTP פעם אחת. ודא שלפלט יש install_url, delivery_insert_code, external_id ו-template_id.
- 5 הוסף את מודול עדכון הדוא"ל שלך /SMS/CRM לאחר HTTP ומפה את install_url מפלט HTTP. שמור את ה-URL באיש הקשר CRM אם הצוות חייב לשלוח אותו מחדש מאוחר יותר.
בדוק את: POST /cards/invite תמיד יוצר הזמנה חדשה. השתמש תחילה ב-Find Cards אם הכלל העסקי שלך הוא להימנע מהזמנה נוספת של איש קשר קיים.
2. הזמנה בתשלום ← הוסף חותמות נאמנות
תוצאה צפויה: תגובת סריקה מוצלחת כוללת הצלחה, scan_id, stamps_added ומצב הכרטיס שלאחר הסריקה לשלב הבא שלך.
- 1 התחל מהדק POS/ecommerce הזמנה בתשלום. Make בטוח שהדגימה שלו מכילה לקוח יציב ID ואת ההזמנה/receipt ID.
- 2 הוסף HTTP → Make a request עם POST https://api.7loc.com/cards-api/cards/scan ואותה כותרת Bearer.
- 3 מפת external_id מהלקוח, external_source משם המערכת ו-external_order_id מההזמנה ID. הוסף סכום עבור כרטיסים מבוססי סכום, או stamps_count עבור מספר מפורש של חותמות.
- 4 Run once עם הזמנת בדיקה. בדוק את דגל ההצלחה שהוחזר ואת stamps_added לפני הפעלת לוח הזמנים של התרחיש.
- 5 אופציונלי להוסיף מסנן לאחר שלב HTTP: המשך רק כאשר ההצלחה היא אמיתית, ולאחר מכן כתוב scan_id או stamps_added בחזרה לרשומת order/CRM.
בדוק את: השתמש באותו external_order_id בניסיונות חוזרים כדי שניתן יהיה לאתר את הסדר באירועי webhook מאוחרים יותר; אין להעניק בולים פעמיים לאחר ריצה לא ברורה שנכשלה.
3. אירוע 7stamp → עדכן את CRM
תוצאה צפויה: Make מקבל את אירוע 7stamp באופן מיידי ויכול למצוא את רשומת CRM התואמת דרך external_id ו- external_source.
- 1 צור תרחיש Make נפרד. הוסף Webhooks → Custom webhook, בחר הוסף, תן לזה 7stamp-card-events, והעתק את ה-URL שנוצר.
- 2 ב-7stamp Admin, פתח את API & Integrations → Webhooks. הוסף את ה-URL הזה ובחר קבוצה קטנה של אירועים, למשל SCAN ו-REWARD_EARNED.
- 3 צור סריקת בדיקה חד פעמית או אירוע כרטיס ב-7stamp. חזור ל-Make והשתמש ב-Run once כדי לאפשר ל-Make לקבוע את מבנה נתוני האירוע.
- 4 הוסף שלב חיפוש CRM באמצעות external_id. הוסף מסנן או נתב ב-event_type כדי ש-SCAN, REWARD_EARNED ו-VOUCHER_ISSUED יוכלו לבצע פעולות שונות.
- 5 הוסף את הפעולה CRM update/note. מפה את scanned_at, stamps_after, external_order_id ו-issued_vouchers רק כאשר שדות אלה קיימים עבור סוג האירוע שנבחר.
בדוק את: שמור על ה-webhook URL פרטי. בדוק אירוע אמיתי לפני הפעלת הודעות בלתי הפיכות, שוברים או שינויים CRM.
קבל את מפתח 7stamp API לפני פתיחת Make
אלו מסכי ה-7stamp Admin המדויקים. צור את המפתח פעם אחת, העתק אותו לחיבור HTTP המאובטח של Make/keychain, ואז הסר אותו מיד מהלוח שלך. מסך
הכן את החיבור לפני בניית
צור מפתח API אחד לכל סביבה
ב-7stamp Admin, עבור אל API & Integrations → API Keys → Add API Key. אחסן את הערך בחיבור המפתח Make HTTP API /keychain כאשר אפשרות זו זמינה. לעולם אל תמפה את המפתח משדה טקסט, אל תציב אותו בהערה או תשתמש בו בזרימת עבודה הפונה לדפדפן. מפתח שייך למקום עבודה אחד 7stamp/profile.
השתמש ב-External ID
Map the immutable ID from your CRM, POS, or commerce platform—for example a CRM contact ID or customer UUID. Add External Source such as hubspot, shopify, or poster when the same identifier could appear in more than one system.
החלט איזו תבנית חלה על
כאשר לפרופיל 7stamp המחובר יש תבנית כרטיס פעילה אחת, ניתן להשאיר את התבנית ריקה. עם מספר תבניות, מפה או בחר template_id בכוונה כך שכל הזמנה וסריקה תגיע לתוכנית הנאמנות המיועדת.
הגדרה מדויקת של Make HTTP: צור כרטיס אחד להזמין
העתק זאת לשלב האוטומציה שלך
http Method: POST
URL: https://api.7loc.com/cards-api/cards/invite
Headers:
Authorization: Bearer YOUR_7STAMP_API_KEY
Content-Type: application/json
Body type: Raw / JSON
{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"template_id": 42
}בנה ובדוק את תרחיש ה-Make הראשון שלך
ב-7stamp Admin, צור מפתח ב-API & Integrations → API Keys → Add API Key. השתמש בפרופיל בדיקה נפרד/key כאשר הגדרת החשבון שלך מאפשרת זאת.
ב-Make, צור תרחיש והוסף את טריגר המקור. הפעל אותו פעם אחת לפני המיפוי כדי שתוכל לראות איש קשר אמיתי לדוגמה או הזמנה בתשלום.
לחץ על הפלוס הבא, חפש HTTP ובחר Make בקשה. הגדר את השיטה, URL המלא והכותרות מכרטיס הפעולה בדף זה.
השתמש ב-GET https://api.7loc.com/cards-api/templates בתור הבקשה הראשונה. התגובה המוצלחת שלו מוכיחה שהמפתח עובד מבלי לשנות שום נתוני לקוח.
עבור מסלולי POST, בחר application/json והדבק את צורת הגוף ממדריך זה. מפה External ID יציב; הוסף template_id רק אם לפרופיל יש מספר תבניות פעילות.
הפעל עם איש קשר חד פעמי, בדוק את הפלט של HTTP, ורק אז ממפה את שדות התגובה המדויקים שלו למודול ה-CRM, הדואר האלקטרוני או ההודעות הבא.
מתי כדאי להשתמש ב-Make HTTP?
השתמש ב-HTTP עבור 7stamp כעת: זהו המסלול המתועד, המוכן לייצור, לא נפילה מופחתת. בחר בו בכל פעם שאתה צריך פעולת 7stamp, מסלול API חדש, או חיבור POS/ERP מותאם אישית. ההתייחסות OpenAPI היא מקור האמת עבור השיטה, הנתיב המלא, הגוף וסכימת התגובה; מפתח הנושא והבסיס URL נשארים זהים.
קבל אירועי 7stamp ב-Make
לתרחיש מונחה אירועים, הוסף Webhooks → Custom webhook וצור webhook. העתק את ה-URL שלו, פתח את API & Integrations → Webhooks בפרופיל 7stamp, הדבק את ה-URL, בחר את סוגי האירועים, שמור ושלח אירוע בדיקה אמיתי. פרופיל 7stamp הוא הבעלים של המנוי הזה; ה-API הנוכחי אינו חושף נקודות קצה אוטומטיות ל-webhook subscribe/unsubscribe.
אין צורך במחבר Make ציבורי
ההוראות בדף זה משתמשות במודולי Make הזמינים לכל חשבון Make. אם אתה רוצה מודול 7stamp מקורי עתידי במקום HTTP, שלח לנו את זרימת העבודה שאתה צריך; עד אז, HTTP ו-Custom webhook מכסים כל פעולת 7stamp מתועדת.
שאלות נפוצות
אני לא יכול למצוא 7stamp ב-Make. האם אני עדיין יכול להפוך את זה לאוטומטי?
כן. אין היום אפליקציית 7stamp ציבורית ב-Make. הוסף בקשה ל-HTTP > Make, השתמש בנקודת הקצה המלאה של 7stamp URL, ושלח את Authorization: Bearer ואחריו מפתח 7stamp API שלך. HTTP יכול להתקשר לכל נקודת קצה מתועדת.
מאיפה אני משיג את האסימון לחיבור Make?
ב-7stamp Admin, פתח את API Integrations, ואז API Keys, ואז Add API Key. המפתח מוקף למקום העבודה /profile שיצר אותו, אז השתמש בפרופיל בדיקה עבור תרחישי בדיקה במידת האפשר.
איזה מזהה עלי למפות בתור External ID?
השתמש במזהה היציב ממערכת המקור, רצוי איש קשר CRM ID או לקוח UUID. אל תשתמש בשם תצוגה. מספר טלפון או אימייל יכולים לעבוד, אך יכולים להשתנות ויש לטפל בהם באופן עקבי.
כיצד אוכל להכניס אירועי 7stamp ל-Make?
צור Webhooks > Custom webhook ב-Make, ולאחר מכן הדבק את ה-URL שנוצר שלו בהגדרות ה-webhook של פרופיל 7stamp. השתמש במסנן Make או בנתב לאחר המסירה כדי לטפל ב- event_type הנכנס.
השלב הבא
Ready to automate the first loyalty action?
Create the API key, test List Templates, and build one invite or scan scenario with a disposable contact. Add routers and messaging only after that simple flow is reliable.