CRM kişisinden bir davet oluşturun
Yeni veya nitelikli bir kişiyi tetikleyin, CRM ID ile External ID arasında eşleyin, bir kart daveti oluşturun ve döndürülen yüklemeyi URL bir kişiye iletin e-posta veya SMS adımı.
Kodsuz otomasyon kılavuzu
7stamp'yi Zapier'ye bağlayın — adım adım
Uygulama kılavuzuİş akışınız açık bir sıraysa: bir iletişim veya sipariş olduğunda Zapier kullanın görünür, 7stamp bir eylem gerçekleştirir, ardından başka bir iş aracı güncellenir. Bugünkü güvenli rota, giden 7stamp API çağrılar için API ile Zapier ve gelen 7stamp etkinlikleri için Webhooks by Zapier → Catch Hook'dir.
Zapier'nin pazarında herkese açık 7stamp uygulaması yoktur. Mümkün olduğunda API by Zapier → API Request kullanın: Statik bir API anahtarını Zap adımında göstermek yerine uygulama bağlantısında saklar. Webhooks by Zapier'yi yalnızca gelen Catch Hook etkinlikleri için kullanın; görünür bir Web Kancaları eylem alanına 7stamp Bearer anahtarını koymayın.
Doğrusal, test edilebilir bir Zap ile başlayın
İlk Zap'i küçük tutun. Güvenilir bir temastan karta veya ücretli siparişten pula akışı, geniş iki yönlü CRM senkronizasyonundan daha iyi bir başlangıç noktasıdır.
Ödeme sonrasında pul ekleyin
Ücretli sipariş veya kapalı makbuzdan tetikleyin, müşteri kimliğini ve siparişi ID eşleştirin, ardından sipariş tutarı veya açık pul sayısıyla birlikte Scan Card kullanın.
Bir defaya mahsus kurtarma kuponu düzenleyin
Bir müşteriyi tanımlamak, kartına kupon düzenlemek ve doğru kanaldan bir takip mesajı göndermek için CRM kuralını, destek etkinliğini veya segment dışa aktarımını kullanın.
Kart etkinliklerini CRM
kartınıza geri yazın. 7stamp kart etkinliklerini almak için Webhooks by Zapier > Catch Hook kullanın. Döndürülen External ID'yi CRM kaydıyla eşleştirin ve ilgili notu, etiketi veya görevi ekleyin.
7stamp API'den çağrılacak işlemleri Zapier
ile açın API by Zapier → API Request tetikleyicinizden sonra. Bir 7stamp API-anahtar bağlantısı oluşturun, ardından tam yöntemi seçin ve aşağıdan tam URL'yi seçin. Her işlem bir sonraki Zap adımına eşleyebileceğiniz alanları döndürür.
API oluşturun
POST /cards/invite Create Card Invite
Harici bir kişi için yeni bir cüzdan kartı kurulumu URL ve teslimat ekleme kodu oluşturur.
- Required
- external_id gereklidir.
- Sonraki adım
- install_url'yi e-posta, SMS veya CRM alanına eşleyin.
API Zapier eylemiyle
POST /cards/invite/bulk Toplu Oluştur Card Invites
Kontrollü bir JSON gruptan en fazla 100 davet bağlantısı oluşturur.
- 1-100 davet nesnesi içeren
- öğe dizisi gereklidir.
- Kontrol edin
- Teslimattan önce success_count, error_count ve tüm sonuçları okuyun.
API Zapier eylemine göre
POST /cards/scan Scan Card
User Card ID veya External ID ile pulları tutar, pul sayısı, sipariş ile ekler ID ve isteğe bağlı fatura verileri.
- Kimlik
- external_id artı isteğe bağlı external_source; user_card_id her ikisi de mevcutsa kazanır.
- Damga kuralı
- stamps_count tutardan önceliklidir.
API Zapier eylemiyle
POST /vouchers/issue Issue Voucher
Doğrudan kart sahibine bir kupon düzenler.
- Gerekli
- kupon.short_description ve bir hedef external_id veya bilinen user_card_id.
- Sonuç
- unique_code, durum veya expires_at'yi bir CRM notu veya mesajıyla eşleştirin.
API Zapier eylemiyle
POST /messages/send Send Message
Kart sahibine cüzdan kartı gönderme ve/or e-posta içeriğini gönderir.
- Kart itme
- card_push_text 20 karakter ile sınırlıdır.
- E-posta
- konu artı gövde; sonuç, teslimatın kuyruğa alınıp alınmadığını bildirir.
API Zapier eylem
GET /cards Find Cards
İsteğe bağlı kaynak ve şablon filtreleriyle External ID'ye göre kart kayıtlarını bulur.
- Sorgu parametresi olarak
- external_id gereklidir.
- İlk önce kullanın
- Kuralınız yinelenen davetlerden kaçınıyorsa, davet oluşturmadan önce kullanın.
API Zapier eylemiyle
GET /cards/{user_card_id} Kart Detayını Al
Bir kartın durumunu 7stamp dahili ID ile okur.
- Gerekli
- {user_card_id}'yı, 7stamp tarafından döndürülen ID ile değiştirin.
- Faydalı çıktı
- stamps_count, cüzdan durumu ve active_vouchers_count.
API Zapier eylemiyle
GET /templates List Templates
Bağlı profil için mevcut şablonları listeler ve API bağlantısını doğrular.
- İlk test
- Herhangi bir yazma işleminden önce çağırın: hiçbir müşteri verisini değiştirmez.
- Daha sonra kullan
- Birden fazla şablon mevcut olduğunda aktif kimlik template_id olur.
API Zapier eylemiyle
GET /templates/{template_id}/design Get Template Design
Bilinen bir şablon ID için şablonun tasarım ayarlarını alır.
Zapier tetikleyici
Webhooks by Zapier → Catch Hook Kart olaylarını al
Catch Hook Zapier'ye benzersiz bir HTTPS URL verir. Bunu 7stamp Admin'nin webhook ayarlarına yapıştırın ve gerçek bir kart etkinliğiyle test edin.
- Zapier
- içinde Ayrıştırılmış olay verileri için Catch Hook kullanın; Catch Raw Hook'yi yalnızca ham istek başlıklarına da ihtiyacınız olduğunda kullanın/body.
- Match
- Etkinlikten external_id ve isteğe bağlı external_source kullanarak CRM kişisini bulun.
Adım adım oluşturabileceğiniz üç Zapier iş akışı
Her senaryoda gerçek, şu anda mevcut olan bir Zapier modülü kullanılır. Önce küçük bir rota oluşturun ve Zap'i açmadan önce bunu tek kullanımlık bir kontakla test edin.
1. Nitelikli CRM iletişim → kart verin
Beklenen sonuç: Bir sonraki Zap adımı install_url'yi alır ve bunu müşteriye gönderebilir veya CRM kaydına geri yazabilir.
- 1 Bir Zap oluşturun ve bir kişinin sadakat için uygun olduğu anlamına gelen CRM etkinliğini seçin. Tetikleyiciyi test edin ve kişinin değişmez ID özelliğine sahip olduğunuzu doğrulayın.
- 2 API by Zapier → API Request ekleyin. 7stamp API anahtar bağlantısını oluşturun veya seçin, POST'yi seçin ve URL'yi https://api.7loc.com/cards-api/cards/invite. olarak ayarlayın
- 3 Gövdeyi JSON olarak ayarlayın. CRM ID'yi external_id ile eşleyin, kommo gibi sabit bir external_source ayarlayın ve template_id'yi yalnızca birden fazla 7stamp şablonu etkin olduğunda ekleyin.
- 4 Eylemi test edin. Yanıtın aynı external_id için install_url ve delivery_insert_code içerdiğini doğrulayın.
- 5 CRM Güncelleme, e-posta veya SMS eyleminizi ekleyin. API yanıtından install_url haritası; Bir testi sabit kodla yazmayın veya kopyalamayın URL.
Kontrol edin: Card Invite oluştur her zaman yeni bir davet döndürür. Politikanız kişi başına bir davet ise, önce bir Find Cards isteği veya Zapier filtresi ekleyin.
2. Ücretli sipariş → ödül pulları
Beklenen sonuç: Sipariş izlenebilir bir 7stamp taraması oluşturur ve Zap, kaynak sistemde stamps_added veya scan_id kaydedebilir.
- 1 Ücretli Sipariş Kullanın/Closed Tetikleyiciyi alın ve test edin. Devam etmeden önce hem müşterinin ID hem de benzersiz siparişin ID mevcut olduğunu onaylayın.
- 2 POST https://api.7loc.com/cards-api/cards/scan ile API by Zapier → API Request ekleyin ve aynı 7stamp bağlantısını seçin.
- 3 JSON'yi external_id, external_source, external_order_id ve tutara dayalı şablonlar için tutar veya açık bir pul ödülü için stamps_count ile gönderin.
- 4 Tek kullanımlık bir siparişle test edin. Yanıttaki başarıyı, scan_id ve stamps_added'yi inceleyin.
- 5 Yalnızca başarılı bir yanıttan sonra devam eden bir Filtre ekleyin, ardından/CRM sırasını onaylanmış sonuçla güncelleyin.
Kontrol edin: Zap yeniden oynatılırsa, başka bir tarama göndermeden önce orijinal sırayı kontrol edin. Etkinliğin daha sonra uzlaştırılabilmesi için external_order_id'yi sabit tutun.
3. 7stamp olayı → bir CRM notu veya görevi oluşturun
Beklenen sonuç: Zapier ayrıştırılmış bir 7stamp olayı alır, external_id ile müşteriyi bulur ve uygun takibi oluşturur.
- 1 Tetikleyici olarak Webhooks by Zapier ile yeni bir Zap oluşturun. Catch Hook öğesini seçin, devam edin ve Test adımında gösterilen benzersiz URL öğesini kopyalayın.
- 2 7stamp Admin'de API & Integrations → Webhooks'yi açın, Catch Hook URL'yi ekleyin, yalnızca gerekli etkinlik türlerini seçin ve kaydedin.
- 3 Gerçek bir test taramasına veya kart olayına neden olun. Zapier'ye geri döndüğünüzde, Test trigger'ye tıklayın ve event_type, external_id ve external_source'nin örnek alanlar olarak geldiğini onaylayın.
- 4 external_id kullanarak bir CRM Kişi Bul işlemi ekleyin. event_type için bir Filtre veya Yol kuralı ekleyin; örneğin SCAN'yi REWARD_EARNED'den ayırın.
- 5 Bir CRM notu/task oluşturun ve scanned_at, stamps_after, external_order_id veya issued_vouchers gibi yalnızca söz konusu etkinlik için mevcut olan alanları eşleyin.
Kontrol edin: Bir Catch Hook URL bir sırdır. Zap başka bir sahibe aktarılırsa, ona güvenmeden önce 7stamp Admin içindeki URL'yi güncelleyin.
Zap'i oluşturmadan önce 7stamp API anahtarını oluşturun
Bunlar 7stamp yan adımlarıdır. Bunu bir kez yapın, ardından anahtarı Webhooks by Zapier eylem alanında veya bir notta değil, yalnızca API ile Zapier bağlantısının içinde kullanın.
Veri uyumsuzluklarını önleyen bağlantı kuralları
API anahtarını API ile Zapier bağlantısında tutun
7stamp Admin'de, API & Integrations → API Keys → Add API Key'yi seçin. API ile Zapier arasında, Bearer ve ardından bu anahtarı içeren statik bir Authorization başlığıyla bir API anahtar bağlantısı oluşturun. API Zapier tarafından, görünür bir Zap adımı yerine bağlantıdaki kimlik bilgilerini tutar; Bağlantıya erişimi kısıtlayın ve açıktaysa anahtarı döndürün.
Harita External ID ve External Source tutarlı bir şekilde
External ID kendi sabit müşteri tanımlayıcınızdır; External Source geldiği yerin etiketleri; örneğin hubspot, bitrix24, shopify veya poster. Oluşturma, bulma, tarama, kupon ve web kancası akışları için aynı çifti kullanın.
Hangi kart tanımlayıcının kazandığını öğrenin
Kart hedefleme eylemleri User Card ID veya External ID'yi kabul eder. Her ikisi de mevcut olduğunda User Card ID öncelik kazanır. Dahili ID öğesini yalnızca güvenilir bir 7stamp adımı tarafından döndürüldükten sonra kullanın; aksi halde External ID kaynak sistemini tercih edin.
Tam API Zapier isteğiyle: bir pul verin
Bunu otomasyon adımınıza kopyalayın
http Method: POST
URL: https://api.7loc.com/cards-api/cards/scan
Headers:
Authorization: Bearer YOUR_7STAMP_API_KEY
Content-Type: application/json
Data:
{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"stamps_count": 1,
"external_order_id": "order_2048"
}İlk Zap'inizi oluşturun
Yönetici'de bir 7stamp API anahtarı oluşturun: API & Integrations → API Keys → Add API Key. Mümkün olduğunda ayrı bir test anahtarı/profile kullanın.
Zapier'de bir Zap oluşturun ve kaynak tetikleyiciyi test edin. Kişi ID, müşteri ID, sipariş ID ve tutarın eşleme için hazır olması için gerçek bir örnek kullanın.
API by Zapier → API Request ekleyin. Sırrı Webhooks by Zapier eylem alanına koymak yerine statik Bearer Authorization başlığı için bir 7stamp bağlantısı oluşturun.
Önce GET https://api.7loc.com/cards-api/templates'yi arayın. Bu, anahtarın çalıştığını doğrular ve müşteri verilerini değiştirmeden hangi etkin şablon kimliklerinin mevcut olduğunu gösterir.
POST /cards/invite veya POST /cards/scan öğesini seçin, gövde türü olarak JSON ayarlayın ve kararlı External ID artı ilgili şablon/order alanlarını eşleyin. tetikleyin.
Eylemi tek kullanımlık bir kişiyle çalıştırın, tam yanıt alanlarını inceleyin, ardından Zap'i yayınlamadan önce bu alanları bir sonraki CRM, e-posta veya mesajlaşma adımıyla eşleştirin.
Evrensel isteği yalnızca belgelenen rotalar için kullanın
Bearer API anahtarıyla 7stamp isteği için Zapier tarafından API kullanın: statik başlık anahtarlarını bir uygulama bağlantısında tutar. Catch Hook olay teslimi için Webhooks by Zapier kullanın, 7stamp sırrı için tercih edilen konum olarak değil. URL tabanını https://api.7loc.com/cards-api,'de tutun, tam şemalar için genel OpenAPI referansını kullanın ve kimlik bilgilerini veya müşteri verilerini asla doğrulanmamış bir URL'ye göndermeyin.
Catch Hook aracılığıyla 7stamp etkinliklerini alın
Webhooks by Zapier → Catch Hook oluşturun, test kurulumunda gösterilen benzersiz URL'yi kopyalayın, 7stamp profilinin webhook ayarlarına yapıştırın, etkinlik türlerini seçin, ve ardından gerçek bir test taraması veya kart olayı gönderin. Doğru CRM kişiyi bulmak için olay yükünün External ID ve External Source'sini kullanın. Catch Raw Hook seçeneğini yalnızca özellikle ayrıştırılmamış gövdeye ve istek başlıklarına ihtiyaç duyduğunuzda seçin.
Güvenli Zapier rotasını şimdi kullanın
API Zapier ve Catch Hook her genel 7stamp API işlemi ve kart olayı için yeterlidir. Gelecekte yerel bir 7stamp Zapier uygulamasına ihtiyacınız varsa, ekibinizin en çok kullandığı eylemi/trigger bize tam olarak gönderin.
Sıkça sorulan sorular
Zapier'da 7stamp uygulamasını nerede bulabilirim?
Bugün halka açık 7stamp pazaryeri uygulaması yok. 7stamp API aramaları için API by Zapier → API Request'yi ve gelen 7stamp etkinlikleri için Webhooks by Zapier → Catch Hook'yi kullanın.
Zapier jetonunu nerede oluşturabilirim?
Yönetici'de API & Integrations → API Keys → Add API Key altında bir 7stamp API anahtarı oluşturun. Görünür bir Webhooks by Zapier eylem alanında değil, API by Zapier bağlantısında statik bir Bearer Authorization başlığı olarak saklayın.
Zapier pul veya kupon etkinliğini nasıl alabilirim?
Webhooks by Zapier'de bir Catch Hook oluşturun, oluşturulan URL'yi 7stamp profilinin web kancası ayarlarına yapıştırın, etkinlikleri seçin ve CRM güncellemelerini etkinleştirmeden önce bir test etkinliği gönderin.
Zapier'yi mi yoksa Make'yi mi seçmeliyim?
Çoğunlukla doğrusal bir tetikleyici eylem iş akışı için Zapier seçeneğini seçin. Yönlendiricilere, karmaşık dönüşümlere veya uzun çok dallı senaryolara ihtiyaç duyduğunuzda Make seçeneğini seçin. Her ikisi de aynı 7stamp API anahtarını ve uç noktalarını kullanır.
Sonraki adım
Bir test kişisiyle ilk Zap'i oluşturun
API anahtarını oluşturun, test edin GET /templates ile API arasında Zapier ile, ardından bir karttan karta veya siparişten pula eylemi oluşturun. Giden akışın kanıtlanmış bir test sonucu olduğunda Catch Hook'yi ekleyin.