API & Integrations

14. API & Integrations

Razdelek API & Integrations vsebuje orodja za programsko povezovanje 7Stamp z vašimi zunanjimi sistemi — CRM, POS, ERP, analitiko in klepetalnimi roboti.

API ključi

Glavna stran razdelka je seznam ključev API. Stolpci:

• Name — ime ključa (običajno enako imenu povezane prijave zaposlenega).
• Login — prijava zaposlenega, na katero je ključ vezan.
• API Key — sam ključ (začne se s 7loc_sc_..., privzeto je skrit, kopirate ga z enim klikom).
• Status — Active.
• 🔄 — ponovno ustvarjanje ključa.
• 🗑️ — brisanje ključa.

Ustvarjanje ključa API

Tapnite + ADD API KEY — odpre se pojavno okno Generate API Key:

• Scanner — spustni seznam, v katerem izberete prijavo zaposlenega, na katero bo ključ vezan (ena prijava ima lahko en ključ).
• Gumba CANCEL / GENERATE.

Po kliku GENERATE se ključ ustvari in prikaže na seznamu. Takoj ga kopirajte — celotnega ključa morda ne boste več videli.

Kaj lahko naredite prek API

• Izdate kartico stranki prek e-pošte/telefona.
• Dodate žig določeni stranki.
• Izdate vavčer (po predlogi ali po meri, z Redeem Code).
• Unovčite vavčer (če delate prek lastnega POS).
• Preberete stanje kartice, napredek in zgodovino.
• Se naročite na Webhooks in dogodke prejemate v realnem času.

Webhooks

Webhooks pošiljajo dogodke kartice v zunanji sistem. Podprti so (glejte pojmovnik dogodkov):

• 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.

Primer vsebine (payload) Webhooka

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

Že pripravljene integracije POS

• Poster — pripravljena integracija, povežete jo z nekaj kliki.
• Serve — pripravljena integracija.
• Druge blagajne — izdelamo jih na zahtevo. Brezplačno, če je tehnično izvedljivo (tj. vaša blagajna ponuja odprt API ali Webhooks).

Pošiljanje v klepetalnike prek 7loc.com

Za pošiljanje sporočil v WhatsApp, Telegram in Viber se poveže integracija 7loc.com. Ko je aktivna, je v Campaigns poleg PUSH in Email na voljo tudi kanal »messengers«.

Scenariji brez kode: Zapier in Make

7Stamp API + Webhooks delujeta z orodjema Zapier in Make (Integromat), zato lahko scenarije sestavite brez programiranja:

• »Ko pride VOUCHER_REDEEMED — dodaj oznako v Mailchimp«.
• »Ko pride REWARD_EARNED — pošlji obvestilo v Slack«.
• »Ko pride BIRTHDAY_GREETING — ustvari opravilo v CRM«.

---