API & ინტეგრაციები

14. API & ინტეგრაციები

განყოფილება API & Integrations (API და ინტეგრაციები) შეიცავს ინსტრუმენტებს 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)-თან, რაც პროგრამირების გარეშე სცენარების აგების საშუალებას გაძლევთ:

• „როცა VOUCHER_REDEEMED — დაამატე ტეგი Mailchimp-ში“.
• „როცა REWARD_EARNED — გაგზავნე შეტყობინება Slack-ში“.
• „როცა BIRTHDAY_GREETING — შექმენი დავალება CRM-ში“.

---