API & Integrations

14. API & Integrations

7Stamp-നെ നിങ്ങളുടെ ബാഹ്യ സംവിധാനങ്ങളുമായി — CRM, POS, ERP, അനലിറ്റിക്സ്, മെസഞ്ചർ ബോട്ടുകൾ — പ്രോഗ്രാമാറ്റിക്കായി സംയോജിപ്പിക്കാനുള്ള ടൂളുകൾ API & Integrations വിഭാഗത്തിലുണ്ട്.

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 പേലോഡ് ഉദാഹരണം

{
  "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) എന്നിവയുമായി പ്രവർത്തിക്കുന്നു, കോഡ് എഴുതാതെ സാഹചര്യങ്ങൾ നിർമ്മിക്കാൻ ഇത് സഹായിക്കുന്നു:

• “VOUCHER_REDEEMED സംഭവിക്കുമ്പോൾ — Mailchimp-ൽ ഒരു ടാഗ് ചേർക്കുക”.
• “REWARD_EARNED സംഭവിക്കുമ്പോൾ — Slack-ലേക്ക് ഒരു അറിയിപ്പ് അയയ്ക്കുക”.
• “BIRTHDAY_GREETING സംഭവിക്കുമ്പോൾ — CRM-ൽ ഒരു ടാസ്ക് സൃഷ്ടിക്കുക”.

---