14. API & Integrations

የAPI & Integrations ክፍል 7Stampን ከውጫዊ ስርዓቶችዎ — CRM፣ POS፣ ERP፣ ትንታኔ፣ የመልእክት ቦቶች — ጋር በፕሮግራም ለማዋሃድ የሚያስችሉ መሳሪያዎችን ይዟል።

የAPI ቁልፎች

የክፍሉ ዋና ገጽ የ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 ካለው)።