API ואינטגרציות

14. API ואינטגרציות

סעיף API & Integrations מכיל כלים לשילוב תוכנה 7stamp עם המערכות החיצוניות שלך - CRM, POS, ERP, ניתוח, בוטים של מסנג’ר.

API מפתחות

העמוד הראשי של המדור הוא רשימה של מפתח API. עמודות:

• Name - שם המפתח (בדרך כלל זהה לשם הצוות המקושר).

• Login — התחברות צוות שאליה מחובר המפתח.

• API Key - המפתח עצמו (מתחיל ב-7loc_sc_..., מוסתר כברירת מחדל, מועתק בלחיצה אחת).

• Status — Active.

• 🔄 - שחרר את המפתח.

• 🗑️ - מחק את המפתח.

יצירת מפתח API

הקש + ADD API KEY - חלון קופץ Generate API Key ייפתח:

• Scanner - תפריט נפתח לבחירת Staff Login שאליו יצורף המפתח (צוות אחד יכול להיות מפתח אחד).

• לחצנים CANCEL / GENERATE.

לאחר GENERATE המפתח נוצר ומופיע ברשימה. העתק אותו מיד - ייתכן שהמפתח המלא לא יוצג יותר.

מה ניתן לעשות באמצעות API

• Issue a card ללקוח במייל/טלפון.

• Add a stamp ללקוח ספציפי.

• Issue a voucher (תבנית או מותאמת אישית, עם Redeem Code).

• Redeem a voucher (אם אתה עובד דרך POS משלך).

• Read state קלפים, התקדמות, סיפור.

• Subscribe to Webhooks לקבלת אירועים בזמן אמת.

Webווים

Webhooks שולחים אירועי כרטיס למערכת חיצונית. נתמך (ראה event glossary):

• card_issued, card_saved, card_opened.

• stamp_added.

• goal_reached, reward_issued.

• voucher_issued, voucher_redeemed, voucher_expired.

• lottery_played (עם התוצאה).

• birthday_reached.

• inactivity_trigger.

• campaign_sent.

דוגמה למטען אינטרנטי

{
  "event": "voucher_redeemed",
  "timestamp": "2026-05-11T12:34:56Z",
  "business_id": "b_123",
  "location_id": "loc_45",
  "customer": {
    "id": "c_789",
    "wallet_pass_id": "wp_abc",
    "language": "en"
  },
  "card": { "id": "card_001", "goal_index": 2 },
  "voucher": {
    "id": "v_555",
    "type": "voucher",
    "redeem_code": "FREECOFFEE",
    "redeem_code_formats": ["text", "qr", "barcode"],
    "status": "redeemed",
    "redeemed_via": "staff_scanner"
  }
}

POS אינטגרציות מוכנות

• Poster - אינטגרציה מוכנה, מחוברת בכמה לחיצות.

• Serve - שילוב מוכן.

• תיקים אחרים - נעשים על פי בקשה. חינם אם זה אפשרי מבחינה טכנית (כלומר, הקופה שלך מחלקת API או Web ווים פתוחים).

הודעות Messenger דרך 7loc.com

אינטגרציה עם 7loc.com מחוברת לדיוור של WhatsApp, Telegram, Viber. לאחר ההפעלה, ערוץ ה”שליחים” מופיע לצד PUSH ואימייל בקמפיינים.

סקריפטים ללא קוד: Zapier ו-Make

7stamp API + Webhooks עובדים עם Zapier ו-Make (Integromat), ומאפשרים לך לבנות סקריפטים ללא קוד:

• “כאשר voucher_redeemed - הוסף תג ב-Mailchimp.”

• “כאשר goal_reached - שלח התראה ב-Slack.”

• “כאשר birthday_reached - צור משימה ב-CRM”.

---