კოდის გარეშე ავტომატიზაციის გზამკვლევი

დაკავშირება 7stamp Zapier-თან — ეტაპობრივად

განხორციელების სახელმძღვანელო

გამოიყენეთ Zapier, როდესაც თქვენი სამუშაო ნაკადი მკაფიო თანმიმდევრობაა: კონტაქტი ან შეკვეთა ჩნდება ქმედება ანX. განახლებულია. უსაფრთხო მარშრუტი დღეს არის API by Zapier გამავალი 7stamp API ზარებისთვის და Webhooks by Zapier → Catch Hook შემომავალი 7stamp მოვლენებისთვის.

არ არის საჯარო 7stamp აპლიკაცია Zapier ბაზარზე. გამოიყენეთ API by Zapier → API Request, სადაც ეს შესაძლებელია: ის ინახავს სტატიკურ API გასაღებს აპის კავშირში, ნაცვლად იმისა, რომ გამოაშკარავდეს მას Zap ნაბიჯით. გამოიყენეთ Webhooks by Zapier მხოლოდ შემომავალი Catch Hook მოვლენებისთვის; არ ჩადოთ 7stamp Bearer გასაღები Webhooks-ის ხილულ ველში.

ღია Zapier API მოვლენები

დაიწყეთ წრფივი, შესამოწმებელი Zap-ით

შეინახეთ პირველი Zap პატარა. სანდო კონტაქტი-ბარათამდე ან ფასიანი შეკვეთა-შტამპების ნაკადი უკეთესი ამოსავალი წერტილია, ვიდრე ფართო ორმხრივი CRM სინქრონიზაცია.

შექმენით მოწვევა CRM კონტაქტისგან

ტრიგერით ახალ ან კვალიფიციურ კონტაქტზე, შეადგინეთ მისი CRM ID External ID, შექმენით ბარათის მოწვევა და გადაიტანეთ დაბრუნებული ინსტალაციის ნაბიჯი URL ელფოსტაზე ან TMXST.

დაამატეთ მარკები შეკვეთის შემდეგ

გამორთეთ ფასიანი შეკვეთიდან ან დახურული ქვითრით, შეადგინეთ მომხმარებლის იდენტურობა და შეუკვეთეთ ID, შემდეგ გამოიყენეთ Scan Card შეკვეთის თანხით ან მარკების აშკარა რაოდენობით.

გასცეს ერთჯერადი აღდგენის ვაუჩერი

გამოიყენეთ CRM წესი, მხარდაჭერის ღონისძიება ან სეგმენტის ექსპორტი კლიენტის იდენტიფიცირებისთვის, მის ბარათზე ვაუჩერის გასაცემად და სწორი არხიდან შემდგომი შეტყობინების გაგზავნისთვის.

ჩაწერეთ ბარათის მოვლენები თქვენს CRM

გამოიყენეთ Webhooks by Zapier > Catch Hook 7stamp ბარათის მოვლენების მისაღებად. შეადარეთ დაბრუნებული External ID CRM ჩანაწერს და დაამატეთ შესაბამისი შენიშვნა, ტეგი ან დავალება.

7stamp ოპერაციების დასარეკად API-დან Zapier

-ით დაამატეთ API by Zapier → API Request თქვენი ჩამშვების შემდეგ. შექმენით ერთი 7stamp API გასაღების კავშირი, შემდეგ აირჩიეთ ზუსტი მეთოდი და სრული URL ქვემოთ. თითოეული ოპერაცია აბრუნებს ველებს, რომლებიც შეგიძლიათ შეადგინოთ Zap-ის შემდეგ ეტაპზე.

API Zapier ქმედება POST /cards/invite

შექმნა Card Invite

ქმნის ახალი საფულე-ბარათის ინსტალაციას URL და მიწოდების-ჩასვით კოდი ერთი გარე კონტაქტისთვის.

საჭიროა: external_id CRM/contact ტრიგერიდან.
შემდეგი ნაბიჯი: რუკა install_url ელფოსტაზე, SMS ან CRM ველში.

API მიერ Zapier ქმედება POST /cards/invite/bulk

ერთობლივი შექმნა Card Invites

ქმნის 100-მდე მოწვევის ბმულს კონტროლირებადი JSON ჯგუფიდან.

საჭირო: ერთეულების მასივი 1–100 მოწვევის ობიექტით.
შეამოწმეთ: წაიკითხეთ success_count, error_count და ყველა შედეგი მიწოდებამდე.

API Zapier ქმედებით POST /cards/scan

Scan Card

ამატებს მარკებს User Card ID ან External ID ოდენობით, შტამპების რაოდენობით, შეკვეთით TMXCONST4Xcept და მონაცემებით.

