API & Integrations

14. API & Integrations

Sadaļa API & Integrations satur rīkus 7stamp programmātiskai integrācijai ar jūsu ārējām sistēmām — CRM, POS, ERP, analītiku un mesendžeru botiem.

API Keys

Sadaļas galvenā lapa ir API atslēgu saraksts. Kolonnas:

• Name — atslēgas nosaukums (parasti sakrīt ar saistītā Staff vārdu).
• Login — Staff login, kuram atslēga ir piesaistīta.
• API Key — pati atslēga (sākas ar 7loc_sc_..., pēc noklusējuma paslēpta, kopējama ar vienu klikšķi).
• Status — Active.
• 🔄 — pārgenerēt atslēgu.
• 🗑️ — dzēst atslēgu.

API atslēgas izveide

Nospiediet + ADD API KEY — atvērsies uznirstošais logs Generate API Key:

• Scanner — nolaižamais saraksts, kur izvēlēties Staff Login, kam atslēga tiks piesaistīta (vienam Staff var būt viena atslēga).
• Pogas CANCEL / GENERATE.

Pēc GENERATE atslēga tiek izveidota un parādās sarakstā. Nokopējiet to uzreiz — pilnā atslēga vēlāk var vairs netikt parādīta.

Ko var darīt caur API

• Izsniegt karti klientam pēc e-pasta / telefona.
• Pievienot zīmogu konkrētam klientam.
• Izsniegt Voucher (no veidnes vai pielāgotu, ar Redeem Code).
• Izpirkt Voucher (ja strādājat caur savu POS).
• Nolasīt kartes stāvokli: progresu, vēsturi.
• Abonēt Webhooks, lai saņemtu notikumus reāllaikā.

Webhooks

Webhooks sūta karšu notikumus uz ārējo sistēmu. Tiek atbalstīti (skatiet notikumu glosāriju):

• card_issued, card_saved, card_opened.
• stamp_added.
• goal_reached, reward_issued.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (kopā ar rezultātu).
• birthday_reached.
• inactivity_trigger.
• campaign_sent.

Webhook payload piemērs

{
  "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"
  }
}

Gatavās POS integrācijas

• Poster — gatava integrācija, pieslēdzas dažos klikšķos.
• Serve — gatava integrācija.
• Citas kases — tiek veidotas pēc pieprasījuma. Bezmaksas, ja tas ir tehniski iespējams (tas ir, ja jūsu kase atbalsta atvērtu API vai Webhooks).

Mesendžeru sūtījumi caur 7loc.com

Lai sūtītu WhatsApp, Telegram un Viber kampaņas, tiek pieslēgta integrācija 7loc.com. Kad tā ir aktīva, kanāls “messengers” Campaigns sadaļā parādās līdzās PUSH un Email.

No-code scenāriji: Zapier un Make

7stamp API + Webhooks darbojas ar Zapier un Make (Integromat), ļaujot būvēt scenārijus bez programmēšanas:

• “Kad voucher_redeemed — pievieno tagu Mailchimp”.
• “Kad goal_reached — nosūti paziņojumu uz Slack”.
• “Kad birthday_reached — izveido uzdevumu CRM”.

---