מדריך לאוטומציה ללא קוד

חבר את 7stamp ל-Zapier - צעד אחר צעד

מדריך יישום

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

אין אפליקציית 7stamp ציבורית בשוק של Zapier. השתמש ב-API by Zapier → API Request היכן שהוא זמין: הוא מאחסן מפתח API סטטי בחיבור האפליקציה במקום לחשוף אותו בשלב Zap. השתמש ב-Webhooks by Zapier רק עבור אירועי Catch Hook נכנסים; אל תכניס מפתח 7stamp Bearer לשדה פעולה גלוי של Webhooks.

פתח את Zapier פתח את הפניה API

התחל עם זאפ ליניארי וניתן לבדיקה

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

צור הזמנה מאיש קשר CRM

טריגר על איש קשר חדש או מוסמך, מפה את ה-CRM ID שלו ל-External ID, צור הזמנה לכרטיס והעביר את ההתקנה המוחזרת URL למייל או לשלב SMS.

הוסף חותמות לאחר התשלום

הפעל מההזמנה בתשלום או מהקבלה שנסגרה, מפה את זהות הלקוח והזמנת ID, ולאחר מכן השתמש ב-Scan Card עם סכום ההזמנה או מספר הבולים המפורש.

הנפק שובר שחזור חד פעמי

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

כתוב אירועי כרטיס בחזרה ל-CRM

שלך השתמש ב-Webhooks by Zapier > Catch Hook כדי לקבל אירועי כרטיס 7stamp. התאם את ה-External ID שהוחזר לרשומת CRM והוסף את ההערה, התג או המשימה הרלוונטיים.

7stamp פעולות כדי להתקשר מ- API מאת Zapier

הוסף את API by Zapier → API Request לאחר ההדק שלך. צור חיבור מפתח 7stamp API אחד, ולאחר מכן בחר את השיטה המדויקת ואת URL המלא למטה. כל פעולה מחזירה שדות שתוכלו למפות לשלב ה-Zap הבא.

API על ידי Zapier פעולת POST /cards/invite

צור Card Invite

יצירת כרטיס ארנק חדש להתקין URL וקוד מסירה-הוסף עבור איש קשר חיצוני אחד.

נדרש
external_id מהטריגר CRM/contact.
השלב הבא
מיפוי install_url למייל, SMS או שדה CRM.
API לפי פעולה Zapier POST /cards/invite/bulk

בכמות גדולה יצירת Card Invites

יוצר עד 100 קישורי הזמנה מאצוות JSON מבוקרת.

נדרש מערך פריטי
עם 1-100 אובייקטי הזמנה.
בדוק את
קרא את success_count, error_count וכל תוצאה לפני המסירה.
API לפי Zapier פעולה POST /cards/scan

Scan Card

מוסיף חותמות לפי User Card ID או External ID, עם כמות, ספירת בולים, הזמנה ID ונתוני קבלה אופציונליים. זהות

Identity
external_id בתוספת external_source אופציונלי; user_card_id מנצח אם שניהם נוכחים. כלל חותמת
Stamp rule
stamps_count מקבל עדיפות על פני כמות.
API לפי Zapier פעולה POST /vouchers/issue

Issue Voucher

מנפיק שובר ישירות לבעל הכרטיס.

שובר
נדרש.short_description ויעד external_id או user_card_id ידוע. תוצאה של
Result
מפה את unique_code, סטטוס או expires_at להערה או הודעה של CRM.
API על ידי Zapier פעולה POST /messages/send

Send Message

שולח תוכן דואר אלקטרוני של ארנק ו-/or לבעל הכרטיס.

דחיפת כרטיס
card_push_text מוגבל ל-20 תווים.
דוא"ל
נושא פלוס גוף; התוצאה מדווחת אם המסירה הייתה בתור.
API לפי Zapier פעולה GET /cards

Find Cards

מוצא רשומות כרטיס על ידי External ID, עם מסנני מקור ותבנית אופציונליים.

נדרש
external_id כפרמטר שאילתה.
השתמש תחילה ב-
השתמש לפני יצירת הזמנה כאשר הכלל שלך מונע הזמנות כפולות.
API על ידי Zapier פעולה GET /cards/{user_card_id}

קבל פרטי כרטיס

קורא את המצב של כרטיס על ידי 7stamp ID הפנימי שלו.

