API & Integrations

14. API & Integrations

Sehemu ya API & Integrations ina zana za programmatic integration ya 7stamp na mifumo yako ya nje — CRM, POS, ERP, analytics, messenger bots.

API Keys

Ukurasa mkuu wa sehemu hii ni orodha ya API keys. Columns:

• Name — jina la key (kwa kawaida hulingana na Staff name iliyounganishwa).
• Login — Staff login ambayo key imefungwa nayo.
• API Key — key yenyewe (huanza na 7loc_sc_..., imefichwa by default, inaweza kukopiwa kwa click moja).
• Status — Active.
• 🔄 — zalisha key upya.
• 🗑️ — futa key.

Kuunda API key

Bonyeza + ADD API KEY — popup ya Generate API Key itafunguka:

• Scanner — dropdown ya kuchagua Staff Login ambayo key itafungwa nayo (Staff mmoja anaweza kuwa na key moja).
• Buttons za CANCEL / GENERATE.

Baada ya GENERATE, key itaumbwa na itaonekana kwenye orodha. Ikope mara moja — huenda key kamili isionyeshwe tena.

Unachoweza kufanya kupitia API

• Toa Card kwa mteja kwa email/phone.
• Ongeza Stamp kwa mteja mahususi.
• Toa voucher (templated au custom, yenye Redeem Code).
• Redeem voucher (ikiwa unafanya kazi kupitia POS yako mwenyewe).
• Soma state ya Card, progress, na history.
• Jiunge na Webhooks ili kupokea events kwa wakati halisi.

Webhooks

Webhooks hutuma card events kwa mfumo wa nje. Supported ni hizi (tazama event glossary):

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

Webhook payload example

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

Ready-made POS integrations

• Poster — ready-made integration, inaunganishwa kwa clicks chache.
• Serve — ready-made integration.
• Other tills — hutengenezwa kwa ombi. Bure ikiwa technically feasible (yaani till yako ina open API au Webhooks).

Messenger broadcasts via 7loc.com

Kwa broadcasts za WhatsApp, Telegram, na Viber, integration ya 7loc.com huunganishwa. Ikishawezeshwa, channel ya “messengers” itapatikana kwenye Campaigns karibu na PUSH na Email.

No-code scenarios: Zapier and Make

7stamp API + Webhooks hufanya kazi na Zapier na Make (Integromat), hivyo unaweza kujenga scenarios bila coding:

• “When voucher_redeemed — add a tag in Mailchimp”.
• “When goal_reached — send a notification to Slack”.
• “When birthday_reached — create a task in CRM”.

---