API & Integrationen

14. API & Integrationen

Der Bereich API & Integrationen enthält Tools für die programmatische Integration von 7stamp mit Ihren externen Systemen — CRM, Kassensystem, ERP, Analytik, Messenger-Bots.

API-Schlüssel

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

• Name — Schlüsselname (entspricht meist dem verknüpften Mitarbeiternamen).
• Login — das Mitarbeiter-Login, an das 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.
• 🗑️ — Schlüssel löschen.

Einen API-Schlüssel erstellen

Tippen Sie auf + API-SCHLÜSSEL HINZUFÜGEN — das Popup API-Schlüssel generieren öffnet sich:

• Scanner — Dropdown zur Auswahl des Mitarbeiter-Logins, an das der Schlüssel gebunden wird (ein Mitarbeiter kann einen Schlüssel haben).
• Schaltflächen ABBRECHEN / GENERIEREN.

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

Was Sie über die API tun können

• Eine Karte ausstellen an einen Kunden per E-Mail/Telefon.
• Einen Stempel hinzufügen zu einem bestimmten Kunden.
• Einen Gutschein ausstellen (vorlagiert oder benutzerdefiniert, mit Einlösecode).
• Einen Gutschein einlösen (wenn Sie über Ihr eigenes Kassensystem arbeiten).
• Zustand lesen der Karte, Fortschritt, Verlauf.
• Webhooks abonnieren, um Ereignisse in Echtzeit zu empfangen.

Webhooks

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

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

Webhook-Payload-Beispiel

{
  "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": "de"
  },
  "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"
  }
}

Fertige Kassenintegrationen

• Poster — fertige Integration, in wenigen Klicks verbunden.
• Serve — fertige Integration.
• Andere Kassensysteme — auf Anfrage erstellt. Kostenlos, wenn technisch machbar (d. h. Ihr Kassensystem bietet eine offene API oder Webhooks).

Messenger-Broadcasts via 7loc.com

Für WhatsApp-, Telegram-, Viber-Broadcasts wird die 7loc.com-Integration verbunden. Sobald aktiv, wird der Kanal “Messenger” in Kampagnen neben PUSH und E-Mail verfügbar.

No-Code-Szenarien: Zapier und Make

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

• “Wenn voucher_redeemed — Tag in Mailchimp hinzufügen”.
• “Wenn goal_reached — Benachrichtigung an Slack senden”.
• “Wenn birthday_reached — Aufgabe im CRM erstellen”.

---