נדרש
החלף את {user_card_id} ב-ID שהוחזר על ידי 7stamp.
פלט שימושי
stamps_count, מצב הארנק ו-active_vouchers_count.
API לפי Zapier פעולה GET /templates

List Templates

מפרט תבניות הזמינות לפרופיל המחובר ומאמת את החיבור API.

מבחן ראשון
קרא לזה לפני כל פעולת כתיבה: זה לא משנה נתוני לקוחות.
השתמש מאוחר יותר
מזהה פעיל הופך ל-template_id כאשר קיימות מספר תבניות.
API על ידי פעולה Zapier GET /templates/{template_id}/design

Get Template Design

מאחזר הגדרות עיצוב של תבנית עבור תבנית ידועה ID.

טריגר Zapier Webhooks by Zapier → Catch Hook

קבלת אירועי כרטיסים

Catch Hook מעניק ל-Zapier HTTPS URL ייחודי. הדבק אותו בהגדרות ה-webhook של 7stamp Admin ובדוק אותו עם אירוע כרטיס אמיתי.

ב-Zapier
השתמש ב-Catch Hook עבור נתוני אירועים מנותחים; השתמש ב-Catch Raw Hook רק כאשר אתה צריך גם כותרות בקשות גולמיות/body.
לְהַתְאִים
מצא את איש הקשר CRM באמצעות external_id ו-external_source אופציונלי מהאירוע.

שלוש זרימות עבודה של Zapier שתוכלו לבנות צעד אחר צעד

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

1. איש קשר מוסמך CRM → הנפק כרטיס

תוצאה צפויה: שלב ה-Zap הבא מקבל install_url ויכול לשלוח אותו ללקוח או לכתוב אותו בחזרה לרשומת CRM.

  1. 1 צור זאפ ובחר באירוע CRM כלומר איש קשר זכאי לנאמנות. בדוק את הטריגר ואשר שיש לך את ה-ID הבלתי ניתן לשינוי של איש הקשר.
  2. 2 הוסף API by Zapier → API Request. צור או בחר את חיבור המפתח 7stamp API, בחר POST, והגדר את URL ל-https://api.7loc.com/cards-api/cards/invite.
  3. 3 הגדר את הגוף ל-JSON. מיפוי CRM ID ל-external_id, הגדר external_source קבוע כגון קוממו, והוסף template_id רק כאשר יותר מתבנית 7stamp אחת פעילה.
  4. 4 בדוק את הפעולה. אשר שהתגובה מכילה install_url ו-delivery_insert_code עבור אותו external_id.
  5. 5 הוסף את עדכון CRM, דוא"ל או פעולת SMS. מפה את install_url מתגובת API; אין לבצע קוד קשיח או להעתיק מבחן URL.

בדוק את: צור Card Invite תמיד מחזיר הזמנה חדשה. הוסף תחילה בקשת Find Cards או מסנן Zapier אם המדיניות שלך היא הזמנה אחת לכל איש קשר.

2. הזמנה בתשלום → חותמות פרס

תוצאה צפויה: ההזמנה יוצרת סריקת 7stamp הניתנת למעקב וה-Zap יכול להקליט stamps_added או scan_id במערכת המקור.

  1. 1 השתמש בטריגר קבלה של הזמנה בתשלום /Closed ובדוק אותו. אשר שהלקוח ID וההזמנה הייחודית ID נוכחים שניהם לפני שתמשיך.
  2. 2 הוסף API by Zapier → API Request עם POST https://api.7loc.com/cards-api/cards/scan ובחר באותו חיבור 7stamp.
  3. 3 שלח JSON עם external_id, external_source, external_order_id, וכל אחד מהסכום עבור תבניות מבוססות סכום או stamps_count עבור פרס בול מפורש.
  4. 4 בדיקה עם הזמנה חד פעמית. בדוק הצלחה, scan_id ו-stamps_added בתגובה.
  5. 5 הוסף מסנן שנמשך רק לאחר תגובה מוצלחת, ולאחר מכן עדכן את ההזמנה /CRM עם התוצאה המאושרת.

בדוק את: אם ה-Zap מופעל מחדש, בדוק את ההזמנה המקורית לפני שליחת סריקה נוספת. שמור על external_order_id יציב כדי שניתן יהיה ליישב את האירוע מאוחר יותר.

3. אירוע 7stamp ← צור הערה או משימה CRM

