Жаңа CRM контактінен кейін карта жасаңыз
CRM контактіні ID ретінде External ID ретінде пайдаланыңыз, 7stamp картасы шақыруын жасаңыз, содан кейін қайтарылған орнатуды URL әдеттегі электрондық пошта, SMS хабар жіберу қадамы немесе арқылы жіберіңіз.
Кодсыз автоматтандыру нұсқаулығы
7stamp нөмірін Make желісіне жалғау — қадам бойынша
Орындау нұсқаулығы7stamp телефонын CRM, POS, интернет-дүкен, электрондық кесте, хабар алмасу құралы немесе сценарийге деректерді жібере алатын кез келген жүйемен қосу үшін Make пайдаланыңыз. Бүгінгі өндіріске дайын маршрут Make 7stamp API қоңырауларға арналған HTTP қолданбасы және кіріс 7stamp оқиғалары үшін Make Custom webhook болып табылады.
Make қолданбасының таңдау құралында әлі жалпыға қолжетімді 7stamp қолданбасы жоқ. Біреуін күтпеңіз: HTTP → Make a request қосыңыз, дәл URL әдісін, Bearer тақырыбын және төменде JSON пайдаланыңыз, содан кейін бастапқы модульдегі өрістерді салыстырыңыз. Бұл болашақ қосқыш пайдаланатын бірдей 7stamp Integration API.
Жұмыс үрдісіңізге сәйкес келетін бірінші сценарийді таңдаңыз
Бір оқиғадан және бір нәтижеден бастаңыз. Сынақ деректері дұрыс болғаннан кейін сүзгілерді, маршрутизаторларды, CRM жаңартуларын және оның айналасына кейінгі хабарларды қосыңыз.
Ақылы тапсырыстан кейін мөрлерді қосыңыз
Ақылы POS немесе электрондық коммерция тапсырысынан сценарийді іске қосыңыз. Оның тұрақты тұтынушысының ID картасын жасаңыз және Картаны сканерлеуге ID тапсырыс беріңіз, сосын соманы немесе нақты мөр санын пайдаланыңыз.
Сыйақыны жіберу
Карточка оқиғасы сыйлық немесе ваучер туралы хабарлағанда, сценарийді таратыңыз: CRM жаңартыңыз, командаға хабарлаңыз және қажет болғанда ғана әмиян картасын немесе электрондық поштаны жіберіңіз.
Жүйені жергілікті Make қолданбасыз өңдеу
7stamp нөміріне тікелей қоңырау шалу үшін Make HTTP модулін пайдаланыңыз. Бұл реттелетін POS, ERP, брондау механизмі немесе кез келген API-бірінші қызмет үшін әмбебап таңдау.
7stamp операциялары Make HTTP нөмірінен қоңырау шалу
Төмендегі әрбір карта үшін HTTP → Make a request қосыңыз, содан кейін әдісті және URL дәл көрсетілгендей орнатыңыз. Әрбір сұрау үшін бірдей Bearer пернесін пайдаланыңыз. Қажетті салыстыру CRM, POS немесе электрондық коммерция триггерінен не беру керектігін айтады.
Make триггері
Webhooks → Custom webhook Карта оқиғасын алыңыз
Make ішінде Custom webhook жасаңыз, оның URL көшірмесін жасаңыз, содан кейін URL URL профилін ⟦3391 профиль параметрлеріне қойыңыз. Бұл 7stamp SCAN, REWARD_EARNED немесе VOUCHER_ISSUED сияқты оқиғаны жіберген кезде сценарийді бастайды.
- Make
- Webhooks → Custom webhook ішінде → Қосу; оған нақты атау беріңіз және оның жасалған URL көшірмесін жасаңыз.
- 7stamp
- ішінде Admin → API & Integrations → Webhooks; URL қойыңыз, оқиға түрлерін таңдаңыз, сақтаңыз, содан кейін сынақ оқиғасын жасаңыз.
HTTP әрекетін жасаңыз
POST /cards/invite Card Invite
Жаңа жеке орнату URL және бір сыртқы контактіге жеткізу кодын жасайды.
- Міндетті
- external_id — атын емес, тұрақты CRM/contact ID картасын көрсетіңіз.
- Одан кейін электрондық поштаға жауаптан
- Карта install_url, SMS немесе CRM жаңарту қадамын пайдаланыңыз.
HTTP әрекет
POST /cards/invite/bulk Жаппай жасау Card Invites
Бір сұрауда 100 шақыру сілтемесін жасайды. Оны шектелмеген контакт экспорты үшін емес, басқарылатын тасымалдау немесе науқан үшін пайдаланыңыз.
- Міндетті
- элементтер — 1–100 жеке шақыру сұрау нысандарының JSON массиві.
- Сілтемелерді жібермес бұрын
- success_count, error_count және әрбір нәтижені оқыңыз.
HTTP әрекет
GET /cards Find Cards
Қосымша үлгі және бастапқы сүзгілер арқылы External ID арқылы карта жазбаларын табады.
- Міндетті
- Сұрау параметрі external_id.
- Қосымша
- external_source және template_id бір жүйеде бірнеше бағдарлама болған кезде іздеуді тарылтады.
HTTP әрекет
GET /cards/{user_card_id} Карта мәліметтерін алыңыз
Алдыңғы қадам оның ішкі User Card ID мәнін қайтарған кезде бір картаның толық күйін оқиды.
- Міндетті
- {user_card_id} дегенді сенімді 7stamp жауап қайтарған ішкі IDмен ауыстырыңыз.
- аулақ болыңыз
- Басқа профильдегі ID картасын таппаңыз немесе сақтамаңыз.
HTTP әрекет
POST /cards/scan Картаны сканерлеу
Сатып алу сомасынан немесе нақты саннан мөрлерді қосады. Ол User Card ID немесе External ID қабылдайды және сыртқы тапсырыс сілтемесін сақтай алады.
- сәйкестендіру
- external_id және қосымша external_source пайдаланыңыз; Егер екеуі де жеткізілсе, user_card_id ұтады.
- Сатып алу
- Сомаға негізделген карталар үшін пайдалану сомасы немесе анық нөмір үшін stamps_count; stamps_count басымдыққа ие.
- Бақылау мүмкіндігі
- external_order_id картасын ақылы тапсырыстан/receipt картасы, сондықтан 7stamp оқиғаларын қайта салыстыруға болады.
HTTP әрекет
GET /templates List Templates
API пернесі үшін қолжетімді карта үлгілерінің тізімін береді. Оны қосылымды тексеру немесе үлгіні динамикалық таңдау үшін пайдаланыңыз.
- Бірінші сынақ
- Бұл ең қауіпсіз бірінші сұрау: оның денесі жоқ және тұтынушы деректерін өзгертпейді.
- Карта кейінірек
- Белсенді үлгінің идентификаторын профильде бірден көп белсенді үлгі болған кезде ғана template_id ретінде пайдаланыңыз.
HTTP әрекет
GET /templates/{template_id}/design Get Template Design
Белгілі үлгі үшін көрнекі дизайн параметрлерін қайтарады, басқа жүйе тұрақты карта таңдауын көрсету қажет болғанда пайдалы.
HTTP әрекет
POST /vouchers/issue Ваучер беру
External ID немесе User Card ID арқылы анықталған карта иесіне ваучер береді.
- Required
- ваучер қажет.short_description. Картаны external_id немесе белгілі user_card_id арқылы бағыттаңыз.
- Жарамдылық
- validity_type және validity_value пайдаланыңыз немесе белгіленген жарамдылық мерзімі үшін OpenAPI анықтамасын оқыңыз.
HTTP әрекет
POST /messages/send Хабар жіберу
Конфигурацияланған арна мен келісім ережелерін ескере отырып, карта иесіне әмиян картасын түрту және/or электрондық пошта арқылы мазмұнды жібереді.
- Card push
- card_push_text 20 таңбамен шектеледі және орнатылған әмиян билетін қажет етеді.
- Электрондық пошта
- Тақырыпты және негізгі мәтінді жіберу; негізгі HTML денеде қолдау көрсетеді.
Make модулі
Full 7stamp endpoint URL HTTP → Make a request
Бұл жоғарыдағы 7stamp маршрутына қоңырау шалатын Make модулі. Толық URL пайдаланыңыз, құжатталған әдісті таңдаңыз, Bearer тақырыбын қосыңыз және JSON мәнін маршрутқа дене қажет болғанда ғана пайдаланыңыз.
- Негізгі URL
- https://api.7loc.com/cards-api
- Тақырып
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json POST сұраулары үшін.
Сіз жазылғандай дәл құрастыруға болатын үш Make сценарий
Төмендегі атаулар нақты Make модульдері болып табылады. Бірінші сценарийден бастаңыз, оны бір реттік контактіге қарсы іске қосыңыз, содан кейін ғана маршрутизаторларды, сүзгілерді немесе өндірісті жоспарлауды қосыңыз.
1. Жаңа CRM контакт → 7stamp картасының сілтемесін жіберіңіз
Күтілетін нәтиже: Тұтынушы 7stamp арқылы қайтарылған install_url нөмірін алады; сіздің CRM сол URL нөмірін сол контакт жазбасында сақтай алады.
- 1 Сценарий жасаңыз және CRM жаңа/Created контакт триггерін қосыңыз. Kommo үшін контакт жасау триггерін таңдап, контакт үлгісін жүктеу үшін оны бір рет іске қосыңыз.
- 2 HTTP → Make a request қосыңыз. Әдісті POST және URL мәнін https://api.7loc.com/cards-api/cards/invite.
- 3 Authorization қосу: Bearer YOUR_7STAMP_⟧⟦4K етіп орнатыңыз Content-Type: application/json. JSON корпусында CRM контактіні ID контактісін external_id ішіне салыстырып, external_source мәнін коммо сияқты бекітілген белгіге орнатыңыз.
- 4 HTTP модулін бір рет іске қосыңыз. Шығыста install_url, delivery_insert_code, external_id және template_id бар екенін растаңыз.
- 5 HTTP нөмірінен кейін электрондық поштаны/SMS/CRM жаңарту модулін қосыңыз және HTTP шығысынан install_url картасын жасаңыз. Топ кейінірек қайта жіберуі керек болса, URL нөмірін CRM контактісіне сақтаңыз.
Сілтемелерді жібермес бұрын: POST /cards/invite әрқашан жаңа шақыруды жасайды. Find Cards пайдаланыңыз, егер сіздің бизнес ережеңіз бұрыннан бар контактіге басқа шақыруды болдырмау үшін болса.
2. Ақылы тапсырыс → адалдық белгілерін қосу
Күтілетін нәтиже: Сәтті сканерлеу жауабы сәтті, scan_id, stamps_added және келесі қадамыңыз үшін сканерлеуден кейінгі карта күйін қамтиды.
- 1 POS/ecommerce Ақылы тапсырыс триггерінен бастаңыз. Make үлгісінде тұрақты тұтынушы ID және тапсырыс/receipt ID бар екеніне көз жеткізіңіз.
- 2 HTTP → Make a request POST https://api.7loc.com/cards-api/cards/scan және бірдей Bearer тақырыбымен қосыңыз.
- 3 Карта external_id тұтынушыдан, external_source жүйе атауынан және external_order_id ID тапсырысынан. Сомаға негізделген карталар үшін соманы немесе мөрлердің анық саны үшін stamps_count қосыңыз.
- 4 Run once сынақ тапсырысымен. Сценарий кестесін қосу алдында қайтарылған сәттілік жалаушасын және stamps_added тексеріңіз.
- 5 Қажет болса, HTTP қадамынан кейін сүзгіні қосыңыз: сәтті болған кезде ғана жалғастырыңыз, содан кейін тапсырыс/CRM жазбасына scan_id немесе stamps_added деп жазыңыз.
Сілтемелерді жібермес бұрын: Тапсырысты кейінгі веб-хук оқиғаларында қадағалау үшін қайталау кезінде бірдей external_order_id пайдаланыңыз; анық емес сәтсіз жүгіруден кейін маркаларды екі рет бермеңіз.
3. 7stamp оқиғасы → CRM
Күтілетін нәтиже: Make receives the 7stamp event immediately and can find the matching CRM record via external_id and external_source.
- 1 Бөлек Make сценарийін жасаңыз. Webhooks → Custom webhook қосыңыз, Қосу пәрменін таңдаңыз, оны 7stamp-карта-оқиғалары деп атаңыз және жасалған URL файлын көшіріңіз.
- 2 7stamp Admin ішінде API & Integrations → Webhooks ашыңыз. Оны URL қосып, шағын оқиғалар жинағын таңдаңыз, мысалы SCAN және REWARD_EARNED.
- 3 7stamp ішінде бір рет қолданылатын сынақ сканерлеуін немесе карта оқиғасын жасаңыз. Make дегенге оралыңыз және Make оқиға деректерінің құрылымын анықтауға мүмкіндік беру үшін Run once пайдаланыңыз.
- 4 external_id арқылы CRM іздеу қадамын қосыңыз. event_type құрылғысына сүзгіні немесе маршрутизаторды қосыңыз, сондықтан SCAN, REWARD_EARNED және VOUCHER_ISSUED әртүрлі әрекеттерді орындай алады.
- 5 CRM жаңарту/note әрекетін қосыңыз. Карта scanned_at, stamps_after, external_order_id және issued_vouchers таңдалған оқиға түрі үшін сол өрістер болған кезде ғана.
Сілтемелерді жібермес бұрын: Вебхукты URL құпия ұстаңыз. Қайтымсыз хабарларды, ваучерлерді немесе CRM өзгертулерін қоспас бұрын нақты оқиғаны сынап көріңіз.
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.
Құру алдында қосылымды дайындаңыз
Әр орта үшін бір API кілт жасаңыз
7stamp Admin ішінде API & Integrations → API Keys → Add API Key мекенжайына өтіңіз. Бұл опция қол жетімді болған кезде мәнді Make HTTP API кілттік қосылымында/keychain сақтаңыз. Ешқашан кілтті мәтіндік өрістен салыстырмаңыз, оны ескертпеге орналастырмаңыз немесе оны браузерге бағытталған жұмыс процесінде пайдаланбаңыз. Кілт біреуге тиесілі 7stamp жұмыс орнына/profile.
Тұрақты External ID
ID картасын ⟦12, POS немесе сауда платформасы — мысалы CRM контакт ID немесе тұтынушы UUID. Бір идентификатор бірнеше жүйеде пайда болуы мүмкін болса, hubspot, shopify немесе постер сияқты External Source қосыңыз.
Қай үлгі қолданылатынын шешіңіз
Қосылған 7stamp профилінде бір белсенді карта үлгісі болса, Үлгіні бос қалдыруға болады. Әр шақыру және сканерлеу жоспарланған адалдық бағдарламасына жету үшін бірнеше үлгілермен картаға түсіріңіз немесе әдейі template_id таңдаңыз.
Нақты Make HTTP орнату: бір карта шақыруын жасаңыз
Мұны автоматтандыру қадамыңызға көшіріңіз
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
}Алғашқы Make сценарийіңізді құрастырыңыз және сынаңыз
7stamp Admin ішінде API & Integrations → API Keys → Add API Key ішінде кілт жасаңыз. Тіркелгіні орнату рұқсат бергенде, бөлек сынақ профилін/key пайдаланыңыз.
Make ішінде сценарий жасаңыз және бастапқы триггерді қосыңыз. Нақты үлгі контактіні немесе ақылы тапсырысты көру үшін оны салыстыру алдында бір рет іске қосыңыз.
Келесі плюс түймесін басып, HTTP деп іздеңіз және Make сұрауды таңдаңыз. Осы беттегі операция картасынан әдісті, толық URL және тақырыптарды орнатыңыз.
Бірінші сұрау ретінде GET https://api.7loc.com/cards-api/templates пайдаланыңыз. Оның сәтті жауабы кілттің тұтынушы деректерін өзгертпей жұмыс істейтінін дәлелдейді.
POST маршруттары үшін application/json таңдап, осы нұсқаулықтағы дене пішінін қойыңыз. Тұрақты External ID картасы; профильде бірнеше белсенді үлгілер болса ғана template_id қосыңыз.
Бір рет қолданылатын контактімен іске қосыңыз, HTTP шығысын тексеріңіз, содан кейін ғана оның нақты жауап өрістерін келесі CRM, электрондық пошта немесе хабар алмасу модулімен салыстырыңыз.
Make HTTP қолданбасын қашан пайдалану керек?
Қазір 7stamp үшін HTTP пайдаланыңыз: бұл құжатталған, өндіріске дайын маршрут, қысқартылған резерв емес. Оны 7stamp операциясы, жаңа API маршруты немесе реттелетін POS/ERP қосылымы қажет болғанда таңдаңыз. OpenAPI анықтамасы әдіс, толық жол, негізгі және жауап схемасы үшін ақиқат көзі болып табылады; тасымалдаушы кілт пен негіз URL бірдей қалады.
Make ішінде 7stamp оқиғаларын алу
Оқиғаға негізделген сценарий үшін Webhooks → Custom webhook қосыңыз және веб-хук жасаңыз. Оның URL көшіріңіз, 7stamp профилінде API & Integrations → Webhooks ашыңыз, URL қойыңыз, оқиға түрлерін таңдаңыз, сақтаңыз және нақты сынақ оқиғасын жіберіңіз. 7stamp профилі бұл жазылымға ие; ағымдағы API автоматты веб-хук жазылу/unsubscribe соңғы нүктелерін көрсетпейді.
Жалпыға ортақ Make қосқыш қажет емес
Бұл беттегі нұсқаулар әрбір Make тіркелгісінде қолжетімді Make модульдерін пайдаланады. HTTP емес, болашақ 7stamp модулін алғыңыз келсе, бізге қажетті жұмыс процесін жіберіңіз; сол уақытқа дейін HTTP және Custom webhooks құжатталған әрбір 7stamp операцияны қамтиды.
Жиі қойылатын сұрақтар
Мен Make ішінен 7stamp таба алмаймын. Мен оны әлі де автоматтандыруға бола ма?
Yes. There is no public 7stamp app in Make today. Add HTTP > Make a request, use the complete 7stamp endpoint URL, and send Authorization: Bearer followed by your 7stamp API key. HTTP can call every documented endpoint.
Make қосылымы үшін таңбалауышты қайдан аламын?
7stamp Admin ішінде API Интеграцияларды, одан кейін API Keys, содан кейін Add API Key ашыңыз. Кілт оны жасаған жұмыс орнының/profile ауқымына кіреді, сондықтан мүмкіндігінше сынақ сценарийлері үшін сынақ профилін пайдаланыңыз.
Қай идентификаторды External ID ретінде көрсетуім керек?
Бастапқы жүйедегі тұрақты идентификаторды пайдаланыңыз, жақсырақ CRM контакт ID немесе тұтынушы UUID. Көрсетілетін атауды пайдаланбаңыз. Телефон нөмірі немесе электрондық пошта жұмыс істей алады, бірақ өзгеруі мүмкін және оны дәйекті түрде өңдеу керек.
7stamp оқиғаларын Make ішіне қалай алуға болады?
Make ішінде Webhooks > Custom webhook жасаңыз, одан кейін оның жасалған URL мәнін 7stamp профилінің веб-хук параметрлеріне қойыңыз. Кіріс event_typeмен жұмыс істеу үшін жеткізілгеннен кейін Make сүзгісін немесе маршрутизаторды пайдаланыңыз.
Келесі қадам
Бірінші адалдық әрекетін автоматтандыруға дайынсыз ба?
API кілтін жасаңыз, List Templates сынап көріңіз және бір реттік контактімен бір шақыру немесе сканерлеу сценарийін жасаңыз. Маршрутизаторлар мен хабар алмасуды қарапайым ағын сенімді болғаннан кейін ғана қосыңыз.