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 ಪೇಲೋಡ್ ಉದಾಹರಣೆ

{
  "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 ನಲ್ಲಿ ಕಾರ್ಯವನ್ನು ರಚಿಸಿ”.

---