იდენტიფიკაცია: external_id პლუს სურვილისამებრ external_source; user_card_id იმარჯვებს, თუ ორივე ესწრება.
მარკის წესი: stamps_count უპირატესობას ანიჭებს თანხას.

API by Zapier ქმედება POST /vouchers/issue

Issue Voucher

გასცემს ვაუჩერს პირდაპირ ბარათის მფლობელს.

საჭიროა: ვაუჩერი.short_description და სამიზნე external_id ან ცნობილი user_card_id.
შედეგი: რუკა unique_code, სტატუსი ან expires_at CRM შენიშვნაზე ან შეტყობინებაზე.

API მიერ Zapier ქმედება POST /messages/send

Send Message

აგზავნის საფულის ბარათის დაჭერას და /or ელფოსტის შინაარსს ბარათის მფლობელს.

ბარათის დაჭერა: card_push_text შეზღუდულია 20 სიმბოლოთი.
ელფოსტა: თემა პლუს ტექსტი; შედეგი იტყობინება, იყო თუ არა მიწოდება რიგში.

API Zapier ქმედება GET /cards

Find Cards

პოულობს ბარათის ჩანაწერებს External ID-ით, არჩევითი წყაროსა და შაბლონის ფილტრებით.

მოთხოვნის პარამეტრად საჭიროა: external_id.
გამოიყენეთ პირველი: გამოიყენეთ მოწვევის შექმნამდე, როდესაც თქვენი წესი თავიდან აიცილებს დუბლიკატ მოწვევებს.

API by Zapier ქმედება GET /cards/{user_card_id}

ბარათის დეტალების მიღება

კითხულობს ბარათის მდგომარეობას მისი 7stamp შიდა ID-ით.

საჭირო: შეცვალეთ {user_card_id} ID დაბრუნებული 7stamp-ით.
სასარგებლო გამომავალი: stamps_count, საფულის მდგომარეობა და active_vouchers_count.

API მიერ Zapier ქმედება GET /templates

List Templates

ჩამოთვლის შაბლონებს, რომლებიც ხელმისაწვდომია დაკავშირებული პროფილისთვის და ადასტურებს API კავშირს.

პირველი ტესტი: დარეკეთ ნებისმიერ ჩაწერამდე: ის არ ცვლის მომხმარებლის მონაცემებს.
გამოიყენეთ მოგვიანებით: აქტიური ID ხდება template_id, როდესაც არსებობს მრავალი შაბლონი.

API მიერ Zapier ქმედება GET /templates/{template_id}/design

Get Template Design

ამოიღებს შაბლონის დიზაინის პარამეტრებს ცნობილი შაბლონისთვის ID.

Zapier ტრიგერი Webhooks by Zapier → Catch Hook

ბარათის მოვლენების მიღება

Catch Hook აძლევს Zapier უნიკალურ HTTPS URL. ჩასვით ის 7stamp Admin-ის ვებჰუკის პარამეტრებში და შეამოწმეთ ის რეალური ბარათის მოვლენით.

Zapier-ში: გამოიყენეთ Catch Hook გაანალიზებული მოვლენის მონაცემებისთვის; გამოიყენეთ Catch Raw Hook მხოლოდ მაშინ, როდესაც ასევე გჭირდებათ მოთხოვნის დაუმუშავებელი სათაურები/body.
Match: იპოვეთ CRM კონტაქტი external_id და სურვილისამებრ external_source ღონისძიებიდან.

სამი Zapier სამუშაო ნაკადი, რომელიც შეგიძლიათ შექმნათ ეტაპობრივად

თითოეული სცენარი იყენებს რეალურ, ამჟამად ხელმისაწვდომი Zapier მოდულს. ჯერ შექმენით ერთი პატარა მარშრუტი და შეამოწმეთ იგი ერთჯერადი კონტაქტით, სანამ Zap-ს ჩართავთ.

1. კვალიფიციური CRM კონტაქტი → ბარათის გაცემა

მოსალოდნელი შედეგი: შემდეგი Zap ნაბიჯი იღებს install_url და შეუძლია გაუგზავნოს მომხმარებელს ან ჩაწეროს იგი CRM ჩანაწერში.

