API & Integrationen

14. API & Integrationen

[Screenshot: 0601_Apikey.png]

Der Abschnitt API & Integrationen enthält Tools für die programmatische Integration von 7stamp mit Ihren externen Systemen – CRM, POS, ERP, Analysen, Messenger-Bots.

API Keys

Die Hauptseite des Abschnitts ist die Schlüsselliste API. Spalten:

• Name – Tastenname (entspricht normalerweise dem verknüpften Notensystemnamen).
• Login – der Mitarbeiter-Login, an den der Schlüssel gebunden ist.
• API-Schlüssel – der Schlüssel selbst (beginnt mit „7loc_sc_…“, standardmäßig ausgeblendet, mit einem Klick kopierbar).
• Status – „Aktiv“.
• 🔄 – Schlüssel neu generieren.
• 🗑️ – Löschen Sie den Schlüssel.

Erstellen eines API-Schlüssels

[Screenshot: 0602_Apikey.png]

Tippen Sie auf + API-SCHLÜSSEL HINZUFÜGEN – das Popup-Fenster Generiere API-Schlüssel wird geöffnet:

• Scanner – Dropdown-Menü zur Auswahl der Staff Login, an die der Schlüssel gebunden werden soll (ein Stab kann einen Schlüssel haben).
• Schaltflächen ABBRECHEN / ERSTELLEN.

Nach GENERATE wird der Schlüssel erstellt und erscheint in der Liste. Kopieren Sie ihn sofort – der vollständige Schlüssel wird möglicherweise nicht erneut angezeigt.

Was Sie über die API tun können

• Stellen Sie einem Kunden per E-Mail/Telefon eine Karte aus.
• Fügen Sie einem bestimmten Kunden eine stamp hinzu.
• Stellen Sie einen Gutschein aus (vorgefertigt oder benutzerdefiniert, mit Redeem Code).
• Gutschein einlösen (wenn Sie über Ihre eigene POS arbeiten).
• Status lesen der Karte, Fortschritt, Verlauf.
• Abonnieren Sie Webhooks, um Ereignisse in Echtzeit zu erhalten.

Webhooks

Webhooks senden Kartenereignisse an ein externes System. Unterstützt (siehe Veranstaltungsglossar):

• „card_issued“, „card_saved“, „card_opened“.
• stamp_added.
• „goal_reached“, „reward_issued“.
• „voucher_issued“, „voucher_redeemed“, „voucher_expired“.
• lottery_played (mit dem Ergebnis).
• birthday_reached.
• inactivity_trigger.
• campaign_sent.

Beispiel für eine Webhook-Nutzlast

„json { „event“: „voucher_redeemed“, „timestamp“: „2026-05-11T12:34:56Z“, „business_id“: „b_123“, „location_id“: „loc_45“, “Kunde”: { „id“: „c_789“, „wallet_pass_id“: „wp_abc“, „Sprache“: „en“ }, „card“: { „id“: „card_001“, „goal_index“: 2 }, “Gutschein”: { „id“: „v_555“, „Typ“: „Gutschein“, „redeem_code“: „FREECOFFEE“, „redeem_code_formats“: [„text“, „qr“, „barcode“], „status“: „eingelöst“, „redeemed_via“: „staff_scanner“ } }

### Fertige POS-Integrationen

- **Poster** – fertige Integration, Verbindung mit wenigen Klicks.
- **Servieren** – fertige Integration.
- **Andere Kassen** — auf Anfrage. **Kostenlos, sofern technisch machbar** (d. h. Ihre Kasse weist eine offene API oder Webhooks auf).

### Messenger-Übertragungen über 7loc.com

Für WhatsApp-, Telegram- und Viber-Sendungen ist die **7loc.com**-Integration verbunden. Sobald der Kanal „Messengers“ aktiv ist, wird er in den Kampagnen neben PUSH und Email verfügbar.

### No-Code-Szenarien: Zapier und Make

7stamp API \+ Webhooks funktionieren mit **Zapier** und **Make (Integromat)**, sodass Sie Szenarien ohne Codierung erstellen können:

- „Bei „voucher_redeemed“ – fügen Sie ein Tag in Mailchimp hinzu.“
- „Wenn `goal_reached` — eine Benachrichtigung an Slack senden.“
- „Wenn `birthday_reached` — eine Aufgabe in CRM erstellen“.

---