API & Integrations

14. API & Integrations

API & Integrations bölməsində 7Stamp-i xarici sistemlərinizlə — CRM, POS, ERP, analitika, messencer botları ilə — proqram səviyyəsində inteqrasiya etmək üçün alətlər var.

API Keys

Bölmənin əsas səhifəsi API açarlarının siyahısıdır. Sütunlar:

• Name — açarın adı (adətən bağlı işçinin adı ilə eyni olur).
• Login — açarın bağlı olduğu işçi girişi.
• API Key — açarın özü (7loc_sc_... ilə başlayır, standart olaraq gizlidir, bir kliklə kopyalanır).
• Status — Active.
• 🔄 — açarı yenidən yaratmaq.
• 🗑️ — açarı silmək.

API açarının yaradılması

+ ADD API KEY düyməsinə toxunun — Generate API Key pəncərəsi açılır:

• Scanner — açarın bağlanacağı işçi girişini seçmək üçün açılan siyahı (bir işçinin bir açarı ola bilər).
• CANCEL / GENERATE düymələri.

GENERATE-dən sonra açar yaradılır və siyahıda görünür. Onu dərhal kopyalayın — tam açar bir daha göstərilməyə bilər.

API vasitəsilə nə etmək olar

• Müştəriyə email/telefon üzrə kart vermək.
• Konkret müştəriyə möhür əlavə etmək.
• Vauçer vermək (şablon üzrə və ya fərdi, Redeem Code ilə).
• Vauçeri istifadə etmək (redeem) (öz POS sisteminiz üzərindən işləyirsinizsə).
• Kartın vəziyyətini, irəliləyişini, tarixçəsini oxumaq.
• Hadisələri real vaxtda almaq üçün Webhooks-a abunə olmaq.

Webhooks

Webhooks kart hadisələrini xarici sistemə göndərir. Dəstəklənənlər (hadisələr lüğətinə baxın):

• 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 nümunəsi

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

Hazır POS inteqrasiyaları

• Poster — hazır inteqrasiya, bir neçə kliklə qoşulur.
• Serve — hazır inteqrasiya.
• Digər kassalar — sorğu əsasında hazırlanır. Texniki cəhətdən mümkündürsə, pulsuzdur (yəni kassanızın açıq API-si və ya Webhooks-u varsa).

7loc.com vasitəsilə messencer göndərişləri

WhatsApp, Telegram, Viber göndərişləri üçün 7loc.com inteqrasiyası qoşulur. Aktivləşdikdən sonra Campaigns bölməsində PUSH və Email-in yanında “messencerlər” kanalı əlçatan olur.

Kodsuz ssenarilər: Zapier və Make

7Stamp API + Webhooks Zapier və Make (Integromat) ilə işləyir və kod yazmadan ssenarilər qurmağa imkan verir:

• “VOUCHER_REDEEMED olduqda — Mailchimp-də teq əlavə et”.
• “REWARD_EARNED olduqda — Slack-ə bildiriş göndər”.
• “BIRTHDAY_GREETING olduqda — CRM-də tapşırıq yarat”.

---