Mit Webhooks informiert Loyaltify Ihre anderen Systeme sofort, wenn etwas passiert, zum Beispiel wenn sich ein neuer Kunde anmeldet oder ein Kunde Punkte sammelt. Loyaltify sendet eine kurze Nachricht an eine Adresse Ihrer Wahl, und Ihr System kann darauf reagieren.

Sie sind nützlich, um ein CRM aktuell zu halten, E-Mails in Ihren eigenen Tools auszulösen oder Berichte zu erstellen. Diese Anleitung erklärt, wie Sie einen Webhook einrichten, was jede Nachricht enthält und wie Sie prüfen, ob die Nachrichten ankommen.

💡 Gut zu wissen: Das ist Teil des Tarifs Advanced. Wenn Sie in einen kleineren Tarif wechseln, funktioniert es nicht mehr.

Einen Webhook einrichten

Schritt 1: Die Webhook-Einrichtung öffnen

Gehen Sie zu Integrationen und klicken Sie auf der Karte Webhook auf Verbinden.

Schritt 2: Die Details ausfüllen

Im Fenster Webhook-Einrichtung:

Endpoint-URL: die https-Adresse in Ihrem System, die die Nachrichten empfangen soll.
Autorisierung: Wählen Sie Bearer und geben Sie einen eigenen Token ein, oder wählen Sie Keine.
Ereignisse: Setzen Sie bei den gewünschten ein Häkchen. Sie brauchen mindestens eines.

Speichern Sie dann, und Ihr Webhook ist aktiv.

💡 Tipp: Wählen Sie Bearer und einen langen, zufälligen Token. Jede Nachricht enthält dann den Header Authorization: Bearer, gefolgt von Ihrem Token, sodass Ihr System prüfen kann, ob die Nachricht wirklich von Loyaltify stammt. Dieser Token ist unabhängig von Ihrem API-Schlüssel.

Später ändern

Sie können den Endpoint, die Autorisierung und die Ereignisse jederzeit auf der Seite Webhook-Konfiguration ändern. Klicken Sie anschließend auf Speichern.

Ereignisse, die Sie auswählen können

Kunde erstellt (customer.created): Ein neuer Kunde meldet sich an.
Kunde aktualisiert (customer.updated): Die Daten eines Kunden werden bearbeitet.
Transaktion erstellt (transaction.created): Ein Kunde erhält seinen Anfangsstand, sammelt, löst ein, bekommt eine Empfehlungsprämie oder seine Punkte laufen ab.
Anmeldeversuch eines bestehenden Kunden (customer.signup_attempt): Jemand, der die Karte bereits hat, füllt Ihr Formular erneut aus. Seine gespeicherten Daten werden durch die neue Übermittlung nicht geändert.

Was jede Nachricht enthält

Loyaltify sendet jede Nachricht als JSON, mit den Headern Content-Type: application/json und User-Agent: Loyaltify-Webhook/1.0. Jede Nachricht besteht aus drei Teilen:

event: um welches Ereignis es sich handelt, zum Beispiel customer.created.
timestamp: wann es passiert ist, in UTC (zum Beispiel 2026-10-16T16:38:46Z).
data: die Details, die vom Ereignis abhängen.

Zahlen wie point und balance_after werden als Text gesendet, zum Beispiel "1.0", und leere Werte sind null.

Kunde erstellt und Kunde aktualisiert

name, email, phone und birthday
uuid: die ID des Kunden (dieselbe wie im QR-Code seiner Karte)
point: sein Stand (bei Kunde erstellt der Anfangsstand)
custom_fields: Antworten auf Ihre eigenen Fragen, einschließlich versteckter Werte aus dem Formularlink, zum Beispiel click_id
is_marketing_opted_in: ob er in Marketing eingewilligt hat
created_at, updated_at und store_uuid

Kunde aktualisiert enthält dieselben Felder, mit den neuen Werten. Hier ein Beispiel für Kunde erstellt:

{
  "data": {
    "name": "Alex",
    "uuid": "7f3e9a21",
    "email": "[email protected]",
    "phone": null,
    "point": "1.0",
    "birthday": null,
    "created_at": "2026-10-16T16:38:41.704Z",
    "store_uuid": "a1b2c3d4",
    "updated_at": "2026-10-16T16:38:46.790Z",
    "custom_fields": {},
    "is_marketing_opted_in": true
  },
  "event": "customer.created",
  "timestamp": "2026-10-16T16:38:46Z"
}

Transaktion erstellt