תוצאה צפויה: Zapier מקבל אירוע 7stamp מנותח, מוצא את הלקוח על ידי external_id ויוצר את המעקב המתאים.

  1. 1 צור זאפ חדש עם Webhooks by Zapier כטריגר. בחר Catch Hook, המשך והעתק את ה-URL הייחודי המוצג בשלב הבדיקה.
  2. 2 ב-7stamp Admin, פתח את API & Integrations → Webhooks, הוסף את Catch Hook URL, בחר רק סוגי אירועים נחוצים ושמור.
  3. 3 גורם לסריקת בדיקה אמיתית או אירוע כרטיס. בחזרה ב-Zapier, לחץ על Test trigger ואשר event_type, external_id ו-external_source מגיעים כשדות לדוגמה.
  4. 4 הוסף פעולת CRM חיפוש איש קשר באמצעות external_id. הוסף כלל מסנן או נתיבים עבור event_type, למשל הפרד את SCAN מ-REWARD_EARNED.
  5. 5 צור הערה CRM/task ומפה רק שדות שקיימים עבור אותו אירוע, כגון scanned_at, stamps_after, external_order_id או issued_vouchers.

בדוק את: A Catch Hook URL הוא סוד. אם ה-Zap מועבר לבעלים אחר, עדכן את ה-URL ב-7stamp Admin לפני שתסתמכו עליו.

צור את מפתח 7stamp API לפני בניית ה-Zap

אלו הם השלבים בצד 7stamp. עשה זאת פעם אחת, ולאחר מכן השתמש במפתח רק בתוך החיבור API by Zapier - לא בשדה פעולה של Webhooks by Zapier או בהערה. מסך

7stamp Admin API & אינטגרציות עם הפעולה Add API Key
פתח את API & Integrations, בחר API Keys, ואז צור מפתח נפרד עבור ה-Zap שבו הגדרת החשבון שלך מאפשרת זאת. מפתח
חדש שנוצר 7stamp API מוכן להעתקה
העתק את המפתח לחיבור המאובטח API על ידי חיבור Zapier, לא לצעד Webhooks רגיל או מסמך משותף.

כללי חיבור המונעים חוסר התאמה של נתונים

שמור את מפתח API בחיבור API by Zapier

ב-7stamp Admin, בחר API & Integrations → API Keys → Add API Key. ב-API מאת Zapier, צור חיבור מפתח API עם כותרת סטטית Authorization המכילה את Bearer ואחריו מפתח זה. API מאת Zapier שומר על האישור בחיבור במקום צעד Zap גלוי; הגבל את הגישה לחיבור וסובב את המפתח אם הוא חשוף. מפת

External ID ו-External Source באופן עקבי

External ID הוא מזהה לקוח יציב משלך; External Source תוויות מאיפה זה הגיע, למשל hubspot, bitrix24, shopify או פוסטר. השתמש באותו זוג לתהליכי יצירה, חיפוש, סריקה, שובר ו-webhook.

דע איזה מזהה כרטיס מנצח בפעולות מיקוד על כרטיס

מקבלים User Card ID או External ID. כאשר שניהם קיימים, User Card ID מקבל עדיפות. השתמש ב-ID הפנימי רק לאחר שהוא הוחזר על ידי שלב 7stamp מהימן; אחרת העדיפו את מערכת המקור External ID.

API מדויק לפי בקשה Zapier: הענק חותמת אחת

העתק זאת לשלב האוטומציה שלך http 
Method: POST
URL: https://api.7loc.com/cards-api/cards/scan
Headers:
  Authorization: Bearer YOUR_7STAMP_API_KEY
  Content-Type: application/json
Data:

{
  "external_id": "crm_contact_8821",
  "external_source": "hubspot",
  "stamps_count": 1,
  "external_order_id": "order_2048"
}

בנה את ה-Zap הראשון שלך

01

צור מפתח 7stamp API ב-Admin: API & Integrations → API Keys → Add API Key. השתמש במפתח בדיקה נפרד/profile כאשר זמין.

02

ב-Zapier, צור Zap ובדוק את טריגר המקור. השתמש בדוגמה אמיתית כך שאנשי הקשר ID, הלקוח ID, הזמנת ID והסכום יהיו זמינים למיפוי.

03

הוסף API by Zapier → API Request. צור חיבור 7stamp עבור הכותרת הסטטית Bearer Authorization במקום לשים את הסוד בשדה פעולה Webhooks by Zapier.

