API & Integrations

14. API & Integrations

Secțiunea API & Integrations conține instrumente pentru integrarea programatică a 7stamp cu sistemele tale externe — CRM, POS, ERP, analytics, boți de mesagerie.

API Keys

Pagina principală a secțiunii este lista de chei API. Coloane:

• Name — numele cheii (de obicei corespunde numelui Staff legat).
• Login — Staff Login de care este legată cheia.
• API Key — cheia propriu-zisă (începe cu 7loc_sc_..., ascunsă implicit, copiabilă cu un click).
• Status — Active.
• 🔄 — regenerează cheia.
• 🗑️ — șterge cheia.

Crearea unei chei API

Apasă + ADD API KEY — se deschide popup-ul Generate API Key:

• Scanner — dropdown pentru alegerea Staff Login-ului de care va fi legată cheia (un Staff poate avea o singură cheie).
• Butoane CANCEL / GENERATE.

După GENERATE, cheia este creată și apare în listă. Copiaz-o imediat — cheia completă poate să nu mai fie afișată din nou.

Ce poți face prin API

• Emite un card către un client prin email/telefon.
• Adaugă o Stamp unui anumit client.
• Emite un Voucher (templated sau custom, cu Redeem Code).
• Validează un Voucher (dacă lucrezi prin propriul POS).
• Citește starea cardului, progresul, istoricul.
• Abonează-te la Webhooks pentru a primi evenimente în timp real.

Webhooks

Webhooks trimit evenimente de card către un sistem extern. Acceptate (vezi glosarul de evenimente):

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

Exemplu de 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"
  }
}

Integrări POS gata făcute

• Poster — integrare gata făcută, se conectează în câteva clickuri.
• Serve — integrare gata făcută.
• Alte case — realizate la cerere. Gratuit dacă este fezabil tehnic (adică dacă sistemul de casă expune un API deschis sau Webhooks).

Broadcasturi prin mesagerii via 7loc.com

Pentru broadcasturi WhatsApp, Telegram, Viber, se conectează integrarea 7loc.com. Odată activă, canalul „messengers” devine disponibil în Campaigns lângă PUSH și Email.

Scenarii no-code: Zapier și Make

7stamp API + Webhooks funcționează cu Zapier și Make (Integromat), permițându-ți să construiești scenarii fără cod:

• „Când voucher_redeemed — adaugă un tag în Mailchimp”.
• „Când goal_reached — trimite o notificare în Slack”.
• „Când birthday_reached — creează un task în CRM”.

---