API & Integrations

14. API & Integrations

API & Integrations विभागात 7Stamp ला तुमच्या बाह्य प्रणालींशी — CRM, POS, ERP, ॲनालिटिक्स, मेसेंजर बॉट्स — प्रोग्रामॅटिक पद्धतीने जोडण्याची साधने आहेत.

API Keys

विभागाचे मुख्य पृष्ठ म्हणजे API कींची यादी. स्तंभ:

• Name — कीचे नाव (सहसा जोडलेल्या कर्मचाऱ्याच्या नावाशी जुळते).
• Login — की ज्या कर्मचारी लॉगिनशी जोडलेली आहे ते.
• API Key — स्वतः की (7loc_sc_... ने सुरू होते, डीफॉल्टनुसार लपवलेली असते, एका क्लिकवर कॉपी करता येते).
• Status — Active.
• 🔄 — की पुन्हा तयार करा.
• 🗑️ — की हटवा.

API की तयार करणे

+ ADD API KEY दाबा — Generate API Key पॉपअप उघडतो:

• Scanner — की ज्या कर्मचारी लॉगिनशी जोडायची आहे ते निवडण्यासाठी ड्रॉपडाउन (एका कर्मचाऱ्यासाठी एक की).
• CANCEL / GENERATE बटणे.

GENERATE केल्यानंतर की तयार होते आणि यादीत दिसते. ती लगेच कॉपी करा — संपूर्ण की पुन्हा दाखवली जाणार नाही.

API द्वारे तुम्ही काय करू शकता

• ईमेल/फोनद्वारे ग्राहकाला कार्ड द्या.
• विशिष्ट ग्राहकाला स्टॅम्प जोडा.
• व्हाउचर द्या (टेम्पलेटनुसार किंवा सानुकूल, Redeem Code सह).
• व्हाउचर रिडीम करा (तुम्ही स्वतःच्या POS द्वारे काम करत असल्यास).
• कार्डची स्थिती वाचा, प्रगती, इतिहास.
• घटना प्रत्यक्ष वेळेत मिळवण्यासाठी Webhooks चे सदस्यत्व घ्या.

Webhooks

Webhooks कार्डच्या घटना बाह्य प्रणालीकडे पाठवतात. समर्थित घटना (घटनांचा शब्दकोष पाहा):

• SCAN, DELIVERY_INSERT.
• REWARD_EARNED, LOTTERY_WIN.
• VOUCHER_ISSUED, ADMIN_VOUCHER_ISSUE, VOUCHER_REDEEMED.
• CARD_JOINED, CARD_ADDED_TO_WALLET, CARD_REMOVED_FROM_WALLET.
• CARD_CAMPAIGN, BIRTHDAY_GREETING.

Webhook payload चे उदाहरण

{
  "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
    }
  }
}

तयार POS इंटिग्रेशन्स

• Poster — तयार इंटिग्रेशन, काही क्लिकमध्ये जोडले जाते.
• Serve — तयार इंटिग्रेशन.
• इतर कॅश सिस्टम — विनंतीनुसार तयार केले जाते. तांत्रिकदृष्ट्या शक्य असल्यास मोफत (म्हणजे तुमच्या कॅश सिस्टममध्ये खुले API किंवा Webhooks असल्यास).

7loc.com द्वारे मेसेंजर ब्रॉडकास्ट

WhatsApp, Telegram, Viber वरील ब्रॉडकास्टसाठी 7loc.com इंटिग्रेशन जोडले जाते. ते सक्रिय झाल्यावर Campaigns मध्ये PUSH आणि Email शेजारी “मेसेंजर” चॅनेल उपलब्ध होते.

कोडशिवाय परिस्थिती: Zapier आणि Make

7Stamp API + Webhooks Zapier आणि Make (Integromat) सोबत काम करतात, त्यामुळे कोड न लिहिता परिस्थिती (scenarios) तयार करता येतात:

• “VOUCHER_REDEEMED झाल्यावर — Mailchimp मध्ये टॅग जोडा”.
• “REWARD_EARNED झाल्यावर — Slack मध्ये सूचना पाठवा”.
• “BIRTHDAY_GREETING झाल्यावर — CRM मध्ये टास्क तयार करा”.

---