API a integrace

14. API a integrace

[snímek obrazovky: 0601_Apikey.png]

Sekce API & Integrations obsahuje nástroje pro programovou integraci 7stamp s vašimi externími systémy — CRM, POS, ERP, analytiky, messenger boti.

API Keys

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

• Name — název klíče (obvykle odpovídá propojenému jménu personálu).
• Přihlášení — Přihlášení personálu, ke kterému je klíč vázán.
• API Key — samotný klíč (začíná 7loc_sc_..., ve výchozím nastavení skrytý, kopírovatelný jedním kliknutím).
• Stav — „Aktivní“.
• 🔄 — regenerujte klíč.
• 🗑️ — smazat klíč.

Vytvoření klíče API

[snímek obrazovky: 0602_Apikey.png]

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

• Skener — rozevírací seznam pro výběr Staff Login, ke kterému bude klíč vázán (jeden personál může mít jeden klíč).
• Tlačítka ZRUŠIT / GENEROVAT.

Po GENERATE je klíč vytvořen a objeví se v seznamu. Okamžitě jej zkopírujte — celý klíč se nemusí znovu zobrazit.

Co můžete udělat pomocí API

• Vydání karty zákazníkovi na email/telefon.
• Přidejte stamp ke konkrétnímu zákazníkovi.
• Vydejte voucher (podle šablony nebo na zakázku, s Redeem Code).
• Uplatněte voucher (pokud pracujete přes svůj vlastní POS).
• ** Stav čtení** karty, postup, historie.
• Přihlaste se k odběru Webhooks a dostávejte události v reálném čase.

Webhooky

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

• card_issued, card_saved, card_opened.
• “stamp_přidáno”.
• dosažen_cíl, vydaná_odměna.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (s výsledkem).
• narozeniny_dosáhly.
• „spouštěč_neaktivity“.
• campaign_sent.

Příklad užitečného zatížení webhooku

{
"event": "poukaz_uplatněn",
"timestamp": "2026-05-11T12:34:56Z",
"business_id": "b_123",
"location_id": "loc_45",
"zákazník": {
"id": "c_789",
"wallet_pass_id": "wp_abc",
"language": "en"
  },
"card": { "id": "card_001", "goal_index": 2 },
"poukaz": {
"id": "v_555",
"type": "voucher",
"redeem_code": "OFFEE ZDARMA",
"redeem_code_formats": ["text", "qr", "čárový kód"],
"status": "uplatněno",
"redeemed_via": "scanner_zaměstnanců"
  }
}

Hotové integrace POS

• Poster — hotová integrace, připojení na pár kliknutí.
• Serve — hotová integrace.
• Ostatní pokladny – na přání. Zdarma, pokud je to technicky proveditelné (tj. vaše pokladna odhaluje otevřené API nebo webhooky).

Messenger vysílá přes 7loc.com

Pro vysílání WhatsApp, Telegram, Viber je připojena integrace 7loc.com. Jakmile je aktivní, kanál „poslíčci“ bude dostupný v Kampaních vedle PUSH a Email.

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

7stamp API + Webhooky fungují s Zapier a Make (Integromat) a umožňují vám vytvářet scénáře bez kódování:

• “Když voucher_redeemed - přidejte štítek v Mailchimp”.
• “Když goal_reached - odeslat upozornění na Slack”.
• “Když birthday_reached — vytvořte úkol v CRM”.

---