Geliştirici entegrasyonu
7Stamp'den tüm sadakat olaylarını gerçek zamanlı olarak kendi sistemlerinize aktarın. Oylama yok ve planlanmış API çağrı yok. Olaylar, gerçekleştikten birkaç saniye sonra HTTPS POST istekler olarak gelir.
CRM, ERP veya özel arka ucunuzu sadakat tarafında olup bitenlerle senkronize tutmak için web kancalarını kullanın: kimler katıldı, kimler pul aldı, kim kupon kullandı, kim doğum günü hediyesini tetikledi ve kimler pasif hale geldi. Daha sonra sistemleriniz bu verilerle ne yapılacağına karar verir.
Web kancaları entegrasyon yığınının giden tarafıdır. Müşteri ve ödül faaliyetlerini satış, hizmet, analiz ve mesajlaşma konusunda zaten güvendiğiniz sistemlere yansıtırlar.
Her damga, kupon, doğum günü ve hareketsizlik tetikleyicisi CRM müşteri kaydınıza eklenir. 7Stamp hesabına giriş yapmadan satışların, çağrıların ve biletlerin yanında sadakat zaman çizelgesinin tamamını görebilirsiniz.
Bir müşteri kuponu kullandığında, mevcut SMS ağ geçidinizden bir teşekkür SMS gönderin. Bir müşteri kaleye ulaştığında Slack'de bir kutlama yayınlayın. Birisi pasif hale geldiğinde vakayı hesap yöneticinize yönlendirin.
Olayları BI aracınıza, deponuza veya mutabakat hattınıza aktarın. Kupon kullanımlarını POS makbuzlarla eşleştirin ve bağlılığı ROI kendi ölçümlerinizde hesaplayın.
Uç noktanız HTTPS'yi kabul etmelidir POST, istek şeklini doğrulayın, olayı sürdürün veya sıraya koyun, ardından başarılı bir 2xx yanıtı döndürün. Güvenli bir şekilde sıraya alınabilecekse, onay öncesinde yavaş CRM veya mesajlaşma araması yapmayın.
ile ilişkilendirin Her ilgili olay, kartı oluştururken veya tararken kullandığınız External ID ve isteğe bağlı External Source'yi taşıyabilir. Bir isim veya e-postadan tahmin etmeden kendi CRM, POS veya sipariş kaydınızı güncellemek için bu çifti kullanın.
Yan etkileri tetiklemeden önce dayanıklı bir işleme anahtarı veya olay parmak izini saklayın. Alıcınız aynı teslimatı tekrar görürse kopya CRM notu, kupon veya mesaj eklememelidir. URL uç noktasını gizli olarak değerlendirin.
json {
"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
}
}
}Arka uçta bir HTTPS uç noktası, CRM entegrasyon katmanı, Make web kancası veya Zapier oluşturun Catch Hook. Make URL kopyalamadan önce hedefi kontrol ettiğinizden emin olun.
7Stamp Admin'de Stamp Cards → API & Integrations → Webhooks'yı açın.
Uç nokta URL'sini ekleyin. Webhook, profildeki tüm kart olaylarını alır; bu yüzden alıcınızda data.event_type değerine göre filtreleyin.
Profil ayarlarını kaydedin, ardından bir olay oluşturmak için tek kullanımlık bir test taramasını veya kart eylemini tetikleyin.
Alınan yükü inceleyin. External ID ve External Source'yi beklenen kayıtla eşleştirin ve alıcının başarılı bir yanıt verdiğini doğrulayın.
CRM, kupon veya mesajlaşma yan etkilerini yalnızca tekrar oynatma açısından güvenli işlem ve arıza takibi yaptıktan sonra etkinleştirin.
Make'de, bir alıcı URL oluşturmak için Webhooks → Custom webhook kullanın ve bunu 7Stamp'ye yapıştırın profil. Zapier'de aynı amaç için Webhooks by Zapier → Catch Hook'yi kullanın. 7Stamp profili aboneliğin sahibidir çünkü mevcut API otomatik web kancası kaydı uç noktalarını açığa çıkarmaz.
Güncel yük şeması için kaynak olarak herkese açık OpenAPI referansının Webhooks bölümünü kullanın. Gövde bir zarftır: profile_id ve profile_name 7Stamp profilini belirtir, event_id olayı tanımlar, kart olayının kendisi ise data içindedir (Make veya Zapier URL'si için anahtar card_event'tir). Her teslimat tek bir başlıkta imzalanır, X-Webhook-Signature: t=…,s=…. Webhook gizli anahtarınızla t ve ham istek gövdesinin birleşimi üzerinden HMAC-SHA256 hesaplayın, sonucu hex olarak kodlayın ve s ile karşılaştırın; gizli anahtar 7Stamp Admin'de webhook'un sayfasında yer alır. Tekrarlanan teslimatları atmak için X-Webhook-Event-Id'yi kullanın: yeniden deneme yeni bir t ile tekrar imzalanır. Uç noktayı Basic Auth ile de koruyabilirsiniz. HTTPS'yi zorunlu kılın ve alıcı URL'sini herkese açık kayıtların dışında tutun.
Hayır. Bir 7Stamp webhook'u profildeki tüm kart olaylarını alır. Alıcınızda data.event_type değerine göre filtreleyin; Make ve Zapier'de olay card_event altında gelir, bu yüzden card_event.event_type değerine göre filtreleyin.
Make'de alıcı web kancasını veya Zapier'de bir Catch Hook oluşturun, oluşturulan URL'yi kopyalayın, ardından bunu 7Stamp profilinin web kancası ayarlarına yapıştırın ve bir test etkinliği gönderin.
data.external_id ve varsa data.external_source kullanın: bunlar, API üzerinden kendi ID'nizle çıkardığınız kartlar için her webhook'ta geri gelir. Kartı kendisi alan bir müşterinin External ID'si yoktur, bu yüzden onu data.user.email ile eşleştirin. Apple'ın “Hide My Email” adresi bir aktarma adresidir, CRM'inizdeki adres değildir.
X-Webhook-Signature başlığını t ve s olarak ayırın, 7Stamp Admin'deki webhook gizli anahtarıyla t ve ham istek gövdesinin birleşimi üzerinden HMAC-SHA256 hesaplayın, sonucu hex olarak kodlayın ve s ile karşılaştırın. Gönderildiği haliyle t değerini ve herhangi bir JSON ayrıştırmasından önce alınan ham baytları gövde olarak kullanın. X-Webhook-Event-Id değerini daha önce işlediğiniz bir teslimatı atın: yeniden deneme yeni bir t ile tekrar imzalanır.
İlgili sayfalar
Sonraki adım
Bir alıcı oluşturun, HTTPS URL'sini profile yapıştırın, tek kullanımlık bir tarama çalıştırın ve aşağı akış otomasyonunu etkinleştirmeden önce eşleşen External ID'yi doğrulayın.