04

התקשר תחילה ל-GET https://api.7loc.com/cards-api/templates. זה מאשר את פעולת המפתח ומראה אילו מזהי תבניות פעילים זמינים מבלי לשנות את נתוני הלקוח.

05

בחר POST /cards/invite או POST /cards/scan, הגדר את JSON כסוג הגוף ומפה את ה-External ID היציב בתוספת השדות הרלוונטיים של template/order מהטריגר.

06

הפעל את הפעולה עם איש קשר חד פעמי, בדוק את שדות התגובה המדויקים שלו, ולאחר מכן מפה את השדות האלה לשלב הבא של CRM, אימייל או הודעות לפני פרסום ה-Zap.

השתמש בבקשה האוניברסלית רק עבור מסלולים מתועדים

השתמש ב-API by Zapier עבור בקשת 7stamp עם מפתח Bearer API: הוא שומר מפתחות כותרת סטטיים בחיבור אפליקציה. השתמש ב-Webhooks by Zapier עבור מסירת אירוע Catch Hook, לא כמיקום המועדף עבור סוד 7stamp. שמור את הבסיס URL ב-https://api.7loc.com/cards-api, השתמש בהפניה הציבורית של OpenAPI עבור סכמות מדויקות, ולעולם אל תשלח אישורים או נתוני לקוחות ל-URL לא מאומת.

קבל אירועי 7stamp דרך Catch Hook

צור Webhooks by Zapier → Catch Hook, העתק את ה-URL הייחודי המוצג בהגדרת הבדיקה, הדבק אותו בהגדרות ה-webhook של פרופיל 7stamp, בחר את סוגי האירועים ולאחר מכן שלח סריקת בדיקה אמיתית או אירוע כרטיס. השתמש ב-External ID ו-External Source של מטען האירוע כדי לאתר את איש הקשר הנכון של CRM. בחר Catch Raw Hook רק כאשר אתה צריך ספציפית את הגוף והכותרות הבקשות שלא מנותחו.

השתמש במסלול המאובטח Zapier כעת

API מאת Zapier ו-Catch Hook מספיקים עבור כל פעולה ואירוע כרטיס ציבורי של 7stamp API. אם אתה צריך אפליקציית 7stamp Zapier מקורית עתידית, שלח לנו את הפעולה המדויקת /trigger שהצוות שלך משתמש בו הכי הרבה.

שאל על מחבר מקורי

שאלות נפוצות

היכן אוכל למצוא את האפליקציה 7stamp ב-Zapier?

אין היום אפליקציית שוק 7stamp ציבורית. השתמש ב-API by Zapier → API Request עבור שיחות 7stamp API וב-Webhooks by Zapier → Catch Hook עבור אירועי 7stamp נכנסים.

איפה אני יוצר את האסימון Zapier?

צור מפתח 7stamp API ב-Admin תחת API & Integrations → API Keys → Add API Key. אחסן אותו ככותרת סטטית Bearer Authorization בחיבור API by Zapier, לא בשדה פעולה גלוי של Webhooks by Zapier.

איך Zapier יכול לקבל אירוע בול או שובר?

צור Catch Hook ב-Webhooks by Zapier, הדבק את ה-URL שנוצר בהגדרות ה-webhook של פרופיל 7stamp, בחר את האירועים ושלח אירוע בדיקה לפני הפעלת עדכוני CRM.

האם עלי לבחור Zapier או Make?

בחר ב-Zapier עבור זרימת עבודה ליניארית ברובה של פעולת טריגר. בחר Make כאשר אתה זקוק לנתבים, טרנספורמציות מורכבות או תרחישים ארוכים של ריבוי סניפים. שניהם משתמשים באותו מפתח ונקודות קצה 7stamp API.

דפים קשורים

פתח את Zapier API מאת Zapier עזרה Zapier Catch Hook עזרה 7stamp API עזר מדריך התקנה של XTOR

השלב הבא

TMTMTXTOR התקנה של Webhook1 בנה את ה-Zap הראשון עם איש קשר לבדיקה

צור את מפתח API, בדוק את GET /templates דרך API על ידי Zapier, ואז בנה פעולה אחת של איש קשר לכרטיס או הזמנה לחותמות. הוסף את ה-Catch Hook ברגע שלזרימה היוצאת יש תוצאת בדיקה מוכחת.

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