API & Integrations

14. API & Integrations

Секција API & Integrations садржи алате за програмску интеграцију 7stamp-а са вашим спољним системима — CRM, POS, ERP, аналитика, messenger ботови.

API кључеви

Главна страница секције је списак API кључева. Колоне:

• Name — назив кључа (обично одговара имену повезаног Staff).
• Login — Staff login за који је кључ везан.
• API Key — сам кључ (почиње са 7loc_sc_..., према подразумеваним подешавањима скривен, копира се једним кликом).
• Status — Active.
• 🔄 — регенерисање кључа.
• 🗑️ — брисање кључа.

Креирање API кључа

Додирните + ADD API KEY — отвара се popup Generate API Key:

• Scanner — dropdown за избор Staff Login-а за који ће кључ бити везан (један Staff може имати један кључ).
• Дугмад CANCEL / GENERATE.

После GENERATE кључ је креиран и појављује се у списку. Копирајте га одмах — цео кључ можда неће бити поново приказан.

Шта можете да радите преко API-ја

• Издати картицу купцу путем имејла/телефона.
• Додати stamp одређеном купцу.
• Издати voucher (по шаблону или прилагођен, са Redeem Code).
• Откупити voucher (ако радите путем сопственог 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.

Пример payload-а Webhook-а

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

Готове POS интеграције

• Poster — готова интеграција, повезује се са неколико кликова.
• Serve — готова интеграција.
• Остале благајне — раде се на захтев. Бесплатно ако је технички изводљиво (тј. ваша благајна излаже отворен API или Webhooks).

Messenger емисије путем 7loc.com

За WhatsApp, Telegram, Viber емисије повезана је интеграција 7loc.com. Након активације, канал “messengers” постаје доступан у Campaigns уз PUSH и Email.

No-code сценарији: Zapier и Make

7stamp API + Webhooks раде са Zapier и Make (Integromat), што вам омогућава да градите сценарије без кодирања:

• “Када voucher_redeemed — додај ознаку у Mailchimp”.
• “Када goal_reached — пошаљи обавештење у Slack”.
• “Када birthday_reached — креирај задатак у CRM-у”.

---