Yeni bir CRM kişisinden sonra kart oluşturun
CRM kişi ID'yi External ID olarak kullanın, bir 7stamp kart daveti oluşturun ve geri dönen kurulumu gönderin URL her zamanki e-postanız, SMS veya mesajlaşma adımınız aracılığıyla.
Kodsuz otomasyon kılavuzu
7stamp'yi Make'ye bağlayın — adım adım
Uygulama kılavuzu7stamp'yi CRM, POS, çevrimiçi mağaza, e-tablo, mesajlaşma aracı veya bir senaryoya veri gönderebilecek herhangi bir sistemle bağlamak için Make kullanın. Bugünkü üretime hazır rota, 7stamp API aramaları için Make'nin HTTP uygulaması ve gelen 7stamp etkinlikleri için Make'nin Custom webhook uygulamasıdır.
Make'nin uygulama seçicisinde henüz herkese açık bir 7stamp uygulaması yok. Birini beklemeyin: HTTP → Make a request ekleyin, aşağıdaki URL yöntemini, Bearer başlığını ve JSON'yi kullanın, ardından kaynak modülünüzdeki alanları eşleyin. Bu, gelecekteki bir bağlayıcının kullanacağı 7stamp Integration API ile aynıdır.
İş akışınıza uyan ilk senaryoyu seçin
Bir olay ve bir sonuçla başlayın. Test verileri doğru olduğunda filtreler, yönlendiriciler, CRM güncellemeler ve takip mesajları ekleyin.
Ücretli bir siparişten sonra pul ekleyin
Senaryoyu ücretli bir POS veya e-ticaret siparişinden tetikleyin. Sabit müşterisini ID eşleştirin ve ID'yi Kart Tara'ya sipariş edin, ardından bir miktar veya açık pul sayısı kullanın.
Ödül takibi gönderin
Bir kart olayı bir ödül veya kupon bildirdiğinde senaryoyu dallandırın: CRM'yi güncelleyin, ekibe bildirin ve yalnızca gerektiğinde bir cüzdan kartı gönderimi veya e-posta gönderin.
Yerel Make uygulaması olmayan bir sistemi yönetin
7stamp'yi doğrudan aramak için Make'nin HTTP modülünü kullanın. Bu, özel bir POS, ERP, rezervasyon motoru veya herhangi bir API ilk hizmeti için evrensel seçimdir.
7stamp Make HTTP'den çağrılacak işlemleri açın
Aşağıdaki her kart için HTTP → Make a request ekleyin, ardından yöntemi ve URL'yi tam olarak gösterildiği gibi ayarlayın. Her istek için aynı Bearer tuşunu kullanın. Gerekli eşleme size CRM, POS veya e-ticaret tetikleyicinizden ne sağlamanız gerektiğini söyler.
Make tetikleyici
Webhooks → Custom webhook Bir kart etkinliği alın
Make'de bir Custom webhook oluşturun, URL'yi kopyalayın ve ardından bu URL'yi 7stamp profil webhook ayarlarına yapıştırın. Bu, 7stamp'nin SCAN, REWARD_EARNED veya VOUCHER_ISSUED gibi bir olay gönderdiğinde bir senaryo başlatır.
- Make
- Webhooks → Custom webhook → Ekle; ona net bir ad verin ve oluşturulan URL dosyasını kopyalayın.
- 7stamp
- Yönetici → API & Integrations → Webhooks'de; URL kodunu yapıştırın, etkinlik türlerini seçin, kaydedin ve ardından bir test etkinliği oluşturun.
HTTP eylemi oluşturun
POST /cards/invite Bir Card Invite
Harici bir kişi için yeni bir kişisel kurulum URL ve teslimat ekleme kodu oluşturur.
- Gerekli
- external_id — ahırınızı haritalayın CRM/contact ID, bir isim değil.
- Daha sonra e-postanıza gelen yanıttaki
- Harita install_url, SMS veya CRM güncelleme adımını kullanın.
HTTP eylem
POST /cards/invite/bulk Toplu Oluştur Card Invites
Bir istekte 100'e kadar davet bağlantısı oluşturur. Sınırsız kişi aktarımı için değil, kontrollü bir geçiş veya kampanya için kullanın.
- Gerekli
- öğeler — 1-100 ayrı davet isteği nesnesinden oluşan bir JSON dizisi.
- Kontrol edin
- Herhangi bir bağlantı göndermeden önce success_count, error_count ve her sonucu okuyun.
HTTP eylem
GET /cards Find Cards
İsteğe bağlı şablon ve kaynak filtreleriyle External ID'ye göre kart kayıtlarını bulur.
- Gerekli
- Sorgu parametresi external_id.
- İsteğe bağlı
- external_source ve template_id bir sistemde birden fazla program olduğunda aramayı daraltır.
HTTP eylem
GET /cards/{user_card_id} Kart Detayı Alın
Önceki bir adım dahili User Card ID'yi döndürdüğünde bir kartın tam durumunu okur.
- Gerekli
- {user_card_id}'yi güvenilir bir 7stamp yanıtının döndürdüğü dahili ID ile değiştirin.
- Kaçının
- Farklı bir profilden ID kartı tahmin etmeyin veya saklamayın.
HTTP eylem
POST /cards/scan Kart Tara
Satın alma tutarından veya açık bir sayımdan pullar ekler. User Card ID veya External ID'yi kabul eder ve harici sipariş referansını koruyabilir.
- Kimlik
- external_id ve isteğe bağlı external_source kullanın; user_card_id her ikisi de sağlanırsa kazanır.
- Satın Al
- Tutar bazlı kartlar için tutarı veya açık numara için stamps_count kullanın; stamps_count önceliklidir.
- İzlenebilirlik
- Ücretli siparişten external_order_id haritasını çıkarın/receipt böylece 7stamp olaylar eşleştirilebilir.
HTTP eylem
GET /templates List Templates
API tuşu tarafından kullanılabilen kart şablonlarını listeler. Bağlantıyı test etmek veya dinamik olarak bir şablon seçmek için bunu kullanın.
- İlk test
- Bu en güvenli ilk istektir: gövdesi yoktur ve müşteri verilerini değiştirmez.
- Daha sonra harita
- Yalnızca profilde birden fazla etkin şablon olduğunda etkin şablonun kimliğini template_id olarak kullanın.
HTTP eylem
GET /templates/{template_id}/design Get Template Design
Bilinen bir şablon için görsel tasarım ayarlarını döndürür; başka bir sistemin tutarlı bir kart seçeneği görüntülemesi gerektiğinde kullanışlıdır.
HTTP eylem
POST /vouchers/issue Kupon Düzenleyin
External ID veya User Card ID ile tanımlanan bir kart sahibine kupon düzenler.
- Gerekli
- kupon.short_description. external_id veya bilinen bir user_card_id ile kartı hedefleyin.
- Geçerlilik
- validity_type'yi validity_value ile kullanın veya sabit bir son kullanma tarihi için OpenAPI referansını okuyun.
HTTP eylem
POST /messages/send Mesaj Gönder
Yapılandırılmış kanala ve izin kurallarına tabi olarak, cüzdan kartı gönderimi ve/or e-posta aracılığıyla kart sahibine içerik gönderir.
- Kart itme
- card_push_text 20 karakterle sınırlıdır ve yüklü bir cüzdan geçişi gerektirir.
- E-posta
- Konuyu ve metni gönder; temel HTML vücutta desteklenir.
Make modül
Full 7stamp endpoint URL HTTP → Make a request
Bu, yukarıdaki her 7stamp rotayı çağıran Make modülüdür. Tam bir URL kullanın, belgelenen yöntemi seçin, Bearer başlığını ekleyin ve JSON'yi yalnızca rota bir gövdeye ihtiyaç duyduğunda kullanın.
- Temel URL
- https://api.7loc.com/cards-api
- Başlık
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json, POST istekleri için.
Tam olarak yazıldığı gibi oluşturabileceğiniz üç Make senaryo
Aşağıdaki isimler gerçek Make modülleridir. İlk senaryoyla başlayın, tek kullanımlık bir bağlantıyla çalıştırın ve ancak bundan sonra yönlendiricileri, filtreleri veya üretim planlamasını ekleyin.
1. Yeni CRM iletişim → 7stamp kart bağlantısı gönderin
Beklenen sonuç: Müşteri, 7stamp tarafından gönderilen install_url'yi alır; CRM cihazınız bu URL'yi aynı kişi kaydında tutabilir.
- 1 Bir senaryo oluşturun ve CRM'nizin Yeni/Created İletişim tetikleyicisini ekleyin. Kommo için kişi oluşturma tetikleyicisini seçin ve örnek bir kişiyi yüklemek için bunu bir kez çalıştırın.
- 2 HTTP → Make a request ekleyin. Yöntemi POST ve URL olarak https://api.7loc.com/cards-api/cards/invite.
- 3 olarak ayarlayın. Authorization ekleyin: Bearer YOUR_7STAMP_API_KEY ve Content-Type: application/json. JSON gövdesinde, CRM kişisini ID ile external_id ile eşleştirin ve external_source'yi kommo gibi sabit bir etikete ayarlayın.
- 4 HTTP modülünü bir kez çalıştırın. Çıktının install_url, delivery_insert_code, external_id ve template_id olduğunu doğrulayın.
- 5 HTTP'den sonra e-postanızı/SMS/CRM güncelleme modülünüzü ekleyin ve HTTP çıktısından install_url'yi eşleyin. Ekibin daha sonra yeniden göndermesi gerekiyorsa URL'yi CRM iletişimine kaydedin.
Kontrol edin: POST /cards/invite her zaman yeni bir davet yaratır. İş kuralınız mevcut bir kişi için başka bir davetten kaçınmaksa ilk önce Find Cards kullanın.
2. Ücretli sipariş → bağlılık damgaları ekleyin
Beklenen sonuç: Başarılı bir tarama yanıtı, bir sonraki adımınız için başarıyı, scan_id, stamps_added ve tarama sonrası kart durumunu içerir.
- 1 POS/ecommerce Ücretli Sipariş tetikleyicisinden başlayın. Make numunesinin istikrarlı bir müşteri ID ve sipariş/receipt ID içerdiğinden emin olun.
- 2 POST https://api.7loc.com/cards-api/cards/scan ve aynı Bearer başlığıyla HTTP → Make a request ekleyin.
- 3 Harita external_id müşteriden, external_source sistem adından ve external_order_id siparişten ID. Tutara dayalı kartlar için tutar ekleyin veya açık sayıda pul için stamps_count ekleyin.
- 4 Run once deneme siparişi ile. Senaryo zamanlamasını etkinleştirmeden önce döndürülen başarı bayrağını ve stamps_added'yi kontrol edin.
- 5 İsteğe bağlı olarak HTTP adımından sonra bir filtre ekleyin: yalnızca başarı doğru olduğunda devam edin, ardından sipariş/CRM kaydına geri scan_id veya stamps_added yazın.
Kontrol edin: Aynı external_order_id'yi yeniden denemelerde kullanın, böylece sıra daha sonraki webhook olaylarında takip edilebilir; Belirsiz ve başarısız bir çalışmanın ardından pulları iki kez ödüllendirmeyin.
3. 7stamp olayı → CRM
Beklenen sonuç: Make'yi güncelleyin, 7stamp olayını hemen alır ve eşleşen CRM kaydını external_id aracılığıyla bulabilir ve external_source.
- 1 Ayrı bir Make senaryosu oluşturun. Webhooks → Custom webhook ekleyin, Ekle'yi seçin, 7stamp-card-events olarak adlandırın ve oluşturulan URL'yi kopyalayın.
- 2 7stamp Admin'da API & Integrations → Webhooks'yi açın. Bunu URL ekleyin ve küçük bir etkinlik kümesi seçin, örneğin SCAN ve REWARD_EARNED.
- 3 7stamp'de tek kullanımlık bir test taraması veya kart olayı oluşturun. Make'ye dönün ve Run once'yi kullanarak Make'nin olay veri yapısını belirlemesine izin verin.
- 4 external_id kullanarak bir CRM arama adımı ekleyin. event_type'ye bir filtre veya yönlendirici ekleyerek SCAN, REWARD_EARNED ve VOUCHER_ISSUED'nin farklı eylemler gerçekleştirebilmesini sağlayın.
- 5 CRM güncelleme/note eylemini ekleyin. scanned_at, stamps_after, external_order_id ve issued_vouchers'yi yalnızca seçilen etkinlik türü için bu alanlar mevcut olduğunda eşleyin.
Kontrol edin: Webhook'u URL gizli tutun. Geri dönüşü olmayan mesajları, kuponları veya CRM değişiklikleri etkinleştirmeden önce gerçek bir olayı test edin.
Make
These are the exact 7stamp Admin screens. Create the key once, copy it into Make's secure HTTP connection/keychain, then immediately remove it from your clipboard.
Bağlantıyı oluşturmadan önce hazırlayın
Ortam başına bir API anahtarı oluşturun
7stamp Admin'de API & Integrations → API Keys → Add API Key'ye gidin. Bu seçenek mevcut olduğunda değeri Make'nin HTTP API-anahtar bağlantısı/keychain'de saklayın. Anahtarı hiçbir zaman bir metin alanına eşlemeyin, bir notun içine yerleştirmeyin veya tarayıcıya yönelik bir iş akışında kullanmayın. Anahtar bir 7stamp işyerine/profile.
External ID
CRM, POS cihazınızdaki değişmez ID'yi eşleyin veya ticaret platformu — örneğin bir CRM kişi ID veya müşteri UUID. Aynı tanımlayıcının birden fazla sistemde görünebileceği durumlarda hubspot, shopify veya poster gibi External Source ekleyin.
Hangi şablonun geçerli olduğuna karar verin
Bağlı 7stamp profilinde bir aktif kart şablonu olduğunda, Şablon boş bırakılabilir. Birden fazla şablonla, her davetin ve taramanın amaçlanan sadakat programına ulaşması için template_id'yi bilinçli olarak eşleştirin veya seçin.
Tam Make HTTP kurulum: bir kart daveti oluşturun
Bunu otomasyon adımınıza kopyalayın
http Method: POST
URL: https://api.7loc.com/cards-api/cards/invite
Headers:
Authorization: Bearer YOUR_7STAMP_API_KEY
Content-Type: application/json
Body type: Raw / JSON
{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"template_id": 42
}İlk Make senaryonuzu oluşturun ve test edin
7stamp Admin'de, API & Integrations → API Keys → Add API Key'de bir anahtar oluşturun. Hesap kurulumunuz izin verdiğinde ayrı bir test profili/key kullanın.
Make'de bir senaryo oluşturun ve kaynak tetikleyiciyi ekleyin. Gerçek bir örnek iletişim kişisini veya ücretli siparişi görebilmeniz için haritalamadan önce bunu bir kez çalıştırın.
Sonraki artıya tıklayın, HTTP'yı arayın ve Make bir istek seçin. Bu sayfadaki işlem kartından yöntemi, tam URL ve başlıkları ayarlayın.
İlk istek olarak GET https://api.7loc.com/cards-api/templates kullanın. Başarılı yanıtı, anahtarların hiçbir müşteri verisini değiştirmeden çalıştığını kanıtlıyor.
POST rotaları için application/json'yi seçin ve bu kılavuzdan vücut şeklini yapıştırın. Bir ahırı eşleyin External ID; yalnızca profilde birden fazla etkin şablon varsa template_id ekleyin.
Tek kullanımlık bir kişiyle çalıştırın, HTTP çıkışını inceleyin ve ancak bundan sonra tam yanıt alanlarını bir sonraki CRM, e-posta veya mesajlaşma modülüyle eşleştirin.
Make HTTP'yi ne zaman kullanmalısınız?
Şimdi 7stamp için HTTP kullanın: bu, azaltılmış bir geri dönüş değil, belgelenmiş, üretime hazır rotadır. Bir 7stamp işlemine, yeni bir API rotasına veya özel bir POS/ERP bağlantısına ihtiyaç duyduğunuzda bunu seçin. OpenAPI referansı yöntem, tam yol, gövde ve yanıt şemasına ilişkin doğruluğun kaynağıdır; taşıyıcı anahtar ve taban URL aynı kalır.
Make
For an event-driven scenario, add Webhooks → Custom webhook and create a webhook. Copy its URL, open API & Integrations → Webhooks in the 7stamp profile, paste the URL, select the event types, save, and send a real test event. The 7stamp profile owns that subscription; the current API does not expose automatic webhook subscribe/unsubscribe endpoints.
Genel Make bağlayıcı gerekmez
Bu sayfadaki talimatlar, her Make hesabında kullanılabilen Make modülleri kullanır. HTTP yerine gelecekte yerel bir 7stamp modülü istiyorsanız, ihtiyacınız olan iş akışını bize gönderin; o zamana kadar HTTP ve Custom webhook'ler belgelenen her 7stamp işlemini kapsar.
Sıkça sorulan sorular
Make'da 7stamp'yi bulamıyorum. Yine de otomatikleştirebilir miyim?
Evet. Bugün Make'de herkese açık 7stamp uygulaması yok. HTTP > Make bir istek ekleyin, 7stamp bitiş noktası URL'nin tamamını kullanın ve Authorization: Bearer ve ardından 7stamp API anahtarınızı gönderin. HTTP belgelenen her uç noktayı arayabilir.
Make bağlantısı için jetonu nereden alabilirim?
7stamp Admin'de API Entegrasyonlar'ı, ardından API Keys'yi ve ardından Add API Key'yi açın. Anahtarın kapsamı onu oluşturan işyeri/profile kapsamındadır; bu nedenle mümkün olduğunda test senaryoları için bir test profili kullanın.
Hangi tanımlayıcıyı External ID olarak eşlemeliyim?
Kaynak sistemdeki kararlı tanımlayıcıyı, tercihen CRM iletişim kişisi ID veya müşteri UUID'yi kullanın. Görünen ad kullanmayın. Bir telefon numarası veya e-posta işe yarayabilir, ancak değişebilir ve tutarlı bir şekilde ele alınmalıdır.
7stamp olaylarını Make'ye nasıl aktarabilirim?
Make'de bir Web Kancaları > Custom webhook oluşturun, ardından oluşturulan URL'yi 7stamp profilinin web kancası ayarlarına yapıştırın. Gelen event_type'yi işlemek için teslimattan sonra bir Make filtresi veya yönlendirici kullanın.
Sonraki adım
İlk sadakat eylemini otomatikleştirmeye hazır mısınız?
API anahtarını oluşturun, List Templates'yi test edin ve tek kullanımlık bir kişiyle bir davet veya tarama senaryosu oluşturun. Yönlendiricileri ve mesajları ancak bu basit akış güvenilir hale geldikten sonra ekleyin.