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):

• SCAN, DELIVERY_INSERT.
• REWARD_EARNED, LOTTERY_WIN.
• VOUCHER_ISSUED, ADMIN_VOUCHER_ISSUE, VOUCHER_REDEEMED.
• CARD_JOINED, CARD_ADDED_TO_WALLET, CARD_REMOVED_FROM_WALLET.
• CARD_CAMPAIGN, BIRTHDAY_GREETING.

Eksempel på Webhook-payload

{
  "entity": "card_event",
  "action": "created",
  "entity_id": 707,
  "event_id": "8f05e58decec48e09d328f0edebbacf6",
  "profile_id": 2,
  "profile_name": "Your Business",
  "profile_lang": "en",
  "data": {
    "event_type": "SCAN",
    "scanned_at": "2026-10-01T09:19:24.179424",
    "user_card_id": 10,
    "card_template_id": 14,
    "card_template_name": "Collect your stamps!",
    "stamps_added": 3,
    "stamps_before": 1,
    "stamps_after": 4,
    "amount": null,
    "external_order_id": "ORDER-1001",
    "workplace": { "id": 4, "name": "Bar Counter" },
    "device_type": null,
    "external_id": "odoo_contact_8821",
    "external_source": "odoo",
    "issued_vouchers": [
      {
        "id": 174,
        "unique_code": "100425813507",
        "stamp_number": 4,
        "issued_at": "2026-10-01T09:19:24.191836",
        "expires_at": "2027-01-01T23:59:59",
        "status": "ACTIVE",
        "voucher_template_id": 58,
        "voucher_description": "Free coffee",
        "voucher_image_url": "https://..."
      }
    ],
    "achieved_goals": [],
    "user": {
      "id": 2,
      "name": "Anna",
      "full_name": "Anna Smith",
      "email": "anna@example.com",
      "telegram_chat_id": null,
      "telegram_username": null,
      "whatsapp_phone": null,
      "birth_date": null
    }
  }
}

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 REWARD_EARNED — send varsel til Slack».
• «Når BIRTHDAY_GREETING — opprett oppgave i CRM».

---