Entwicklerintegration
Übertragen Sie jedes Treueereignis von 7stamp in Echtzeit auf Ihre eigenen Systeme. Keine Umfragen und keine geplanten API-Anrufe. Ereignisse kommen als HTTPS POST-Anfragen innerhalb von Sekunden nach ihrem Eintreten an.
Verwenden Sie Webhooks, um Ihr CRM, ERP oder Ihr benutzerdefiniertes Backend mit den Ereignissen auf der Treueseite synchron zu halten: Wer ist beigetreten, wer hat einen Stempel erhalten, wer hat einen Gutschein eingelöst, wer hat ein Geburtstagsgeschenk ausgelöst und wer ist inaktiv geworden. Dann entscheiden Ihre Systeme, was mit diesen Daten geschehen soll.
Webhooks sind die ausgehende Seite des Integrationsstapels. Sie spiegeln die Kunden- und Prämienaktivitäten in den Systemen wider, denen Sie bereits für Vertrieb, Service, Analyse und Messaging vertrauen.
Jeder Stempel-, Gutschein-, Geburtstags- und Inaktivitätsauslöser landet im Kundendatensatz in Ihrem CRM. Sie sehen die vollständige Treuezeitleiste neben Verkäufen, Anrufen und Tickets, ohne sich bei 7stamp anzumelden.
Wenn ein Kunde einen Gutschein einlöst, senden Sie ein Dankeschön SMS von Ihrem vorhandenen SMS-Gateway. Wenn ein Kunde das Ziel erreicht, posten Sie eine Feier in Slack. Wenn jemand inaktiv wird, leiten Sie den Fall an Ihren Account Manager weiter.
Streamen Sie Ereignisse in Ihr BI Tool, Lager oder Ihre Abstimmungspipeline. Vergleichen Sie Gutscheineinlösungen mit POS-Belegen und berechnen Sie die Treue ROI in Ihren eigenen Kennzahlen.
Ihr Endpunkt sollte HTTPS akzeptieren POST, validieren Sie die Anforderungsform, behalten Sie das Ereignis bei oder stellen Sie es in die Warteschlange und geben Sie dann eine erfolgreiche 2xx-Antwort zurück. Führen Sie vor der Bestätigung keinen langsamen CRM- oder Messaging-Anruf durch, wenn dieser sicher in die Warteschlange gestellt werden kann.
Jedes zugehörige Ereignis kann das External ID und optional External Source tragen, das Sie beim Erstellen oder Scannen der Karte verwendet haben. Verwenden Sie dieses Paar, um Ihren eigenen CRM, POS oder Bestelldatensatz zu aktualisieren, ohne anhand eines Namens oder einer E-Mail-Adresse zu raten.
Speichern Sie einen dauerhaften Verarbeitungsschlüssel oder Ereignis-Fingerabdruck, bevor Nebenwirkungen ausgelöst werden. Wenn Ihr Empfänger dieselbe Lieferung noch einmal sieht, sollte er keine doppelte CRM Notiz, einen Gutschein oder eine Nachricht hinzufügen. Behandeln Sie den Endpunkt URL als Geheimnis.
json {
"event_type": "SCAN",
"scanned_at": "2026-07-23T12:34:56Z",
"user_card_id": 123,
"card_template_id": 42,
"card_template_name": "Coffee Loyalty",
"stamps_added": 1,
"stamps_before": 4,
"stamps_after": 5,
"amount": 24.5,
"external_order_id": "order_2048",
"external_id": "crm_contact_8821",
"external_source": "hubspot"
}Erstellen Sie einen HTTPS-Endpunkt in Ihrem Backend, CRM-Integrationsschicht, Make-Webhook oder Zapier Catch Hook. Make Stellen Sie sicher, dass Sie das Ziel kontrollieren, bevor Sie dessen URL kopieren.
Öffnen Sie in 7stamp Admin Stamp Cards → API & Integrations → Webhooks.
Fügen Sie den Endpunkt URL hinzu und wählen Sie nur die Ereignistypen aus, die der Empfangsworkflow tatsächlich benötigt.
Speichern Sie die Profileinstellungen und lösen Sie dann einen einmaligen Testscan oder eine Kartenaktion aus, um ein Ereignis zu erzeugen.
Überprüfen Sie die empfangene Nutzlast. Ordnen Sie External ID und External Source dem erwarteten Datensatz zu und bestätigen Sie, dass der Empfänger eine erfolgreiche Antwort zurückgibt.
Aktivieren Sie CRM, Gutschein- oder Nachrichten-Nebeneffekte erst, nachdem Sie über eine abspielsichere Handhabung und Überwachung auf Fehler verfügen.
Verwenden Sie in Make Webhooks → Custom webhook, um einen Empfangs-URL zu generieren und ihn in das Profil 7stamp einzufügen. Verwenden Sie in Zapier Webhooks by Zapier → Catch Hook für denselben Zweck. Das 7stamp-Profil besitzt das Abonnement, da das aktuelle API keine automatischen Webhook-Registrierungsendpunkte verfügbar macht.
Verwenden Sie den Webhooks-Abschnitt der öffentlichen OpenAPI-Referenz als Quelle für das aktuelle Nutzlastschema und die Feldbedeutung. Erfordern Sie HTTPS, halten Sie den Empfänger URL von öffentlichen Protokollen fern und machen Sie die Verarbeitung idempotent. Bestätigen Sie beim Onboarding das Anforderungsauthentifizierungsverfahren/signature für Ihr 7stamp-Profil, bevor Sie einen bestimmten Headernamen oder eine Wiederholungsrichtlinie in der Produktion erzwingen.
Ja. Wählen Sie die Ereignistypen in den Webhook-Einstellungen des 7stamp-Profils aus, damit der Empfänger nur die Ereignisse erhält, die für seinen Workflow wichtig sind.
Erstellen Sie den empfangenden Webhook in Make oder einen Catch Hook in Zapier, kopieren Sie den generierten URL, fügen Sie ihn dann in die Webhook-Einstellungen des 7stamp-Profils ein und senden Sie ein Testereignis.
Verwenden Sie External ID und, falls vorhanden, External Source. Dies sind die Kennungen, die Ihre Integration beim Erstellen oder Scannen der Karte bereitgestellt hat.
Nein. Verwenden Sie den aktuellen Liefervertrag OpenAPI/profile und bestätigen Sie das Authentifizierungsverfahren für Ihr Profil beim Onboarding, bevor Sie einen Header oder eine Wiederholungsannahme fest codieren.
Verwandte Seiten
Nächster Schritt
Erstellen Sie einen Empfänger, fügen Sie dessen HTTPS URL in das Profil ein, führen Sie einen Einwegscan durch und validieren Sie den passenden External ID, bevor Sie die nachgelagerte Automatisierung aktivieren.