Առանց կոդերի ավտոմատացման ուղեցույց

Միացնել 7stamp Make-ին — քայլ առ քայլ

Իրականացման ուղեցույց

Օգտագործեք Make՝ 7stamp-ը CRM, POS, առցանց խանութի, աղյուսակի, հաղորդագրությունների փոխանցման գործիքի կամ ցանկացած համակարգի հետ միացնելու համար, որը կարող է տվյալներ ուղարկել սցենար: Արտադրության համար պատրաստ երթուղին այսօր Make-ի HTTP հավելվածն է 7stamp API զանգերի համար և Make-ի Custom webhook մուտքային 7stamp իրադարձությունների համար:

Make հավելվածի ընտրիչում դեռևս չկա հանրային 7stamp հավելված: Մի սպասեք մեկին. ավելացրեք HTTP → Make a request, օգտագործեք ճշգրիտ URL, մեթոդը, Bearer վերնագիրը և JSON ստորև, ապա քարտեզագրեք դաշտերը ձեր աղբյուրի մոդուլից: Սա նույն 7stamp Integration API-ն է, որը կօգտագործի ապագա միակցիչը:

Բացեք Make Բացեք API հղումը

Ընտրեք առաջին սցենարը, որը համապատասխանում է ձեր աշխատանքի ընթացքին

Սկսեք մեկ իրադարձությունից և մեկ արդյունքից: Երբ թեստի տվյալները ճիշտ են, ավելացրեք զտիչներ, երթուղիչներ, CRM թարմացումներ և դրանց շուրջ հաղորդագրություններ:

Ստեղծեք քարտ նոր CRM կոնտակտից հետո

Օգտագործեք CRM կոնտակտային ID որպես External ID, ստեղծեք 7stamp քարտի հրավեր, այնուհետև ուղարկեք վերադարձված տեղադրման URL ձեր սովորական էլ.փոստի, SMS կամ հաղորդագրությունների միջոցով:

Վճարովի պատվերից հետո դրոշմակնիքներ ավելացրեք

Գործարկեք սցենարը վճարովի POS կամ էլեկտրոնային առևտրի պատվերից: Քարտեզագրեք իր կայուն հաճախորդին ID և պատվիրեք ID Քարտի սկանավորման մեջ, այնուհետև օգտագործեք գումարի կամ դրոշմակնիքների հստակ քանակ:

Ուղարկեք պարգևի հետևում

Երբ քարտի իրադարձությունը հաղորդում է պարգևի կամ վաուչերի մասին, ճյուղավորեք սցենարը. թարմացրեք CRM-ը, ծանուցեք թիմին և ուղարկեք դրամապանակի քարտ կամ էլեկտրոնային նամակ միայն անհրաժեշտության դեպքում:

Կառավարեք համակարգ առանց բնիկ Make հավելվածի

Օգտագործեք Make-ի HTTP մոդուլը՝ ուղղակիորեն 7stamp զանգահարելու համար: Սա ունիվերսալ ընտրություն է հատուկ POS, ERP, ամրագրման շարժիչի կամ API-առաջին ծառայության համար:

7stamp գործողություններ Make HTTP-ից զանգահարելու համար

Ստորև բերված յուրաքանչյուր քարտի համար ավելացրեք HTTP → Make a request, ապա դրեք մեթոդը և URL ճիշտ այնպես, ինչպես ցույց է տրված: Յուրաքանչյուր հարցման համար օգտագործեք նույն Bearer ստեղնը: Պահանջվող քարտեզագրումը ձեզ հուշում է, թե ինչ մատակարարել ձեր CRM, POS կամ էլեկտրոնային առևտրի գործարկիչից:

Make գործարկիչ Webhooks → Custom webhook

Ստացեք քարտի իրադարձություն

Ստեղծեք Custom webhook Make, պատճենեք դրա URL, այնուհետև տեղադրեք այդ URL 7stamp պրոֆիլի վեբ կեռիկի կարգավորումներում: Սա սկսում է մի սցենար, երբ 7stamp ուղարկում է այնպիսի իրադարձություն, ինչպիսին է SCAN, REWARD_EARNED կամ VOUCHER_ISSUED:

Make-ում
Webhooks → Custom webhook → Ավելացնել; տվեք նրան հստակ անուն և պատճենեք դրա ստեղծած URL:
7stamp
Ադմին → 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 Invite

Ստեղծում է մինչև 100 հրավեր հղումներ մեկ հարցումով: Օգտագործեք այն վերահսկվող միգրացիայի կամ քարոզարշավի համար, այլ ոչ թե անսահմանափակ կոնտակտային արտահանման համար:

