Geliştirici entegrasyonu

7stamp Web kancaları

Mevcut

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ıyla yapabilecekleriniz

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.

Sadakat geçmişini CRM hesabınıza yansıtın

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.

Kendi mesajlaşma yığınınızı tetikleyin

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.

Analizleri ve mutabakatı güçlendirin

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.

Kart olayı türleri

SCAN — Bir kart tarama/stamp eylemi aldı.
REWARD_EARNED — Kartta bir ödül kazanıldı.
VOUCHER_ISSUED — Bir kupon düzenlendi.
VOUCHER_REDEEMED — Kupon kullanıldı.
LOTTERY_WIN — Piyango kazançla sonuçlandı.
DELIVERY_INSERT — Bir dağıtım-ekleme akışı kaydedildi.
CARD_JOINED — Bir müşteri bir karta katıldı.
CARD_CAMPAIGN — Bir kart kampanyası etkinliği gerçekleşti.
BIRTHDAY_GREETING — Bir doğum günü kutlama etkinliği gerçekleşti.
ADMIN_VOUCHER_ISSUE — Bir yönetici bir kupon verdi.
CARD_ADDED_TO_WALLET — Bir müşteri, kartı cüzdanına ekledi.
CARD_REMOVED_FROM_WALLET — Bir müşteri, kartı cüzdanından çıkardı.

Güvenli bir web kancası alıcısı oluşturun

Dayanıklı kullanımdan sonra onaylayı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.

External ID

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.

Make teslimat bağımsız

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.

Örnek olay verisi şekli

Bunu otomasyon adımınıza kopyalayın 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"
}

Bir web kancasını yapılandırın ve test edin

01

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.

02

7stamp Admin'de Stamp Cards → API & Integrations → Webhooks'yı açın.

03

URL uç noktasını ekleyin ve yalnızca alıcı iş akışının gerçekten ihtiyaç duyduğu olay türlerini seçin.

04

Profil ayarlarını kaydedin, ardından bir olay oluşturmak için tek kullanımlık bir test taramasını veya kart eylemini tetikleyin.

05

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.

06

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.

Kodsuz seçenekler: Make ve Zapier

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üvenlik ve teslimat sözleşmesi

Mevcut yük şeması ve alan anlamı için kaynak olarak genel OpenAPI referansının Web Kancaları bölümünü kullanın. HTTPS'yi zorunlu tutun, URL alıcısını genel günlüklerin dışında tutun ve işlemeyi bağımsız hale getirin. Üretimde belirli bir başlık adını zorunlu kılmadan veya yeniden deneme politikasını uygulamadan önce, katılım sırasında 7stamp profiliniz için istek kimlik doğrulaması/signature prosedürünü onaylayın.

Sıkça sorulan sorular

Yalnızca belirli webhook etkinliklerini seçebilir miyim?

Evet. Alıcının yalnızca iş akışı için önemli olan olayları alabilmesi için 7stamp profilinin webhook ayarlarından olay türlerini seçin.

Web kancalarını Make veya Zapier'ye nasıl bağlarım?

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.

Bir etkinliği CRM kişimle nasıl eşleştirmeliyim?

External ID ve varsa External Source kullanın. Bunlar, kart oluşturulduğunda veya tarandığında entegrasyonunuzun sağladığı tanımlayıcılardır.

Bir imza başlığı mı varsaymalıyım yoksa zamanlamayı yeniden mi denemeliyim?

Hayır. Geçerli OpenAPI/profile teslimat sözleşmesini kullanın ve bir başlığı sabit olarak kodlamadan veya varsayımı yeniden denemeden önce, katılım sırasında profiliniz için kimlik doğrulama prosedürünü onaylayın.

Sonraki adım

İlk kart etkinliğini göndermeye hazır mısınız?

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.