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 tempel 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):

• SCAN, DELIVERY_INSERT.
• REWARD_EARNED, LOTTERY_WIN.
• VOUCHER_ISSUED, ADMIN_VOUCHER_ISSUE, VOUCHER_REDEEMED.
• CARD_JOINED, CARD_ADDED_TO_WALLET, CARD_REMOVED_FROM_WALLET.
• CARD_CAMPAIGN, BIRTHDAY_GREETING.

Webhooki payload’i näide

{
  "entity": "card_event",
  "action": "created",
  "entity_id": 707,
  "event_id": "8f05e58decec48e09d328f0edebbacf6",
  "profile_id": 2,
  "profile_name": "Your Business",
  "profile_lang": "en",
  "data": {
    "event_type": "SCAN",
    "scanned_at": "2026-10-01T09:19:24.179424",
    "user_card_id": 10,
    "card_template_id": 14,
    "card_template_name": "Collect your stamps!",
    "stamps_added": 3,
    "stamps_before": 1,
    "stamps_after": 4,
    "amount": null,
    "external_order_id": "ORDER-1001",
    "workplace": { "id": 4, "name": "Bar Counter" },
    "device_type": null,
    "external_id": "odoo_contact_8821",
    "external_source": "odoo",
    "issued_vouchers": [
      {
        "id": 174,
        "unique_code": "100425813507",
        "stamp_number": 4,
        "issued_at": "2026-10-01T09:19:24.191836",
        "expires_at": "2027-01-01T23:59:59",
        "status": "ACTIVE",
        "voucher_template_id": 58,
        "voucher_description": "Free coffee",
        "voucher_image_url": "https://..."
      }
    ],
    "achieved_goals": [],
    "user": {
      "id": 2,
      "name": "Anna",
      "full_name": "Anna Smith",
      "email": "anna@example.com",
      "telegram_chat_id": null,
      "telegram_username": null,
      "whatsapp_phone": null,
      "birth_date": null
    }
  }
}

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 REWARD_EARNED — saada teavitus Slacki”.
• “Kui BIRTHDAY_GREETING — loo ülesanne CRM-is”.