Yeni CRM kontaktından sonra kart yaradın
CRM kontaktından External ID kimi istifadə edin, 7Stamp kart dəvəti yaradın, sonra adi e-poçt, SMS mesajlaşma addımı və ya geri qaytarılmış quraşdırma URL göndərin.
Kodsuz avtomatlaşdırma bələdçisi
7Stamp ilə Make-a qoşulun — addım-addım
İcra təlimatıCRM, POS, onlayn mağaza, cədvəl, mesajlaşma aləti və ya ssenariyə məlumat göndərə bilən hər hansı sistem ilə 7Stamp-ni qoşmaq üçün Make istifadə edin. Bu gün istehsala hazır marşrut 7Stamp API zənglər üçün Make-in HTTP tətbiqi və gələn 7Stamp hadisələri üçün Make-nin Custom webhook proqramıdır.
Make tətbiq seçicisində hələ ictimai 7Stamp tətbiqi yoxdur. Birini gözləməyin: HTTP → Make a request əlavə edin, dəqiq URL, metodu, Bearer başlıq və JSON istifadə edin, sonra mənbə modulunuzdan sahələri xəritələyin. Bu, gələcək birləşdiricinin istifadə edəcəyi 7Stamp Integration API ilə eynidir.
İş axınınıza uyğun gələn ilk ssenarini seçin
Bir hadisə və bir nəticə ilə başlayın. Test məlumatları düzgün olduqdan sonra filtrlər, marşrutlaşdırıcılar, CRM yeniləmələri və ətrafına təqib mesajları əlavə edin.
Ödənişli sifarişdən sonra möhür əlavə edin
Ödənişli POS və ya e-ticarət sifarişindən ssenarini işə salın. Onun sabit müştərisini ID xəritəsini və ID sifarişini Kartı Skan edin, sonra məbləğ və ya açıq möhür sayından istifadə edin.
Mükafat təqibi göndərin
Kart hadisəsi mükafat və ya vauçer barədə məlumat verdikdə ssenarini şaxələndirin: CRM-i yeniləyin, komandanı xəbərdar edin və yalnız lazım olduqda Wallet kartı push bildirişi və ya e-poçt göndərin.
Doğma Make tətbiqi olmayan sistemi idarə edin
7Stamp API-ni birbaşa çağırmaq üçün Make-in HTTP modulundan istifadə edin. Bu, fərdi POS, ERP, sifariş mühərriki və ya hər hansı API-ilk xidmət üçün universal seçimdir.
7Stamp əməliyyatları Make HTTP-dan zəng etmək üçün
Aşağıdakı hər bir kart üçün HTTP → Make a request əlavə edin, sonra metodu təyin edin və URL tam şəkildə göstərildiyi kimi. Hər sorğu üçün eyni Bearer düyməsini istifadə edin. Tələb olunan xəritələşdirmə sizə CRM, POS və ya e-ticarət tetikleyicinizdən nə təmin edəcəyinizi söyləyir.
Make tetikleyicisi
Webhooks → Custom webhook Bir kart hadisəsi alın
Make-da Custom webhook yaradın, onun URL-ni kopyalayın, sonra həmin URL-u ⟦35826 webhook parametrlərinə yapışdırın. Bu, 7Stamp SCAN, REWARD_EARNED və ya VOUCHER_ISSUED kimi hadisə göndərdiyi zaman ssenariyə başlayır.
- Make
- Webhooks → Custom webhook → Əlavə et; ona aydın bir ad verin və yaradılan URL kopyalayın.
- In 7Stamp
- Admin → API & Integrations → Webhooks; URL-i yapışdırın, yadda saxlayın, sonra test hadisəsi yaradın.
HTTP fəaliyyət yaradın
POST /cards/invite Card Invite
Yeni şəxsi quraşdırma URL yaradır və bir xarici kontakt üçün çatdırılma kodunu daxil edin.
- Tələb olunur
- external_id — ad deyil, stabil CRM/contact ID xəritəsini çəkin.
- Sonra e-poçtunuza gələn cavabdan
- Xəritə install_url, SMS və ya CRM yeniləmə addımından istifadə edin.
HTTP fəaliyyət
POST /cards/invite/bulk Toplu Yaradın Card Invites
Bir sorğuda 100-ə qədər dəvət linki yaradır. Ondan qeyri-məhdud kontakt ixracı üçün deyil, idarə olunan miqrasiya və ya kampaniya üçün istifadə edin.
- Tələb olunan
- elementlər — 1–100 fərdi dəvət sorğusu obyektindən ibarət JSON massivi.
- Hər hansı bir keçid göndərməzdən əvvəl
- success_count, error_count və hər bir nəticəni oxuyun.
HTTP fəaliyyət
GET /cards Find Cards
İsteğe bağlı şablon və mənbə filtrləri ilə External ID tərəfindən kart qeydlərini tapır.
- Tələb olunur
- Sorğu parametri external_id.
- Könüllü
- external_source və template_id bir sistemdə çoxsaylı proqramlar olduqda axtarışı daraldır.
HTTP fəaliyyət
GET /cards/{user_card_id} Kart Detalını əldə edin
Əvvəlki addım daxili User Card ID-ni qaytardıqda bir kartın tam vəziyyətini oxuyur.
- Tələb olunur
- {user_card_id}-ni etibarlı 7Stamp cavabı ilə qaytarılan daxili ID ilə əvəz edin.
- çəkinin
- Fərqli profildən ID kartı təxmin etməyin və ya saxlamayın.
HTTP fəaliyyət
POST /cards/scan Kartı Skan edin
Alış məbləğindən və ya açıq-aşkar saydan möhür əlavə edir. O, User Card ID və ya External ID qəbul edir və xarici sifariş istinadını saxlaya bilər.
- Şəxsiyyət
- external_id və isteğe bağlı external_source istifadə edin; user_card_id hər ikisi verilirsə qazanır.
- Satın alın
- Məbləğə əsaslanan kartlar üçün istifadə məbləği və ya açıq nömrə üçün stamps_count; stamps_count prioritet təşkil edir.
- İzləmə qabiliyyəti
- Xəritə external_order_id ödənişli sifarişdən/receipt beləliklə, 7Stamp hadisələri geri uyğunlaşdırmaq olar.
HTTP fəaliyyət
GET /templates List Templates
API açarı üçün mövcud olan kart şablonlarını sadalayır. Bağlantını yoxlamaq və ya şablonu dinamik olaraq seçmək üçün ondan istifadə edin.
- İlk sınaq
- Bu, ən təhlükəsiz ilk sorğudur: onun bədəni yoxdur və müştəri məlumatlarını dəyişmir.
- Xəritə daha sonra
- Yalnız profildə birdən çox aktiv şablon olduqda aktiv şablonun id-dən template_id kimi istifadə edin.
HTTP fəaliyyət
GET /templates/{template_id}/design Get Template Design
Məlum şablon üçün vizual dizayn parametrlərini qaytarır, başqa sistemin ardıcıl kart seçimini göstərməsi lazım olduqda faydalıdır.
HTTP fəaliyyət
POST /vouchers/issue Vauçer verin
External ID və ya User Card ID tərəfindən müəyyən edilmiş kart sahibinə çek verir.
- Required
- çek tələb olunur.short_description. Kartı external_id və ya məlum user_card_id ilə hədəfləyin.
- Etibarlılıq
- validity_value ilə validity_type istifadə edin və ya müəyyən edilmiş son istifadə tarixi üçün OpenAPI arayışını oxuyun.
HTTP fəaliyyət
POST /messages/send Mesaj Göndər
Konfiqurasiya edilmiş kanal və razılıq qaydalarına uyğun olaraq pul kisəsi-kart təkan və/or e-poçt vasitəsilə kart sahibinə məzmun göndərir.
- Card push
- card_push_text 20 simvolla məhdudlaşır və quraşdırılmış pul kisəsi keçidi tələb olunur.
- E-poçt
- Mövzunu və əsas hissəsini göndərin; əsas HTML bədəndə dəstəklənir.
Make modul
Full 7Stamp endpoint URL HTTP → Make a request
Bu, yuxarıdakı hər ⟦35899 marşrutunu çağıran Make moduludur. Tam URL istifadə edin, sənədləşdirilmiş metodu seçin, Bearer başlığını əlavə edin və JSON yalnız marşrutun gövdəyə ehtiyacı olduqda istifadə edin.
- Baza URL
- https://api.7loc.com/cards-api
- Başlıq
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json POST sorğular üçün.
Üç Make ssenariləri tam olaraq yazıldığı kimi qura bilərsiniz
Aşağıdakı adlar əsl Make modullarıdır. Birinci ssenari ilə başlayın, onu birdəfəlik kontakta qarşı işə salın və yalnız bundan sonra marşrutlaşdırıcılar, filtrlər və ya istehsal planlaması əlavə edin.
1. Yeni CRM əlaqə → 7Stamp kart linkini göndərin
Gözlənilən nəticə: Müştəri 7Stamp-ın qaytardığı install_url-i alır; CRM-iniz həmin URL-i eyni kontakt qeydində saxlaya bilər.
- 1 Ssenari yaradın və CRM-in Yeni/Created Kontakt tetikleyicisini əlavə edin. Kommo üçün kontakt yaratma tetiğini seçin və nümunə kontaktı yükləmək üçün onu bir dəfə işə salın.
- 2 HTTP → Make a request əlavə edin. Metodunu POST və URL ilə https://api.7loc.com/cards-api/cards/invite.
- 3 Authorization əlavə edin: Bearer YOUR_7STAMP_⟧⟦5K Content-Type: application/json. JSON gövdəsində CRM kontaktını ID ilə external_id ilə əlaqələndirin və external_source-ni kommo kimi sabit etiketə təyin edin.
- 4 HTTP modulunu bir dəfə işə salın. Çıxışın install_url, delivery_insert_code, external_id və template_id olduğunu təsdiq edin.
- 5 HTTP modulundan sonra e-poçt/SMS/CRM yeniləmə modulunu əlavə edin və HTTP çıxışındakı install_url-i ona ötürün. Komanda daha sonra onu yenidən göndərməlidirsə, URL-ni CRM kontaktında yadda saxlayın.
Yoxlama: POST /cards/invite həmişə yeni dəvət yaradır. Biznes qaydanız mövcud kontakt üçün başqa dəvətdən qaçmaqdırsa, əvvəlcə Find Cards istifadə edin.
2. Ödənişli sifariş → loyallıq möhürləri əlavə edin
Gözlənilən nəticə: Uğurlu skan cavabına müvəffəqiyyət, scan_id, stamps_added və növbəti addımınız üçün skandan sonrakı kart vəziyyəti daxildir.
- 1 POS/ecommerce Ödənişli Sifariş tetikleyicisindən başlayın. Make nümunəsində sabit müştəri ID və sifariş/receipt ID olduğundan əmin olun.
- 2 POST https://api.7loc.com/cards-api/cards/scan və eyni Bearer başlığı ilə HTTP → Make a request əlavə edin.
- 3 Xəritə external_id müştəridən, external_source sistem adından və external_order_id sifarişdən ID. Məbləğə əsaslanan kartlar üçün məbləğ əlavə edin və ya açıq sayda möhür üçün stamps_count əlavə edin.
- 4 Run once test sifarişi ilə. Ssenari cədvəlini işə salmazdan əvvəl qaytarılmış uğur bayrağını və stamps_added yoxlayın.
- 5 Könüllü olaraq HTTP addımından sonra filtr əlavə edin: yalnız uğur doğru olduqda davam edin, sonra sifarişə/CRM qeydinə scan_id və ya stamps_added yazın.
Yoxlama: Yenidən cəhdlərdə eyni external_order_id istifadə edin ki, sifariş sonrakı webhook tədbirlərində izlənilsin; aydın olmayan uğursuz qaçışdan sonra iki dəfə möhür verməyin.
3. 7Stamp hadisəsi → CRM
Gözlənilən nəticə: Make 7Stamp hadisəsini dərhal qəbul edir və uyğun gələn qeydi ⟦360 vasitəsilə tapa bilər. external_id və external_source.
- 1 Ayrı Make ssenari yaradın. Webhooks → Custom webhook əlavə edin, Əlavə et seçin, onu 7stamp-card-events adlandırın və yaradılan URL-u kopyalayın.
- 2 7Stamp Admin-də API & Integrations → Webhooks bölməsini açın və həmin URL-i əlavə edin. Bütün kart hadisələri ora daxil olur, ona görə də trigger-dən sonra yalnız lazım olan card_event.event_type dəyərlərini saxlayan filtr əlavə edin, məsələn SCAN və REWARD_EARNED.
- 3 7Stamp-də birdəfəlik test skanı və ya kart hadisəsi yaradın. Make-ə qayıdın və Run once-dan istifadə edərək Make-a hadisə data strukturunu təyin edin.
- 4 external_id istifadə edərək CRM axtarış addımı əlavə edin. event_type-a filtr və ya marşrutlaşdırıcı əlavə edin, beləliklə SCAN, REWARD_EARNED və VOUCHER_ISSUED müxtəlif tədbirlər görə bilsin.
- 5 CRM yeniləmə/note əməliyyatını əlavə edin. Xəritə scanned_at, stamps_after, external_order_id və issued_vouchers yalnız seçilmiş hadisə növü üçün həmin sahələr mövcud olduqda.
Yoxlama: Webhook URL-ini məxfi saxlayın. Geri dönməz mesajları, vauçerləri və ya CRM dəyişiklikləri işə salmazdan əvvəl real hadisəni sınayın.
Açmazdan əvvəl 7Stamp API düyməsini əldə edin Make
Bunlar 7Stamp Admin ekranlarıdır. Açarı bir dəfə yaradın, onu Make-nin təhlükəsiz HTTP bağlantısına/keychain-a kopyalayın, sonra onu dərhal mübadilə buferindən çıxarın.
Qurmadan əvvəl əlaqəni hazırlayın
Hər mühit üçün bir API açarı yaradın
7Stamp Admin-də API & Integrations → API Keys → Add API Key ünvanına keçin. Bu seçim mövcud olduqda dəyəri Make-nin HTTP API açar bağlantısında/keychain-da saxlayın. Heç vaxt açarı mətn sahəsindən xəritəyə qoymayın, onu qeydə yerləşdirməyin və ya brauzerlə əlaqəli iş prosesində istifadə etməyin. Açar birinə aiddir 7Stamp iş yerinə/profile.
Stabildən istifadə edin External ID
99-dan dəyişməz ID xəritəsini, 24, POS və ya ticarət platforması—məsələn, CRM əlaqə ID və ya müştəri UUID. Eyni identifikator birdən çox sistemdə görünə bilərsə, hubspot, shopify və ya poster kimi External Source əlavə edin.
Hansı şablonun tətbiq olunacağına qərar verin
Qoşulmuş 7Stamp profilində bir aktiv kart şablonu olduqda, Şablon boş qala bilər. Çoxsaylı şablonlarla template_id xəritəsi və ya seçin ki, hər dəvət və skan nəzərdə tutulan loyallıq proqramına çatsın.
Dəqiq Make HTTP quraşdırma: bir kart dəvəti yaradın
Bunu avtomatlaşdırma addı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 ssenarinizi qurun və sınaqdan keçirin
7Stamp Admin⟧-da⟧1-də⟦3 açarı yaradın. Hesab quraşdırmanız icazə verdikdə ayrıca sınaq profilindən/key istifadə edin.
Make-də ssenari yaradın və mənbə tetikleyicisini əlavə edin. Xəritəçəkmədən əvvəl onu bir dəfə işə salın ki, real nümunə kontaktı və ya ödənişli sifarişi görə biləsiniz.
Növbəti plus üzərinə klikləyin, HTTP axtarın və Make sorğu seçin. Bu səhifədəki əməliyyat kartından metodu, tam URL və başlıqları təyin edin.
İlk sorğu kimi GET https://api.7loc.com/cards-api/templates istifadə edin. Onun uğurlu cavabı müştəri məlumatlarını dəyişmədən açarın işlədiyini sübut edir.
POST marşrutları üçün application/json seçin və bu təlimatdan bədən formasını yapışdırın. Stabil External ID xəritəsi; template_id əlavə edin, yalnız profildə birdən çox aktiv şablon varsa.
Birdəfəlik kontaktla işə salın, HTTP çıxışını yoxlayın və yalnız bundan sonra onun dəqiq cavab sahələrini növbəti CRM, e-poçt və ya mesajlaşma moduluna uyğunlaşdırın.
Make HTTP nə vaxt istifadə etməlisiniz?
İndi 7Stamp üçün HTTP istifadə edin: bu, azaldılmış ehtiyat deyil, sənədləşdirilmiş, istehsala hazır marşrutdur. 7Stamp əməliyyatına, yeni API marşrutuna və ya fərdi POS/ERP əlaqəyə ehtiyacınız olduqda onu seçin. OpenAPI arayışı metod, tam yol, gövdə və cavab sxemi üçün həqiqət mənbəyidir; daşıyıcı açar və baza URL eyni qalır.
Make
Hadisə əsaslı ssenari üçün Webhooks → Custom webhook əlavə edin və webhook yaradın. Onun URL-ini kopyalayın, 7Stamp profilində API & Integrations → Webhooks bölməsini açın, URL-i yapışdırın, yadda saxlayın və real test hadisəsi göndərin. Webhook bütün kart hadisələrini qəbul edir, ona görə də ssenaridə card_event.event_type üzrə filtrləyin. Bu abunəlik 7Stamp profilinə aiddir; cari API webhook-lara avtomatik abunə olma və abunəlikdən çıxma endpoint-lərini təqdim etmir.
İctimai Make birləşdirici tələb olunmur
Bu səhifədəki təlimatlar hər Make hesabında mövcud olan Make modullarından istifadə edir. Əgər siz HTTP deyil, gələcək doğma 7Stamp modulu istəyirsinizsə, bizə lazım olan iş prosesini göndərin; o vaxta qədər HTTP və Custom webhooks hər sənədləşdirilmiş 7Stamp əməliyyatını əhatə edir.
Tez-tez verilən suallar
Make-da 7Stamp tapa bilmirəm. Mən hələ də onu avtomatlaşdıra bilərəmmi?
Bəli. Hazırda Make-də ictimai 7Stamp tətbiqi yoxdur. HTTP > Make a request əlavə edin, 7Stamp endpoint-inin tam URL-ini istifadə edin və Authorization: Bearer, ardınca 7Stamp API açarınızı göndərin. HTTP sənədləşdirilmiş bütün endpoint-ləri çağıra bilər.
Make bağlantısı üçün nişanı haradan əldə edə bilərəm?
7Stamp Admin-də API İnteqrasiyaları açın, sonra API Keys, sonra Add API Key. Açar onu yaradan iş yerinə/profile əhatə olunub, buna görə də mümkün olduqda test ssenariləri üçün test profilindən istifadə edin.
Hansı identifikatoru External ID kimi göstərməliyəm?
Mənbə sistemindəki stabil identifikatordan, tercihen CRM kontakt ID və ya müştəri UUID istifadə edin. Göstərilən addan istifadə etməyin. Telefon nömrəsi və ya e-poçt işləyə bilər, lakin dəyişə bilər və ardıcıl olaraq idarə olunmalıdır.
7Stamp hadisələrini Make-a necə əldə edə bilərəm?
Make-da Webhooks > Custom webhook yaradın, sonra onun yaradılan URL-ni 7Stamp profilinin veb-qanç parametrlərinə yapışdırın. Daxil olan event_type ilə işləmək üçün çatdırıldıqdan sonra Make filtr və ya marşrutlaşdırıcıdan istifadə edin.
Növbəti addım
İlk loyallıq hərəkətini avtomatlaşdırmağa hazırsınız?
API açarını yaradın, List Templates-ni sınayın və birdəfəlik kontaktla bir dəvət və ya skan ssenarisi qurun. Yalnız bu sadə axın etibarlı olduqdan sonra marşrutlaşdırıcılar və mesajlaşma əlavə edin.