1 შექმენით Zap და აირჩიეთ CRM მოვლენა, რაც ნიშნავს, რომ კონტაქტი უფლებამოსილია ლოიალობისთვის. შეამოწმეთ ტრიგერი და დაადასტურეთ, რომ გაქვთ კონტაქტის უცვლელი ID.
2 დაამატეთ API by Zapier → API Request. შექმენით ან აირჩიეთ 7stamp API კლავიშის კავშირი, აირჩიეთ POST და დააყენეთ URL https://api.7loc.com/cards-api/cards/invite.
3 დააყენეთ სხეული JSON. CRM ID გადაიტანეთ external_id-ში, დააყენეთ ფიქსირებული external_source, როგორიცაა kommo, და დაამატეთ template_id მხოლოდ მაშინ, როდესაც ერთზე მეტი 7stamp შაბლონი აქტიურია.
4 შეამოწმეთ მოქმედება. დაადასტურეთ, რომ პასუხი შეიცავს install_url და delivery_insert_code იგივე external_id.
5 დაამატეთ თქვენი CRM განახლება, ელფოსტა ან SMS მოქმედება. რუკა install_url API პასუხიდან; არ დააკოპიროთ ან დააკოპიროთ ტესტი URL.

შეამოწმეთ: შექმნა Card Invite ყოველთვის აბრუნებს ახალ მოწვევას. ჯერ დაამატეთ Find Cards მოთხოვნა ან Zapier ფილტრი, თუ თქვენი პოლიტიკა არის ერთი მოწვევა კონტაქტზე.

2. ფასიანი შეკვეთა → ჯილდოს მარკები

მოსალოდნელი შედეგი: შეკვეთა ქმნის 7stamp სკანირებას და Zap-ს შეუძლია ჩაწეროს stamps_added ან scan_id წყაროს სისტემაში.

1 გამოიყენეთ ფასიანი შეკვეთა/Closed ქვითრის ტრიგერი და შეამოწმეთ იგი. დაადასტურეთ, რომ კლიენტი ID და უნიკალური შეკვეთა ID ორივე იმყოფება გაგრძელებამდე.
2 დაამატეთ API by Zapier → API Request POST https://api.7loc.com/cards-api/cards/scan-ით და აირჩიეთ იგივე 7stamp კავშირი.
3 გაგზავნეთ JSON external_id, external_source, external_order_id, ან თანხა თანხაზე დაფუძნებული შაბლონებისთვის ან stamps_count აშკარა შტამპის ჯილდოსთვის.
4 ტესტი ერთჯერადი შეკვეთით. შეამოწმეთ წარმატება, scan_id და stamps_added პასუხში.
5 დაამატეთ ფილტრი, რომელიც გაგრძელდება მხოლოდ წარმატებული პასუხის შემდეგ, შემდეგ განაახლეთ შეკვეთა/CRM დადასტურებული შედეგით.

შეამოწმეთ: თუ Zap-ის ხელახლა დაკვრა მოხდება, შეამოწმეთ ორიგინალური შეკვეთა სხვა სკანირების გაგზავნამდე. შეინახეთ external_order_id სტაბილურად, რათა მოგვიანებით მოხდეს მოვლენის შეჯერება.

3. 7stamp ღონისძიება → შექმენით CRM შენიშვნა ან დავალება

მოსალოდნელი შედეგი: Zapier იღებს გაანალიზებულ 7stamp მოვლენას, პოულობს მომხმარებელს external_id-ით და ქმნის შესაბამის შემდგომ დაკვირვებას.

1 შექმენით ახალი Zap Webhooks by Zapier ტრიგერით. აირჩიეთ Catch Hook, გააგრძელეთ და დააკოპირეთ ტესტის ეტაპზე ნაჩვენები უნიკალური URL.
2 7stamp Admin-ში გახსენით API & Integrations → Webhooks, დაამატეთ Catch Hook URL, აირჩიეთ მხოლოდ საჭირო მოვლენის ტიპები და შეინახეთ.
3 გამოიწვიოს ნამდვილი ტესტის სკანირება ან ბარათის მოვლენა. დაბრუნდით Zapier-ში, დააწკაპუნეთ Test trigger და დაადასტურეთ, რომ event_type, external_id და external_source მივიდნენ, როგორც ნიმუშის ველები.
4 დაამატეთ CRM კონტაქტის პოვნა ქმედება external_id-ის გამოყენებით. დაამატეთ ფილტრის ან ბილიკის წესი event_type-ისთვის, მაგალითად გამოყავით SCAN REWARD_EARNED-ისგან.
5 შექმენით CRM შენიშვნა/task და დაასახელეთ მხოლოდ ველები, რომლებიც არსებობს ამ მოვლენისთვის, როგორიცაა scanned_at, stamps_after, external_order_id ან issued_vouchers.

შეამოწმეთ: Catch Hook URL საიდუმლოა. თუ Zap გადაეცემა სხვა მფლობელს, განაახლეთ URL 7stamp Admin-ში, სანამ დაეყრდნობით მას.