Պահանջվող
տարրեր — JSON զանգված 1–100 անհատական ​​հրավերի հարցման օբյեկտներից:
Ստուգեք
Կարդացեք 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}-ը ներքին ID-ով, որը վերադարձվել է վստահելի 7stamp պատասխանով:
Խուսափեք
-ից Մի գուշակեք կամ մի պահեք ID քարտը այլ պրոֆիլից:
HTTP գործողություն POST /cards/scan

Քարտի սկանավորում

Ավելացնում է դրոշմանիշներ գնման գումարից կամ բացահայտ քանակից: Այն ընդունում է User Card ID կամ External ID և կարող է պահպանել արտաքին պատվերի հղումը:

Ինքնություն
Օգտագործեք external_id և կամընտիր external_source; user_card_id-ը հաղթում է, եթե երկուսն էլ մատակարարվեն:
Գնեք
Օգտագործեք գումարը գումարի վրա հիմնված քարտերի համար կամ stamps_count բացահայտ համարի համար. stamps_count-ն առաջնահերթություն է:
Traceability
Քարտեզեք external_order_id վճարովի պատվերից/receipt, որպեսզի 7stamp իրադարձությունները հնարավոր լինի համընկնել:
HTTP գործողություն GET /templates

List Templates

Ցուցակում է քարտի ձևանմուշները, որոնք հասանելի են API ստեղնին: Օգտագործեք այն կապը փորձարկելու կամ դինամիկ ձևանմուշ ընտրելու համար:

Առաջին փորձարկում
Սա ամենաանվտանգ առաջին հարցումն է. այն չունի մարմին և չի փոխում հաճախորդների տվյալները:
Քարտեզ ավելի ուշ
Օգտագործեք ակտիվ ձևանմուշի ID-ն որպես template_id միայն այն դեպքում, երբ պրոֆիլն ունի մեկից ավելի ակտիվ ձևանմուշ:
HTTP գործողություն GET /templates/{template_id}/design

Get Template Design

Վերադարձնում է հայտնի ձևանմուշի տեսողական դիզայնի կարգավորումները, որոնք օգտակար են, երբ մեկ այլ համակարգ պետք է ցուցադրի քարտի հետևողական ընտրություն:

HTTP գործողություն POST /vouchers/issue

Թողարկեք վաուչեր

վաուչեր է տրամադրում External ID կամ User Card ID կողմից ճանաչված քարտի սեփականատիրոջը:

Պահանջվում է
վաուչեր.short_description: Թիրախավորեք քարտը external_id կամ հայտնի user_card_id-ով:
վավերականություն
Օգտագործեք validity_type validity_value-ի հետ կամ կարդացեք OpenAPI տեղեկանքը ֆիքսված ժամկետի համար:
HTTP գործողություն POST /messages/send

Հաղորդագրություն ուղարկել

բովանդակությունն ուղարկում է քարտի սեփականատիրոջը դրամապանակ-քարտի սեղմման և /or էլ.փոստի միջոցով՝ համաձայն կազմաձևված ալիքի և համաձայնության կանոնների:

Քարտի սեղմում
card_push_text սահմանափակված է 20 նիշով և պահանջում է տեղադրված դրամապանակի անցագիր:
Էլ. փոստ
Ուղարկել առարկան գումարած տեքստը; հիմնական HTML-ն ապահովված է մարմնում:
Make մոդուլ Full 7stamp endpoint URL

HTTP → Make a request

Սա Make մոդուլն է, որը կանչում է վերը նշված յուրաքանչյուր 7stamp երթուղին: Օգտագործեք ամբողջական URL, ընտրեք փաստաթղթավորված մեթոդը, ավելացրեք Bearer վերնագիրը և օգտագործեք JSON միայն այն դեպքում, երբ երթուղին մարմնի կարիք ունի:

Base URL
https://api.7loc.com/cards-api
Header
Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json for POST requests.

Երեք Make սցենարներ, որոնք կարող եք կառուցել ճիշտ այնպես, ինչպես գրված է

Ստորև բերված անունները իրական Make մոդուլներն են: Սկսեք առաջին սցենարից, գործարկեք այն միանգամյա օգտագործման կոնտակտի վրա և միայն դրանից հետո ավելացրեք երթուղիչներ, զտիչներ կամ արտադրության ժամանակացույց:

1. Նոր CRM կոնտակտ → ուղարկել 7stamp քարտի հղում

