API & Integrations

14. API & Integrations

Skiltyje API & Integrations rasite priemones 7stamp programiškai integruoti su jūsų išorinėmis sistemomis — CRM, POS, ERP, analitika, messenger botai.

API Keys

Pagrindinis skilties puslapis — API raktų sąrašas. Stulpeliai:

• Name — rakto pavadinimas (dažniausiai atitinka susieto Staff vardą).
• Login — Staff prisijungimas, prie kurio pririštas raktas.
• API Key — pats raktas (prasideda 7loc_sc_..., pagal numatymą paslėptas, nukopijuojamas vienu paspaudimu).
• Status — Active.
• 🔄 — pergeneruoti raktą.
• 🗑️ — ištrinti raktą.

API rakto kūrimas

Paspauskite + ADD API KEY — atsidaro iššokantis langas Generate API Key:

• Scanner — išskleidžiamasis sąrašas Staff Login pasirinkimui, prie kurio bus pririštas raktas (vienas Staff gali turėti vieną raktą).
• Mygtukai CANCEL / GENERATE.

Po GENERATE raktas sukuriamas ir atsiranda sąraše. Nukopijuokite jį iškart — pilnas raktas gali būti neberodomas.

Ką galima daryti per API

• Išduoti Card klientui pagal el. paštą / telefoną.
• Pridėti Stamp konkrečiam klientui.
• Išduoti Voucher (šabloninį arba tinkintą, su Redeem Code).
• Panaudoti Voucher (jei dirbate per savo POS).
• Skaityti Card būseną, eigą, istoriją.
• Prenumeruoti Webhooks, kad realiuoju laiku gautumėte įvykius.

Webhooks

Webhooks siunčia Card įvykius į išorinę sistemą. Palaikoma (žr. įvykių žodyną):

• card_issued, card_saved, card_opened.
• stamp_added.
• goal_reached, reward_issued.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (su rezultatu).
• birthday_reached.
• inactivity_trigger.
• campaign_sent.

Webhook payload pavyzdys

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

Paruoštos POS integracijos

• Poster — paruošta integracija, prijungiama keliais paspaudimais.
• Serve — paruošta integracija.
• Kitos kasos — daromos pagal užklausą. Nemokamai, jei techniškai įmanoma (t. y. jūsų kasa turi atvirą API arba Webhooks).

Messenger siuntimai per 7loc.com

WhatsApp, Telegram, Viber siuntimams prijungiama integracija 7loc.com. Aktyvavus šalia PUSH ir Email kampanijose tampa prieinamas kanalas „messengers“.

No-code scenarijai: Zapier ir Make

7stamp API ir Webhooks veikia su Zapier ir Make (Integromat), leisdami kurti scenarijus be kodo:

• „Kai voucher_redeemed — pridėti žymę Mailchimp“.
• „Kai goal_reached — išsiųsti pranešimą į Slack“.
• „Kai birthday_reached — sukurti CRM užduotį“.

---