შექმენით 7stamp API გასაღები Zap-ის აშენებამდე

ეს არის 7stamp გვერდითი საფეხურები. გააკეთეთ ეს ერთხელ, შემდეგ გამოიყენეთ გასაღები მხოლოდ API Zapier კავშირის შიგნით - არა Webhooks by Zapier მოქმედების ველში ან შენიშვნაში.

7stamp Admin API და ინტეგრაციების ეკრანი Add API Key მოქმედებით — გახსენით API და ინტეგრაციები, აირჩიეთ **API Keys**, შემდეგ შექმენით ცალკე გასაღები Zap-ისთვის, სადაც თქვენი ანგარიშის დაყენება იძლევა ამის საშუალებას.

ახლად გენერირებული 7stamp API კლავიატურა მზად არის დასაკოპირებლად — დააკოპირეთ გასაღები უსაფრთხო API Zapier კავშირში და არა უბრალო ტექსტის Webhooks ნაბიჯში ან გაზიარებულ დოკუმენტში.

კავშირის წესები, რომლებიც ხელს უშლის მონაცემთა შეუსაბამობას

შეინახეთ API გასაღები API by Zapier კავშირში

7stamp Admin-ში აირჩიეთ API & Integrations → API Keys → Add API Key. API by Zapier, შექმენით API კლავიშის კავშირი სტატიკური Authorization სათაურით, რომელიც შეიცავს Bearer, რასაც მოჰყვება ეს გასაღები. API by Zapier ინახავს ავტორიზაციას კავშირში ხილული Zap ნაბიჯის ნაცვლად; შეზღუდეთ წვდომა კავშირზე და გადაატრიალეთ გასაღები, თუ ის გაჟღენთილია.

რუკა External ID და External Source თანმიმდევრულად

External ID არის თქვენი საკუთარი სტაბილური მომხმარებლის იდენტიფიკატორი; External Source იარლიყებს საიდან მოვიდა, მაგალითად hubspot, bitrix24, shopify ან პოსტერი. გამოიყენეთ ერთი და იგივე წყვილი ნაკადების შესაქმნელად, პოვნაში, სკანირებისთვის, ვაუჩერებისთვის და ვებჰუკერებისთვის.

იცოდე, რომელი ბარათის იდენტიფიკატორი იგებს

ბარათის მიზნობრივი ქმედებები მიიღება User Card ID ან External ID. როდესაც ორივე იმყოფება, User Card ID უპირატესობას ანიჭებს. გამოიყენეთ შიდა ID მხოლოდ მას შემდეგ, რაც ის დაბრუნდა სანდო 7stamp ნაბიჯით; წინააღმდეგ შემთხვევაში, უპირატესობა მიანიჭეთ წყაროს სისტემას External ID.

ზუსტი API Zapier მოთხოვნა: დააჯილდოვეთ ერთი ბეჭედი

დააკოპირეთ ეს თქვენს ავტომატიზაციის ეტაპზე 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"
}

შექმენით თქვენი პირველი Zap

შექმენით 7stamp API გასაღები ადმინისტრატორში: API & Integrations → API Keys → Add API Key. გამოიყენეთ ცალკე სატესტო გასაღები/profile, როცა ხელმისაწვდომია.

Zapier-ში შექმენით Zap და შეამოწმეთ წყაროს ტრიგერი. გამოიყენეთ რეალური ნიმუში, რათა კონტაქტი ID, კლიენტი ID, შეუკვეთოთ ID და თანხა ხელმისაწვდომი იყოს რუკებისთვის.

დაამატეთ API by Zapier → API Request. შექმენით 7stamp კავშირი სტატიკური Bearer Authorization სათაურისთვის, ვიდრე საიდუმლო Webhooks by Zapier სამოქმედო ველში.

ჯერ დარეკეთ GET https://api.7loc.com/cards-api/templates. ეს ადასტურებს საკვანძო სამუშაოებს და აჩვენებს, რომელი აქტიური შაბლონის ID არის ხელმისაწვდომი მომხმარებლის მონაცემების შეცვლის გარეშე.

აირჩიეთ POST /cards/invite ან POST /cards/scan, დააყენეთ JSON სხეულის ტიპად და ასახეთ სტაბილური External ID პლუს შესაბამისი შაბლონი/order ველები ტრიგერიდან.

შეასრულეთ მოქმედება ერთჯერადი კონტაქტით, შეამოწმეთ მისი ზუსტი პასუხის ველები, შემდეგ გადაიტანეთ ეს ველები შემდეგ CRM-ში, ელფოსტაზე ან შეტყობინებებზე Zap-ის გამოქვეყნებამდე.