Ակնկալվող արդյունքը: Հաճախորդը ստանում է install_url վերադարձված 7stamp-ի կողմից; ձեր CRM-ը կարող է պահել այդ URL-ը նույն կոնտակտային գրառման մեջ:

  1. 1 Ստեղծեք սցենար և ավելացրեք ձեր CRM-ի New/Created կոնտակտային գործարկիչը: Kommo-ի համար ընտրեք կոնտակտի ստեղծման ձգան և գործարկեք այն մեկ անգամ՝ կոնտակտի նմուշ բեռնելու համար:
  2. 2 Ավելացնել HTTP → Make a request: Մեթոդը դրեք POST և URL՝ https://api.7loc.com/cards-api/cards/invite.
  3. 3 Ավելացնել Authorization՝ Bearer YOUR_7STAMP_API_KEY և Content-Type՝ application/json: JSON մարմնում քարտեզագրեք CRM կոնտակտը ID-ի մեջ external_id և դրեք external_source ֆիքսված պիտակի վրա, ինչպիսին է kommo-ն:
  4. 4 Գործարկեք HTTP մոդուլը մեկ անգամ: Հաստատեք, որ ելքը ունի install_url, delivery_insert_code, external_id և template_id:
  5. 5 Ավելացրեք ձեր էլ. փոստը/SMS/CRM թարմացման մոդուլը HTTP-ից հետո և քարտեզագրեք install_url HTTP ելքից: Պահպանեք URL CRM կոնտակտի վրա, եթե թիմը պետք է այն ավելի ուշ ուղարկի:

Ստուգեք: POST /cards/invite միշտ թարմ հրավեր է ստեղծում: Սկզբում օգտագործեք Find Cards, եթե ձեր բիզնեսի կանոնն է խուսափել գոյություն ունեցող կոնտակտի այլ հրավերից:

2. Վճարովի պատվեր → ավելացնել հավատարմության դրոշմանիշեր

Ակնկալվող արդյունքը: Սկանավորման հաջող պատասխանը ներառում է հաջողություն, scan_id, stamps_added և հետսկանավորման քարտի վիճակը ձեր հաջորդ քայլի համար:

  1. 1 Սկսեք POS/ecommerce վճարովի պատվերի գործարկիչից: Make վստահ է, որ իր նմուշը պարունակում է կայուն հաճախորդ ID և /receipt ID պատվերը:
  2. 2 Ավելացրեք HTTP → Make a request POST https://api.7loc.com/cards-api/cards/scan-ով և նույն Bearer վերնագրով:
  3. 3 Քարտեզ external_id հաճախորդից, external_source համակարգի անունից և external_order_id ID պատվերից: Գումար ավելացրեք գումարի վրա հիմնված քարտերի համար կամ stamps_count դրոշմանիշների հստակ քանակի համար:
  4. 4 Run once փորձարկման պատվերով: Ստուգեք վերադարձված հաջողության դրոշակը և stamps_added նախքան սցենարի ժամանակացույցը միացնելը:
  5. 5 Ցանկության դեպքում ավելացրեք զտիչ HTTP քայլից հետո. շարունակեք միայն այն ժամանակ, երբ հաջողությունը ճշմարիտ է, այնուհետև գրեք scan_id կամ stamps_added /CRM պատվերի գրառումին:

Ստուգեք: Օգտագործեք նույն external_order_id-ը կրկնակի փորձերի ժամանակ, որպեսզի հաջորդական webhook-ի իրադարձություններում հնարավոր լինի հետևել պատվերին. անհասկանալի ձախողումից հետո երկու անգամ նամականիշեր մի շնորհեք:

3. 7stamp իրադարձություն → թարմացնել CRM

Ակնկալվող արդյունքը: Make-ն անմիջապես ստանում է 7stamp իրադարձությունը և կարող է գտնել համապատասխան CRM գրառումը external_id-ի և external_source-ի միջոցով:

  1. 1 Ստեղծեք առանձին Make սցենար: Ավելացրեք Webhooks → Custom webhook, ընտրեք Ավելացնել, անվանեք այն 7stamp-քարտ-իրադարձություններ և պատճենեք ստեղծված URL-ը:
  2. 2 7stamp Admin-ում բացեք API & Integrations → Webhooks: Ավելացրե՛ք այդ URL-ը և ընտրե՛ք իրադարձությունների մի փոքր շարք, օրինակ՝ SCAN և REWARD_EARNED:
  3. 3 Ստեղծեք միանգամյա օգտագործման փորձնական սկան կամ քարտի իրադարձություն 7stamp-ում: Վերադարձեք Make և օգտագործեք Run once՝ թույլ տալու համար, որ Make որոշի իրադարձության տվյալների կառուցվածքը։
  4. 4 Ավելացրեք CRM որոնման քայլ՝ օգտագործելով external_id: Ավելացրեք զտիչ կամ երթուղիչ event_type-ում, որպեսզի SCAN, REWARD_EARNED և VOUCHER_ISSUED տարբեր գործողություններ կատարեն:
  5. 5 Ավելացրեք CRM թարմացումը/note գործողությունը: Քարտեզ scanned_at, stamps_after, external_order_id և issued_vouchers միայն այն դեպքում, երբ այդ դաշտերը առկա են ընտրված իրադարձության տեսակի համար:

