API & Integrations

14. API & Integrations

Seksjonen API & Integrations inneholder verktøy for programmatisk integrasjon av 7stamp med eksterne systemer — CRM, POS, ERP, analyse, messenger-boter.

API Keys

Hovedsiden for seksjonen er API-nøkkellisten. Kolonner:

• Name — nøkkelnavn (samsvarer ofte med tilknyttet Staff-navn).
• Login — Staff-innloggingen nøkkelen er knyttet til.
• API Key — selve nøkkelen (starter med 7loc_sc_..., skjult som standard, kopieres med ett klikk).
• Status — Active.
• 🔄 — regenerer nøkkel.
• 🗑️ — slett nøkkel.

Opprette API-nøkkel

Trykk + ADD API KEY — popupen Generate API Key åpner:

• Scanner — rullegardin for å velge Staff Login nøkkelen bindes til (én Staff kan ha én nøkkel).
• Knapper CANCEL / GENERATE.

Etter GENERATE opprettes nøkkelen og vises i listen. Kopier den med én gang — hele nøkkelen vises kanskje ikke igjen.

Hva du kan via API-et

• Issue a card til kunde på e-post/telefon.
• Add a stamp til en bestemt kunde.
• Issue a voucher (mal eller tilpasset, med Redeem Code).
• Redeem a voucher (hvis du jobber via eget POS).
• Read state for kortet, fremdrift, historikk.
• Subscribe to Webhooks for å motta hendelser i sanntid.

Webhooks

Webhooks sender korthendelser til et ekstern system. Støttede (se hendelsesordlisten):

• 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.

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

Ferdige POS-integrasjoner

• Poster — ferdig integrasjon, kobles med noen klikk.
• Serve — ferdig integrasjon.
• Andre kasse­systemer — lages på forespørsel. Gratis hvis teknisk mulig (dvs. kassen har åpent API eller Webhooks).

Messenger-utsendelser via 7loc.com

For WhatsApp-, Telegram-, Viber-broadcasts kobles 7loc.com-integrasjonen. Når den er aktiv, blir «messengers»-kanalen tilgjengelig i Campaigns ved siden av PUSH og e-post.

No-code-scenarier: Zapier og Make

7stamp API + Webhooks fungerer med Zapier og Make (Integromat), slik at du kan bygge flyt uten kode:

• «Når voucher_redeemed — legg til tag i Mailchimp».
• «Når goal_reached — send varsel til Slack».
• «Når birthday_reached — opprett oppgave i CRM».

---