API a integrace

14. API a integrace

Sekce API & Integrations obsahuje nástroje pro programatickou integraci 7stamp s vašimi externími systémy — CRM, pokladna, ERP, analytika, messenger boty.

API klíče

Hlavní stránka sekce je seznam API klíčů. Sloupce:

• Name — název klíče (obvykle odpovídá názvu přiřazeného zaměstnance).
• Login — přihlášení zaměstnance, ke kterému je klíč přivázán.
• API Key — samotný klíč (začíná 7loc_sc_..., skrytý ve výchozím nastavení, kopírovatelný jedním kliknutím).
• Status — Active.
• 🔄 — znovu vygenerovat klíč.
• 🗑️ — smazat klíč.

Vytvoření API klíče

Klepněte na + ADD API KEY — otevře se vyskakovací okno Generate API Key:

• Scanner — rozbalovací nabídka pro výběr přihlášení zaměstnance, ke kterému bude klíč přivázán (jeden zaměstnanec může mít jeden klíč).
• Tlačítka CANCEL / GENERATE.

Po kliknutí na GENERATE je klíč vytvořen a zobrazí se v seznamu. Zkopírujte ho okamžitě — celý klíč nemusí být znovu zobrazen.

Co lze dělat přes API

• Vydat kartu zákazníkovi podle e-mailu/telefonu.
• Přidat razítko konkrétnímu zákazníkovi.
• Vydat voucher (šablonovaný nebo vlastní, s kódem pro uplatnění).
• Uplatnit voucher (pokud pracujete přes vlastní pokladnu).
• Přečíst stav karty, postup, historii.
• Přihlásit se k odběru webhooků pro příjem událostí v reálném čase.

Webhooky

Webhooky odesílají události karty do externího systému. Podporovány (viz glosář událostí):

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

Příklad payloadu webhooku

{
  "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": "cs"
  },
  "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"
  }
}

Připravené integrace pokladen

• Poster — připravená integrace, propojí se během několika kliknutí.
• Serve — připravená integrace.
• Ostatní pokladny — na žádost. Zdarma, pokud je to technicky proveditelné (tj. vaše pokladna nabízí otevřené API nebo webhooky).

Hromadná vysílání přes messengery přes 7loc.com

Pro vysílání přes WhatsApp, Telegram a Viber se připojí integrace 7loc.com. Po aktivaci se v kampaních vedle PUSH a e-mailu zobrazí kanál „messengery”.

Scénáře bez kódu: Zapier a Make

API 7stamp + webhooky fungují se Zapier a Make (Integromat), což vám umožňuje sestavovat scénáře bez programování:

• „Když voucher_redeemed — přidej štítek v Mailchimp”.
• „Když goal_reached — pošli oznámení do Slacku”.
• „Když birthday_reached — vytvoř úkol v CRM”.

---