API & Integrations

14. API & Integrations

Jaotis API & Integrations sisaldab tööriistu, millega ühendada 7stamp sinu väliste süsteemidega — CRM, POS, ERP, analüütika, messengeri botid.

API võtmed

Jaotise avaleht on API võtmete nimekiri. Veerud:

• Name — võtme nimi (tavaliselt vastab seotud Staff nimele).
• Login — Staff Login, millega võti on seotud.
• API Key — võti ise (algab 7loc_sc_..., on vaikimisi peidetud ja ühe klikiga kopeeritav).
• Status — Active.
• 🔄 — loo võti uuesti.
• 🗑️ — kustuta võti.

API võtme loomine

Vajuta + ADD API KEY — avaneb hüpikaken Generate API Key:

• Scanner — rippmenüü, kus valid Staff Login’i, millega võti seotakse (ühel Staffil saab olla üks võti).
• Nupud CANCEL / GENERATE.

Pärast GENERATE loomist luuakse võti ja see ilmub nimekirja. Kopeeri see kohe — täielikku võtit ei pruugita hiljem enam näidata.

Mida saab API kaudu teha

• Väljastada kaardi kliendile e-posti või telefoni järgi.
• Lisada Stampi konkreetsele kliendile.
• Väljastada Voucheri (mallipõhise või kohandatud, koos Redeem Code’iga).
• Lunastada Voucheri (kui töötad oma POS-i kaudu).
• Lugeda olekut: kaardi seisu, edenemist, ajalugu.
• Tellida Webhooks reaalajas sündmuste vastuvõtmiseks.

Webhooks

Webhooks saadavad kaardisündmused välisesse süsteemi. Toetatud on järgmised sündmused (vt sündmuste sõnastikku):

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

Webhooki payload’i näide

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

Valmis POS-integratsioonid

• Poster — valmis integratsioon, ühendub mõne klikiga.
• Serve — valmis integratsioon.
• Muud kassasüsteemid — tehakse tellimusel. Tasuta, kui see on tehniliselt teostatav (ehk kui sinu kassasüsteem pakub avatud API-t või Webhooks’i).

Messengeri kampaaniad läbi 7loc.com-i

WhatsAppi, Telegrami ja Viberi kampaaniate jaoks ühendatakse 7loc.com integratsioon. Kui see on aktiveeritud, muutub Campaigns jaotises PUSH-i ja Emaili kõrval kättesaadavaks kanal “messengers”.

No-code stsenaariumid: Zapier ja Make

7stamp API ja Webhooks töötavad koos Zapieri ja Make’iga (Integromat), mis lubab sul ehitada vooge ilma koodi kirjutamata:

• “Kui voucher_redeemed — lisa silt Mailchimpi”.
• “Kui goal_reached — saada teavitus Slacki”.
• “Kui birthday_reached — loo ülesanne CRM-is”.