API & Integrations

14. API & Integrations

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

API ključevi

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

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

Stvaranje API ključa

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

• Scanner — dropdown za izbira Staff Login-a za ki će ključ biti vezan (en Staff lahko imati en ključ).
• Gumbi CANCEL / GENERATE.

Po GENERATE ključ je stvoren in pojavljuje se u popisu. Kopirajte ga takoj — cijeli ključ možda neće biti ponovno prikazan.

Kaj lahko raditi prek API-ja

• Izdati kartico stranki prek emaila/telefona.
• Dodati stamp određenom stranki.
• Izdati voucher (po šabloni ali prilagođen, s Redeem Code).
• Unovčiti voucher (če radite prek 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 sistem. Podržano (vidi pojmovnik dogodkov):

• 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. Brezplačno če je tehnički izvedivo (tj. vaša blagajna izlaže otvoreni API ali Webhooks).

Messenger emisije prek 7loc.com

Za WhatsApp, Telegram, Viber emisije povezana je integracija 7loc.com. Po aktivacije, kanal “messengers” postaje na voljo u Campaigns uz PUSH in Email.

No-code scenariji: Zapier in Make

7stamp API + Webhooks rade sa Zapier in Make (Integromat), kaj vam omogoča izgradnju scenarija brez kodiranja:

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

---