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

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

Beispiel für eine Webhook-Nutzlast

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

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 REWARD_EARNED — eine Benachrichtigung an Slack senden.“
• „Wenn BIRTHDAY_GREETING — eine Aufgabe in CRM erstellen“.

---