API & Integrations

14. API & Integrations

Sekcja API & Integrations zawiera narzędzia do programowej integracji 7stamp z twoimi zewnętrznymi systemami — CRM, POS, ERP, analityką i messenger bots.

API Keys

Główna strona sekcji to lista API key. Kolumny:

• Name — nazwa klucza (zwykle odpowiada powiązanemu Staff name).
• Login — Staff login, do którego przypisany jest klucz.
• API Key — sam klucz (zaczyna się od 7loc_sc_..., domyślnie ukryty, kopiowalny jednym kliknięciem).
• Status — Active.
• 🔄 — zregeneruj klucz.
• 🗑️ — usuń klucz.

Tworzenie API key

Kliknij + ADD API KEY — otworzy się popup Generate API Key:

• Scanner — dropdown do wyboru Staff Login, z którym klucz zostanie powiązany (jeden Staff może mieć jeden klucz).
• Przyciski CANCEL / GENERATE.

Po GENERATE klucz zostaje utworzony i pojawia się na liście. Skopiuj go od razu — pełny klucz może nie zostać ponownie pokazany.

Co można zrobić przez API

• Issue a card klientowi przez email/phone.
• Add a stamp konkretnemu klientowi.
• Issue a voucher (szablonowy albo custom, z Redeem Code).
• Redeem a voucher (jeśli pracujesz przez własny POS).
• Read state karty, postęp i historię.
• Subscribe to Webhooks, aby otrzymywać zdarzenia w czasie rzeczywistym.

Webhooks

Webhooks wysyłają card events do systemu zewnętrznego. Obsługiwane są (zobacz event glossary):

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

Przykład webhook payload

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

Gotowe POS integrations

• Poster — gotowa integracja, łączy się w kilka kliknięć.
• Serve — gotowa integracja.
• Inne kasy — robione na zamówienie. Bezpłatnie, jeśli jest to technicznie możliwe (czyli twoja kasa udostępnia otwarte API albo Webhooks).

Broadcasty w komunikatorach przez 7loc.com

Dla broadcastów WhatsApp, Telegram i Viber podłączana jest integracja z 7loc.com. Po aktywacji w Campaigns pojawia się kanał “messengers” obok PUSH i Email.

No-code scenariusze: Zapier i Make

7stamp API + Webhooks działają z Zapier i Make (Integromat), co pozwala budować scenariusze bez kodowania:

• “Gdy voucher_redeemed — dodaj tag w Mailchimp”.
• “Gdy goal_reached — wyślij notification do Slacka”.
• “Gdy birthday_reached — utwórz task w CRM”.

---