API & Integrations

14. API & Integrations

API & Integrations -osio sisältää työkalut 7stampin ohjelmalliseen integrointiin ulkoisiin järjestelmiin — CRM, POS, ERP, analytiikka, messenger-botit.

API Keys

Pääsivu on API-avaimien lista. Sarakkeet:

• Name — avaimen nimi (usein vastaa Staff-nimeä).
• Login — Staff-kirjautuminen, johon avain on sidottu.
• API Key — avain itse (alkaa 7loc_sc_..., oletuksena piilotettu, kopioitavissa).
• Status — Active.
• 🔄 — regeneroi avain.
• 🗑️ — poista avain.

API-avaimen luominen

Napauta + ADD API KEY — avautuu Generate API Key:

• Scanner — valitse Staff Login, johon avain sidotaan (yhdellä Staffilla voi olla yksi avain).
• CANCEL / GENERATE.

Kopioi avain heti — täyttä avainta ei välttämättä näytetä uudelleen.

Mitä API:lla voi tehdä

• Myöntää kortin asiakkaalle sähköpostilla/puhelimella.
• Lisätä leiman tietylle asiakkaalle.
• Myöntää voucherin (pohjasta tai räätälöity, Redeem Codella).
• Lunastaa voucherin (jos käytät omaa POS-työnkulkua).
• Lukea kortin tilan, edistymisen, historian.
• Tilata Webhookit reaaliaikaisiin tapahtumiin.

Webhooks

Webhookit lähettävät korttitapahtumat ulkoiseen järjestelmään. Tuetut:

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

Webhook-esimerkkikuorma

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

Valmiit POS-integraatiot

• Poster — valmis integraatio, muutama klikkaus.
• Serve — valmis integraatio.
• Muut kassat — pyynnöstä. Ilmainen jos teknisesti toteutettavissa (avoin API tai webhookit).

Viestilähetykset 7loc.comin kautta

WhatsApp-, Telegram- ja Viber-lähetyksiin kytketään 7loc.com -integraatio. Kun se on aktiivinen, Campaignsissa näkyy „viestimet” -kanava PUSHin ja sähköpostin rinnalla.

No-code: Zapier ja Make

7stamp API + Webhookit toimivat Zapierin ja Maken (Integromat) kanssa:

• „Kun voucher_redeemed — lisää tag Mailchimpiin”.
• „Kun goal_reached — lähetä Slack-ilmoitus”.
• „Kun birthday_reached — luo tehtävä CRM:ään”.

---