Ստուգեք: Պահպանեք վեբ-կապիկը URL գաղտնի: Փորձարկեք իրական իրադարձությունը նախքան անշրջելի հաղորդագրությունները, վաուչերները կամ CRM փոփոխությունները միացնելը:

Get the 7stamp API key before opening Make

These are the exact 7stamp Admin screens. Ստեղծեք բանալին մեկ անգամ, պատճենեք այն Make-ի անվտանգ HTTP կապի մեջ/keychain, ապա անմիջապես հեռացրեք այն ձեր clipboard-ից:

7stamp Admin API & Integrations էկրանը API Keys ցուցակով և Add API Key կառավարման
In 7stamp Admin, open API & Integrations, then API Keys, and select Add API Key.
Նոր 7stamp API ստեղնի երկխոսություն՝ տեսանելի պատճենահանման կառավարմամբ
Պատճենեք բանալին միայն ապահով Make HTTP կապի մեջ/keychain. Վերաբերվեք այն որպես գաղտնաբառ և պտտեք այն, եթե այն բաց է:

Նախապատրաստեք կապը

կառուցելուց առաջ Ստեղծեք մեկ API բանալի յուրաքանչյուր միջավայրի համար

7stamp Admin-ում անցեք API & Integrations → API Keys → Add API Key: Պահպանեք արժեքը Make-ի HTTP API-բանալին կապի մեջ/keychain, երբ այդ տարբերակը հասանելի է: Երբեք մի քարտեզագրեք բանալին տեքստային դաշտից, մի տեղադրեք այն գրառման մեջ կամ օգտագործեք այն դիտարկիչին ուղղված աշխատանքային հոսքում: Բանալին պատկանում է մեկ 7stamp աշխատավայրին/profile.

Օգտագործեք կայուն External ID

Քարտեզագրեք անփոփոխելի ID-ը ձեր CRM, POS, կամ առևտրային TMTMXMT, կամ առևտրային TMXST հարթակից, օրինակ՝ a. UUID. Ավելացրեք External Source, ինչպիսիք են hubspot-ը, shopify-ը կամ պաստառը, երբ նույն նույնացուցիչը կարող է հայտնվել մեկից ավելի համակարգերում:

Որոշեք, թե որ ձևանմուշը կկիրառվի

Երբ միացված 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 սցենարը

01

7stamp Admin-ում ստեղծեք բանալի API & Integrations → API Keys → Add API Key-ում: Օգտագործեք առանձին թեստային պրոֆիլ/key, երբ ձեր հաշվի կարգավորումը դա թույլ է տալիս:

02

Make-ում ստեղծեք սցենար և ավելացրեք աղբյուրի գործարկիչը: Գործարկեք այն մեկ անգամ նախքան քարտեզագրելը, որպեսզի կարողանաք տեսնել իրական կոնտակտ կամ վճարովի պատվեր:

03

Սեղմեք հաջորդ գումարածը, որոնեք HTTP և ընտրեք Make հարցում: Սահմանեք մեթոդը, ամբողջական URL և վերնագրերը այս էջի գործառնական քարտից:

04

Օգտագործեք GET https://api.7loc.com/cards-api/templates որպես առաջին հարցում: Դրա հաջող պատասխանը ցույց է տալիս, որ բանալին աշխատում է առանց հաճախորդի որևէ տվյալի փոփոխության:

05

POST երթուղիների համար ընտրեք application/json և տեղադրեք մարմնի ձևը այս ուղեցույցից: Քարտեզագրեք կայուն External ID; ավելացնել template_id միայն այն դեպքում, եթե պրոֆիլն ունի բազմաթիվ ակտիվ ձևանմուշներ:

06

Գործարկեք միանգամյա օգտագործման կոնտակտով, ստուգեք HTTP ելքը և միայն այնուհետև քարտեզագրեք դրա պատասխանի ճշգրիտ դաշտերը հաջորդ CRM, էլփոստի կամ հաղորդագրությունների մոդուլի մեջ:

Ե՞րբ պետք է օգտագործեք Make HTTP:

