API & Integrations

14. API & Integrations

Avsnittet API & Integrations innehåller verktyg för programmatisk koppling av 7stamp till externa system — CRM, POS, ERP, analys, messenger‑bots.

API Keys

Huvudsidan för avsnittet är nyckellistan. Kolumner:

• Name — namn på nyckeln (matchar ofta kopplad Staff‑profil).
• Login — Staff‑inloggning som nyckeln är kopplad till.
• API Key — själva nyckeln (börjar med 7loc_sc_..., dold som standard, kopieras med ett klick).
• Status — Active.
• 🔄 — återskapa nyckel.
• 🗑️ — ta bort nyckel.

Skapa API‑nyckel

Tryck + ADD API KEY — popup Generate API Key:

• Scanner — rullista för Staff Login nyckeln ska bindas till (en Staff kan ha en nyckel).
• Knapparna CANCEL / GENERATE.

Efter GENERATE skapas nyckeln och visas i listan. Kopiera den direkt — hela nyckeln visas kanske inte igen.

Vad du kan göra via API

• Utfärda kort till kund via e‑post/telefon.
• Lägga till stamp på specifik kund.
• Utfärda voucher (mall eller anpassad, med Redeem Code).
• Lösa in voucher (om ni jobbar via egen POS).
• Läsa status för kort, framsteg, historik.
• Prenumerera på Webhooks för realtidshändelser.

Webhooks

Webhooks skickar korthändelser till externt system. Stödda (se event glossary):

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

Exempel på 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"
  }
}

Färdiga POS‑integrationer

• Poster — färdig integration, kopplas på några klick.
• Serve — färdig integration.
• Övriga kassor — på begäran. Gratis om tekniskt genomförbart (dvs. er kassa exponerar öppet API eller Webhooks).

Messenger‑utskick via 7loc.com

För WhatsApp, Telegram och Viber kopplas integration med 7loc.com. När den är aktiv kan kanalen ”messengers” användas i Campaigns bredvid PUSH och E‑post.

No‑code: Zapier och Make

7stamp API + Webhooks fungerar med Zapier och Make (Integromat) för scenarier utan kod:

• ”När voucher_redeemed — lägg till tagg i Mailchimp”.
• ”När goal_reached — skicka avisering till Slack”.
• ”När birthday_reached — skapa uppgift i CRM”.

---