API & Integrations

14. API & Integrations

Sekcija API & Integrations sadrži alate za programsku integraciju 7stamp-a s vašim vanjskim sustavima — CRM, POS, ERP, analitika, messenger botovi.

API ključevi

Glavna stranica sekcije je popis API ključeva. Stupci:

• Name — naziv ključa (obično odgovara imenu povezanog Staff).
• Login — Staff login za koji je ključ vezan.
• API Key — sam ključ (počinje s 7loc_sc_..., prema zadanim postavkama skriven, kopiran jednim klikom).
• Status — Active.
• 🔄 — regeneriranje ključa.
• 🗑️ — brisanje ključa.

Stvaranje API ključa

Dodirnite + ADD API KEY — otvara se popup Generate API Key:

• Scanner — dropdown za odabir Staff Login-a za koji će ključ biti vezan (jedan Staff može imati jedan ključ).
• Gumbi CANCEL / GENERATE.

Nakon GENERATE ključ je stvoren i pojavljuje se u popisu. Kopirajte ga odmah — cijeli ključ možda neće biti ponovno prikazan.

Što možete raditi putem API-ja

• Izdati karticu kupcu putem emaila/telefona.
• Dodati stamp određenom kupcu.
• Izdati voucher (po šabloni ili prilagođen, s Redeem Code).
• Otkupiti voucher (ako radite putem vlastitog POS-a).
• Pročitati stanje kartice, napredak, povijest.
• Pretplatiti se na Webhooks kako biste primali događaje u stvarnom vremenu.

Webhooks

Webhooks šalju događaje kartice u vanjski sustav. Podržano (vidi pojmovnik događaja):

• card_issued, card_saved, card_opened.
• stamp_added.
• goal_reached, reward_issued.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (s rezultatom).
• birthday_reached.
• inactivity_trigger.
• campaign_sent.

Primjer payloada Webhooka

{
  "event": "voucher_redeemed",
  "timestamp": "2026-05-11T12:34:56Z",
  "business_id": "b_123",
  "location_id": "loc_45",
  "customer": {
    "id": "c_789",
    "wallet_pass_id": "wp_abc",
    "language": "en"
  },
  "card": { "id": "card_001", "goal_index": 2 },
  "voucher": {
    "id": "v_555",
    "type": "voucher",
    "redeem_code": "FREECOFFEE",
    "redeem_code_formats": ["text", "qr", "barcode"],
    "status": "redeemed",
    "redeemed_via": "staff_scanner"
  }
}

Gotove POS integracije

• Poster — gotova integracija, povezuje se s nekoliko klikova.
• Serve — gotova integracija.
• Ostale blagajne — rade se na zahtjev. Besplatno ako je tehnički izvedivo (tj. vaša blagajna izlaže otvoreni API ili Webhooks).

Messenger emisije putem 7loc.com

Za WhatsApp, Telegram, Viber emisije povezana je integracija 7loc.com. Nakon aktivacije, kanal “messengers” postaje dostupan u Campaigns uz PUSH i Email.

No-code scenariji: Zapier i Make

7stamp API + Webhooks rade sa Zapier i Make (Integromat), što vam omogućuje izgradnju scenarija bez kodiranja:

• “Kada voucher_redeemed — dodaj oznaku u Mailchimp”.
• “Kada goal_reached — pošalji obavijest u Slack”.
• “Kada birthday_reached — stvori zadatak u CRM-u”.

---