API & Integrations

14. API & Integrations

Het onderdeel API & Integrations bevat de tools om 7Stamp via code te koppelen aan je externe systemen — CRM, POS, ERP, analysetools en chatbots in messengers.

API-sleutels

De hoofdpagina van dit onderdeel is de lijst met API-sleutels. Kolommen:

• Name — naam van de sleutel (meestal gelijk aan de naam van de gekoppelde medewerker).
• Login — de medewerkerslogin waaraan de sleutel gekoppeld is.
• API Key — de sleutel zelf (begint met 7loc_sc_..., standaard verborgen, met één klik te kopiëren).
• Status — Active.
• 🔄 — de sleutel opnieuw genereren.
• 🗑️ — de sleutel verwijderen.

Een API-sleutel aanmaken

Tik op + ADD API KEY — het venster Generate API Key opent:

• Scanner — keuzelijst om de medewerkerslogin te kiezen waaraan de sleutel wordt gekoppeld (één medewerker kan één sleutel hebben).
• Knoppen CANCEL / GENERATE.

Na GENERATE wordt de sleutel aangemaakt en verschijnt hij in de lijst. Kopieer hem meteen: de volledige sleutel wordt mogelijk niet opnieuw getoond.

Wat je via de API kunt doen

• Een kaart uitgeven aan een klant op basis van e-mailadres of telefoonnummer.
• Een stempel toevoegen bij een specifieke klant.
• Een voucher uitgeven (op basis van een sjabloon of op maat, met Redeem Code).
• Een voucher inwisselen (als je met je eigen kassasysteem werkt).
• De status opvragen van de kaart, de voortgang en de geschiedenis.
• Je abonneren op webhooks om gebeurtenissen realtime te ontvangen.

Webhooks

Webhooks sturen gebeurtenissen van de kaart naar een extern systeem. Ondersteund (zie de lijst met gebeurtenissen):

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

Voorbeeld van een 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
    }
  }
}

Kant-en-klare POS-koppelingen

• Poster — kant-en-klare koppeling, in een paar klikken ingesteld.
• Serve — kant-en-klare koppeling.
• Andere kassasystemen — op aanvraag. Gratis als het technisch mogelijk is (dat wil zeggen: je kassa heeft een open API of webhooks).

Berichten via messengers met 7loc.com

Voor berichten via WhatsApp, Telegram en Viber wordt de koppeling met 7loc.com gebruikt. Zodra die actief is, komt in Campaigns naast PUSH en Email ook het kanaal „messengers” beschikbaar.

Scenario’s zonder code: Zapier en Make

De 7Stamp API en webhooks werken met Zapier en Make (Integromat), zodat je scenario’s kunt bouwen zonder te programmeren:

• „Bij VOUCHER_REDEEMED — voeg een tag toe in Mailchimp”.
• „Bij REWARD_EARNED — stuur een melding naar Slack”.
• „Bij BIRTHDAY_GREETING — maak een taak aan in het CRM”.

---