API & Integrations

14. API & Integrations

API & Integrations бөлімінде 7stamp сыртқы жүйелерімен — CRM, POS, ERP, аналитика, хабаршы боттарымен бағдарламалық біріктіруге арналған құралдар бар.

API пернелері

Бөлімнің негізгі беті API кілттер тізімі болып табылады. Бағандар: - Аты — кілт атауы (әдетте байланыстырылған Қызметкер атына сәйкес келеді). - Кіру — персоналдың логиніне кілт байланған. - API кілт — кілттің өзі (7loc_sc_... арқылы басталады, әдепкі бойынша жасырылады, бір рет басу арқылы көшіруге болады). - Мәртебе — Active. - 🔄 — кілтті қалпына келтіріңіз. - 🗑️ — кілтті жою.

API кілтін жасау

+ API КҮЙІН ҚОСУ түймесін түртіңіз — API кілтін жасау қалқымалы терезесі ашылады: - Сканер — кілт байланыстырылатын Staff Login таңдау үшін ашылмалы тізім (бір Қызметкерде бір кілт болуы мүмкін). - CANCEL / GENERATE түймелері.

GENERATE кейін кілт жасалады және тізімде пайда болады. Оны дереу көшіріңіз — толық кілт қайта көрсетілмеуі мүмкін.

API арқылы не істеуге болады - Электрондық пошта/телефон арқылы тұтынушыға картаны беру. - Белгілі бір тұтынушыға мөртаңба қосу. - Ваучерді шығару (үлгіленген немесе реттелетін, Redeem Code арқылы). - Ваучерді өтеу (егер сіз өзіңіздің POS арқылы жұмыс жасасаңыз). - Картаның оқу күйі, барысы, тарихы. - Оқиғаларды нақты уақытта алу үшін Webhooks ​​жазылыңыз.

Webhooks

Webhooks карта оқиғаларын сыртқы жүйеге жібереді. Қолдау көрсетіледі (оқиға глоссарийі қараңыз): - card_issued, card_saved, card_opened. - stamp_added. - goal_reached, reward_issued. - voucher_issued, voucher_redeemed, voucher_expired. - lottery_played (нәтижесі бар). - birthday_reached. - inactivity_trigger. - campaign_sent.

Webhook пайдалы жүктеме мысалы

{
  "event": "voucher_redeemed",
  "timestamp": "2026-05-11T12:34:56Z",
  "business_id": "b_123",
  "location_id": "loc_45",
  "клиент": {
    "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"
  }
}

Дайын POS интеграциялары - Poster — дайын интеграция, бірнеше рет басу арқылы қосылады. - Serve — дайын интеграция. - Басқа дақылдар — сұраныс бойынша жасалады. Техникалық тұрғыдан мүмкін болса, тегін (яғни, сіздің API немесе Webhooks ашық болған жағдайда).

Messenger 7loc.com арқылы таратады

WhatsApp, Telegram, Viber таратылымдары үшін 7loc.com интеграциясы қосылған. active болғаннан кейін “хабаршылар” арнасы Campaigns ішінде PUSH және Email жанында қолжетімді болады.

Кодсыз сценарийлер: Zapier және Make

7stamp API + Webhooks Zapier және Make (Integromat) көмегімен жұмыс істейді, сценарийлерді кодтаусыз құруға мүмкіндік береді: - “voucher_redeemed кезде — Mailchimp ішінде тег қосыңыз”. - “goal_reached кезде — Slack нөміріне хабарлама жіберу”. - “birthday_reached кезде — CRM ішінде тапсырма жасаңыз”.

---