გამოიყენეთ უნივერსალური მოთხოვნა მხოლოდ დოკუმენტირებული მარშრუტებისთვის

გამოიყენეთ API by Zapier 7stamp მოთხოვნისთვის Bearer API კლავიშით: ის ინახავს სტატიკურ სათაურის კლავიშებს აპის კავშირში. გამოიყენეთ Webhooks by Zapier Catch Hook ღონისძიების მიწოდებისთვის და არა როგორც სასურველი ადგილი 7stamp საიდუმლოებისთვის. შეინახეთ საბაზისო URL https://api.7loc.com/cards-api,-ზე გამოიყენეთ საჯარო OpenAPI მითითება ზუსტი სქემებისთვის და არასოდეს გაუგზავნოთ რწმუნებათა სიგელები ან მომხმარებლის მონაცემები დაუმოწმებელ URL-ზე.

მიიღეთ 7stamp მოვლენები Catch Hook

-ის მეშვეობით შექმენით Webhooks by Zapier → Catch Hook, დააკოპირეთ უნიკალური URL, რომელიც ნაჩვენებია სატესტო დაყენებაში, ჩასვით 7stamp პროფილის ვებჰუკის პარამეტრებში, აირჩიეთ ღონისძიების რეალური ტიპის ღონისძიების ან გაგზავნის ბარათი. გამოიყენეთ ღონისძიების payload-ის External ID და External Source სწორი CRM კონტაქტის მოსაძებნად. აირჩიეთ Catch Raw Hook მხოლოდ მაშინ, როცა კონკრეტულად გჭირდებათ გაუხსნელი სხეული და მოითხოვეთ სათაურები.

გამოიყენეთ უსაფრთხო Zapier მარშრუტი ახლავე

API by Zapier და Catch Hook საკმარისია ყველა საჯარო 7stamp API ოპერაციისა და ბარათის ღონისძიებისთვის. თუ გჭირდებათ მომავალი მშობლიური 7stamp Zapier აპლიკაცია, გამოგვიგზავნეთ ზუსტი მოქმედება/trigger, რომელსაც თქვენი გუნდი ყველაზე მეტად იყენებს.

იკითხეთ მშობლიური კონექტორის შესახებ

ხშირად დასმული კითხვები

სად ვიპოვო 7stamp აპი Zapier-ში?

დღეს არ არსებობს საჯარო 7stamp ბაზრის აპლიკაცია. გამოიყენეთ API by Zapier → API Request 7stamp API ზარებისთვის და Webhooks by Zapier → Catch Hook შემომავალი 7stamp მოვლენებისთვის.

სად შევქმნა Zapier ჟეტონი?

შექმენით 7stamp API გასაღები ადმინისტრატორის ქვეშ API & Integrations → API Keys → Add API Key. შეინახეთ როგორც სტატიკური Bearer Authorization სათაური API by Zapier კავშირში და არა ხილულ Webhooks by Zapier სამოქმედო ველში.

როგორ შეუძლია Zapier მიიღოს ბეჭედი ან ვაუჩერის ღონისძიება?

შექმენით Catch Hook Webhooks by Zapier-ში, ჩასვით გენერირებული URL 7stamp პროფილის ვებ-ჰუკის პარამეტრებში, აირჩიეთ მოვლენები და გაგზავნეთ სატესტო ღონისძიება CRM განახლებების ჩართვამდე.

უნდა ავირჩიო Zapier თუ Make?

აირჩიეთ Zapier ძირითადად წრფივი ტრიგერული მოქმედების სამუშაო ნაკადისთვის. აირჩიეთ Make, როდესაც გჭირდებათ მარშრუტიზატორები, რთული ტრანსფორმაციები ან გრძელი მრავალ დარგობრივი სცენარი. ორივე იყენებს ერთსა და იმავე 7stamp API კლავიშს და ბოლო წერტილებს.

დაკავშირებული გვერდები

გახსენით Zapier API Zapier დახმარება Zapier Catch Hook დახმარება 7stamp API მითითება Webhook-ის დაყენება Make სახელმძღვანელო

შემდეგი ნაბიჯი

შექმენით პირველი Zap სატესტო კონტაქტით

შექმენით API გასაღები, გამოსცადეთ GET /templates API Zapier-ით, შემდეგ შექმენით ერთი კონტაქტი-ბარათზე ან შეკვეთა-შტამპების მოქმედება. დაამატეთ Catch Hook მას შემდეგ, რაც გამავალ ნაკადს ექნება დადასტურებული ტესტის შედეგი.

გახსენით 7stamp Admin წაიკითხეთ API მითითება