Օգտագործեք HTTP-ը 7stamp-ի համար հիմա. դա փաստաթղթավորված, արտադրության համար պատրաստ երթուղի է, այլ ոչ թե կրճատված վերադարձ: Ընտրեք այն, երբ ձեզ անհրաժեշտ է 7stamp գործողություն, նոր API երթուղի կամ հատուկ POS/ERP կապ: OpenAPI հղումը ճշմարտության աղբյուրն է մեթոդի, ամբողջական ուղու, մարմնի և պատասխանի սխեմայի համար. կրող բանալին և հիմքը URL մնում են նույնը:

Ստացեք 7stamp իրադարձություններ Make

Իրադարձությունների վրա հիմնված սցենարի համար ավելացրեք Webhooks → Custom webhook և ստեղծեք վեբ-կեռիկ: Պատճենեք դրա URL-ը, բացեք API & Integrations → Webhooks 7stamp պրոֆիլում, տեղադրեք URL-ը, ընտրեք իրադարձությունների տեսակները, պահեք և ուղարկեք իրական փորձնական իրադարձություն: 7stamp պրոֆիլին է պատկանում այդ բաժանորդագրությունը. ընթացիկ API-ը չի բացահայտում ավտոմատ webhook բաժանորդագրվել/unsubscribe վերջնակետերը:

Ոչ մի հանրային Make միակցիչ չի պահանջվում

Այս էջի հրահանգներում օգտագործվում են Make մոդուլներ, որոնք հասանելի են յուրաքանչյուր Make հաշվի համար: Եթե ​​ցանկանում եք ապագա բնիկ 7stamp մոդուլ, այլ ոչ թե HTTP, ուղարկեք մեզ անհրաժեշտ աշխատանքային հոսքը; մինչ այդ, HTTP և Custom webhook-ները ծածկում են յուրաքանչյուր փաստաթղթավորված 7stamp գործողություն:

Հարցրեք բնիկ միակցիչի մասին

Հաճախ տրվող հարցեր

Ես չեմ կարող գտնել 7stamp Make-ում: Կարո՞ղ եմ դեռ ավտոմատացնել այն:

Այո: Այսօր Make-ում հանրային 7stamp հավելված չկա: Ավելացրեք HTTP > Make հարցում, օգտագործեք ամբողջական 7stamp վերջնակետը URL և ուղարկեք Authorization՝ Bearer, որին հաջորդում է ձեր 7stamp API բանալիը: HTTP-ը կարող է զանգահարել յուրաքանչյուր փաստաթղթավորված վերջնակետ:

Որտեղի՞ց կարող եմ ստանալ Make կապի նշանը:

7stamp Admin-ում բացեք API Integrations, ապա API Keys, ապա Add API Key: Բանալին ընդգրկված է աշխատավայրում /profile, որը ստեղծել է այն, այնպես որ հնարավորության դեպքում օգտագործեք թեստային պրոֆիլ փորձարկման սցենարների համար:

Ո՞ր նույնացուցիչը պետք է քարտեզագրեմ որպես External ID:

Օգտագործեք կայուն նույնացուցիչը աղբյուրի համակարգից, նախընտրելի է CRM կոնտակտ ID կամ հաճախորդի UUID: Մի օգտագործեք ցուցադրվող անուն: Հեռախոսահամարը կամ էլփոստը կարող են աշխատել, բայց կարող են փոխվել և պետք է հետևողականորեն կարգավորվեն:

Ինչպե՞ս կարող եմ 7stamp իրադարձությունները մուտքագրել Make:

Ստեղծեք Webhooks > Custom webhook Make-ում, այնուհետև տեղադրեք դրա ստեղծած URL-ը 7stamp պրոֆիլի վեբկեռկի կարգավորումներում: Առաքումից հետո օգտագործեք Make զտիչ կամ երթուղիչ՝ մուտքային event_type-ը կարգավորելու համար:

Առնչվող էջեր

Բացեք Make Make HTTP օգնություն Make Custom webhook օգնություն 7stamp API հղում Webhook-ի կարգավորում Zapier ուղեցույց

Հաջորդ քայլը

Պատրա՞ստ եք ավտոմատացնել առաջին հավատարմության գործողությունը:

Ստեղծեք API ստեղնը, փորձարկեք List Templates և ստեղծեք մեկ հրավեր կամ սկանավորեք սցենար միանգամյա օգտագործման կոնտակտով: Ավելացրեք երթուղիչներ և հաղորդագրություններ միայն այն բանից հետո, երբ պարզ հոսքը հուսալի լինի:

Բացեք 7stamp Admin Կարդացեք API հղումը