Die Anbindung eines externen Prämienshops an den Employee Referrals-Account ermöglicht es Mitarbeitenden, gesammelte Punkte gegen Prämien im bestehenden System einzulösen. Die Integration erfolgt über Webhooks und erfordert eine entsprechende technische Umsetzung durch den Kunden oder den externen Prämienshop.
Employee Referrals stellt Webhooks zur Verfügung, die Informationen über Empfehlungsaktivitäten übermitteln können – insbesondere zu folgenden Ereignissen:
-
Prämie genehmigt (rewards.approved)
-
Punkte erhalten (points.gained)
-
Punkte widerrufen (points.revoked)
Weitere Informationen sind hier verfügbar.
Verwendbare Webhooks
Für die erfolgreiche Anbindung sollten die folgenden Webhook-Ereignisse verwendet werden:
-
Prämie genehmigt (rewards.approved): Wird ausgelöst, wenn eine Prämie genehmigt wird (z. B. bei einer erfolgreichen Einstellung).
-
Punkte erhalten (points.gained): Wird ausgelöst, wenn Empfehlungsaktivitäten mit Punkten belohnt werden.
-
Punkte widerrufen (points.revoked): Wird ausgelöst, wenn Punkte aufgrund einer Änderung im Empfehlungsstatus entfernt werden.
Die technische Umsetzung der Anbindung erfolgt durch den Kunden oder den externen Prämienshop auf Basis dieser Webhook-Ereignisse.
Einrichtung von Webhooks in Employee Referrals
Webhook-Konfigurationen können direkt im System von einer Administratorrolle vorgenommen werden:
-
Navigieren zu Accounteinstellungen > Integration > Webhooks
-
Auswahl von „Webhook hinzufügen“
-
Angabe von Bezeichnung (Name des Webhooks) und URL (Ziel-Endpunkt für die Datenübertragung)
-
Aktivieren des Webhooks und Auswahl der relevanten Ereignisse
-
Optional: Hinzufügen einer Authentifizierung
-
Durchführung eines Tests, um sicherzustellen, dass der Ziel-Endpunkt die erwarteten Daten empfängt
Nach erfolgreicher Konfiguration wird die automatisierte Übertragung von Prämien- und Punkteinformationen an das externe System ermöglicht.
Verlinkung des externen Prämienshops
Die URL zum Prämienshop kann in den Einstellungen individuell angepasst und mit einem externen Shop verknüpft werden.
Hinweis: Mitarbeitende benötigen ein aktives Profil sowohl in Employee Referrals als auch im externen Prämienshop, um Punkte einlösen zu können.
Bei Bedarf kann eine weiterführende technische Dokumentation zur Verfügung gestellt werden.