14. API a integrácie

[snímka obrazovky: 0601_Apikey.png]

Sekcia API & Integrations obsahuje nástroje na programovú integráciu 7stamp s vašimi externými systémami — CRM, POS, ERP, analytiky, messenger botov.

API Keys

Hlavná stránka sekcie je zoznam kľúčov API. Stĺpce:

Name — názov kľúča (zvyčajne sa zhoduje s prepojeným menom zamestnanca).
Prihlásenie — prihlasovacie meno personálu, ku ktorému je kľúč priradený.
API Key — samotný kľúč (začína 7loc_sc_..., predvolene skrytý, kopírovateľný jedným kliknutím).
Stav – „Aktívne“.
🔄 — regenerujte kľúč.
🗑️ — vymažte kľúč.

Vytvorenie kľúča API

[snímka obrazovky: 0602_Apikey.png]

Klepnite na + PRIDAŤ KĽÚČ API — otvorí sa kontextové okno Vygenerovať kľúč API:

Skener – rozbaľovacia ponuka na výber Staff Login, ku ktorému bude kľúč viazaný (jeden personál môže mať jeden kľúč).
Tlačidlá ZRUŠIŤ / GENEROVAŤ.

Po GENERATE sa kľúč vytvorí a zobrazí sa v zozname. Okamžite ho skopírujte – celý kľúč sa už nemusí zobraziť.

Čo môžete urobiť pomocou API

Vydajte kartu zákazníkovi e-mailom/telefonicky.
Pridajte stamp konkrétnemu zákazníkovi.
Vydajte kupón (podľa šablóny alebo na mieru, s Redeem Code).
Uplatnite si voucher (ak pracujete cez svoj vlastný POS).
Stav čítania karty, priebeh, história.
Prihláste sa na odber Webhooks a získajte udalosti v reálnom čase.

Webhooky

Webhooky odosielajú udalosti karty do externého systému. Podporované (pozrite si glosár udalostí):

card_issued, card_saved, card_opened.
stamp_added.
dosiahnutý_cieľ, vydaná_odmena.
voucher_issued, voucher_redeemed, voucher_expired.
lottery_played (s výsledkom).
narodeniny_dosiahli.
„spúšťač_neaktivity“.
campaign_sent.

Príklad užitočného zaťaženia webhooku

{
"event": "poukaz_uplatnený",
"timestamp": "2026-05-11T12:34:56Z",
"business_id": "b_123",
"location_id": "loc_45",
"customer": {
"id": "c_789",
"wallet_pass_id": "wp_abc",
"language": "sk"
  },
"card": { "id": "card_001", "goal_index": 2 },
"voucher": {
"id": "v_555",
"type": "voucher",
"redeem_code": "OFFEE ZDARMA",
"redeem_code_formats": ["text", "qr", "čiarový kód"],
"status": "uplatnené",
"redeemed_via": "scanner_personálu"
  }
}

Hotové integrácie POS

Poster — hotová integrácia, pripojenie niekoľkými kliknutiami.
Slúžiť — hotová integrácia.
Iné pokladne – vyrobené na želanie. Zadarmo, ak je to technicky možné (t. j. vaša pokladňa odhaľuje otvorené API alebo webhooky).

Messenger vysiela cez 7loc.com

Pre vysielanie WhatsApp, Telegram, Viber je pripojená integrácia 7loc.com. Po aktivácii sa kanál „poslíčci“ sprístupní v kampaniach vedľa PUSH a Email.