kind: die Art der Transaktion, zum Beispiel initial (der Anfangsstand bei der Anmeldung), manual, redeem, expired, referee oder referrer
point und amount: die Werte der Transaktion. Bei abgelaufenen Punkten ist point negativ.
balance_after: der Stand des Kunden nach der Transaktion
campaign: bei Einlösungen die eingelöste Kampagne
user: das Teammitglied, das gescannt hat (Name, ID und E-Mail), oder null bei automatischen Ereignissen wie abgelaufenen Punkten
customer_uuid, customer_email und customer_phone
referred_by_uuid: bei Empfehlungsprämien, wer den Kunden empfohlen hat
uuid: die eigene ID der Transaktion
created_at und store_uuid

Hier ein Beispiel, bei dem ein Teammitglied einen Punkt hinzufügt:

{
  "data": {
    "kind": "manual",
    "user": {
      "name": "Sam Taylor",
      "uuid": "0b8e7d4c-1f2a-4c3b-9d5e-6a7b8c9d0e1f",
      "email": "[email protected]"
    },
    "uuid": "5c9d2e7a-3b4f-4a1c-8e6d-2f7a9b0c1d3e",
    "point": "1.0",
    "amount": null,
    "campaign": null,
    "created_at": "2026-10-16T16:45:10.375Z",
    "store_uuid": "a1b2c3d4",
    "balance_after": "2.0",
    "customer_uuid": "7f3e9a21",
    "customer_email": "[email protected]",
    "customer_phone": null,
    "referred_by_uuid": null
  },
  "event": "transaction.created",
  "timestamp": "2026-10-16T16:45:10Z"
}

Eine Empfehlungsprämie sendet zwei Transaktionen gleichzeitig: referee für den neuen Kunden, wobei referred_by_uuid auf die ID des Werbenden gesetzt ist, und referrer für den Kunden, der ihn empfohlen hat.

Anmeldeversuch eines bestehenden Kunden

customer: wer der bestehende Kunde ist, mit seiner uuid und seinen custom_fields
matched_on: wie er erkannt wurde, zum Beispiel anhand der E-Mail-Adresse
submission: was er gerade ins Formular eingegeben hat
form: welches Formular er verwendet hat

Um eine vollständige Nachricht zu sehen, öffnen Sie eine beliebige Zustellung unter Letzte Ereignisse (siehe unten).

Ihre Zustellungen prüfen

Die Seite Webhook-Konfiguration zeigt unter Letzte Ereignisse Ihre Zustellungen mit Status, Antwortcode, Anzahl der Versuche und Datum. Klicken Sie auf das Augen-Symbol, um genau zu sehen, was gesendet wurde, mit den Headern und der Antwort Ihres Systems.

Nachrichten kommen nicht an?

Prüfen Sie, ob Ihre Endpoint-URL eine gültige https-Adresse ist. Browser füllen dort manchmal automatisch eine E-Mail-Adresse ein.
Prüfen Sie, ob das Ereignis auf der Seite Webhook-Konfiguration angehakt ist.
Prüfen Sie, ob Sie den Tarif Advanced haben.
Sehen Sie sich das Ereignis unter Letzte Ereignisse an. Wenn der Antwortcode einen Fehler zeigt, hat Ihr System die Nachricht erhalten, aber abgelehnt, und das Augen-Symbol zeigt seine Antwort.

Sie kommen trotzdem nicht weiter? Schreiben Sie dem Support über den Live-Chat.

Gut zu wissen

Nachrichten kommen nicht unbedingt in der richtigen Reihenfolge an. Nutzen Sie deshalb den Zeitstempel, wenn die Reihenfolge wichtig ist.
Richten Sie Ihr System so ein, dass es dasselbe Ereignis auch zweimal verarbeiten kann, nur für den Fall. Bei Transaktionen ist die uuid in data für jede einzelne eindeutig.
Sie arbeiten mit der API? Webhooks senden die kurze ID des Kunden. Manche API-Anfragen brauchen stattdessen die interne Nummer des Kunden, und die API-Dokumentation zeigt, wie Sie die eine anhand der anderen nachschlagen.
Sie nutzen Omnisend? Die Anleitung von Omnisend verwendet einen Webhook, um sich mit Loyaltify zu verbinden. Den Link finden Sie unter Integrationen im Überblick.

Brauchen Sie Hilfe?

Wir helfen Ihnen gern!

Wenn Sie Fragen zu Webhooks haben, schreiben Sie uns über den Live-Chat in Loyaltify oder nutzen Sie den Chat-Button unten rechts auf dieser Seite. Unser Team hilft Ihnen gern weiter.

Verwandte Artikel

Anmeldeformulare