Automatizavimo vadovas be kodo

Prijunkite 7stamp prie Make – žingsnis po žingsnio

Diegimo vadovas

Naudokite Make, kad susietumėte 7stamp su CRM, POS, internetine parduotuve, skaičiuokle, pranešimų siuntimo įrankiu arba bet kokia sistema, kuri gali siųsti duomenis į scenarijų. Šiandien paruoštas gamybai maršrutas yra Make HTTP programėlė 7stamp API skambučiams ir Make Custom webhook gaunamiems 7stamp įvykiams.

Make programų rinkiklyje dar nėra viešos programos 7stamp. Nelaukite vieno: pridėkite HTTP → Make a request, naudokite tikslią URL, metodą, Bearer antraštę ir JSON žemiau, tada susiekite laukus iš šaltinio modulio. Tai yra ta pati 7stamp Integration API, kurią naudotų būsima jungtis.

Atidaryti Make Atidarykite API nuorodą

Pasirinkite pirmąjį scenarijų, atitinkantį jūsų darbo eigą

Pradėkite nuo vieno įvykio ir vieno rezultato. Kai bandymo duomenys bus teisingi, pridėkite filtrų, maršruto parinktuvų, CRM naujinimų ir tolesnių pranešimų.

Sukurkite kortelę po naujo kontakto CRM

Naudokite CRM kontaktą ID kaip External ID, sukurkite 7stamp kortelės kvietimą, tada išsiųskite grąžintą diegimą URL įprastu el. paštu, SMS arba susirašinėdami pranešimais.

Pridėkite antspaudus po apmokėto užsakymo

Suaktyvinkite scenarijų iš mokamo POS arba el. prekybos užsakymo. Susiekite savo stabilų klientą ID ir užsisakykite ID į „Scan a Card“, tada naudokite sumą arba aiškų antspaudų skaičių.

Siųsti atlygio stebėjimą

Kai kortelės įvykis praneša apie atlygį ar kuponą, suskirstykite scenarijų: atnaujinkite CRM, praneškite komandai ir siųskite piniginės kortelės siuntimą arba el. laišką tik tada, kai reikia.

Tvarkykite sistemą be savosios Make programos

Naudokite Make HTTP modulį, kad tiesiogiai paskambintumėte 7stamp. Tai universalus pasirinkimas tinkintam POS, ERP, rezervavimo varikliui arba bet kuriai API pirmajai paslaugai.

7stamp operacijos skambinti iš Make HTTP

Prie kiekvienos toliau pateiktos kortelės pridėkite HTTP → Make a request, tada nustatykite metodą ir URL tiksliai taip, kaip parodyta. Kiekvienai užklausai naudokite tą patį klavišą Bearer. Būtinas susiejimas nurodo, ką pateikti iš CRM, POS arba el. prekybos aktyviklio.

Make aktyviklis Webhooks → Custom webhook

Gaukite kortelės įvykį

Sukurkite Custom webhook laukelyje Make, nukopijuokite jo URL, tada įklijuokite tą URL į ⟦25310 profilio nustatymus. Taip prasideda scenarijus, kai 7stamp siunčia įvykį, pvz., SCAN, REWARD_EARNED arba VOUCHER_ISSUED.

Į Make
Webhooks → Custom webhook → Pridėti; Suteikite jam aiškų pavadinimą ir nukopijuokite sugeneruotą URL.
Į 7stamp
Administratorius → API & Integrations → Webhooks; įklijuokite URL, pasirinkite įvykių tipus, išsaugokite, tada sukurkite bandomąjį įvykį.
HTTP POST /cards/invite

Sukurkite veiksmą Card Invite

Sukuria naują asmeninį diegimą URL ir pristatymo-įterpimo kodą vienam išoriniam kontaktui.

Būtinas
external_id – nurodykite savo arklidę CRM/contact ID, o ne pavadinimą.
Tada naudokite
Žemėlapį install_url iš atsakymo į el. laišką, SMS arba CRM atnaujinimo veiksmą.
HTTP veiksmas POST /cards/invite/bulk

Masinis kūrimas Card Invites

Vienoje užklausoje sukuriama iki 100 kvietimo nuorodų. Naudokite jį kontroliuojamam perkėlimui ar kampanijai, o ne neribotam kontaktų eksportui.

Reikalingi
elementai – JSON masyvas iš 1–100 individualių kvietimo užklausų objektų.
Patikrinkite
Prieš siųsdami nuorodas perskaitykite success_count, error_count ir kiekvieną rezultatą.
HTTP veiksmas GET /cards

Find Cards

Suranda kortelių įrašus pagal External ID su pasirenkamu šablonu ir šaltinio filtrais.

Būtinas
Užklausos parametras external_id.
Pasirenkama
external_source ir template_id susiaurina paiešką, kai vienoje sistemoje yra kelios programos.
HTTP veiksmas GET /cards/{user_card_id}

Gaukite išsamią kortelės informaciją

Nuskaito visą vienos kortelės būseną, kai ankstesnis veiksmas grąžino vidinį User Card ID.

Būtinas
Pakeiskite {user_card_id} vidiniu ID, kurį grąžino patikimas 7stamp atsakymas.
Venkite
Neatspėkite ir nesaugokite kortelės ID iš kito profilio.
HTTP veiksmas POST /cards/scan

Nuskaityti kortelę

Prideda antspaudų nuo pirkimo sumos arba aiškaus skaičiaus. Jis priima User Card ID arba External ID ir gali išlaikyti išorinės užsakymo nuorodą.

Tapatybė
Naudokite external_id ir pasirinktinai external_source; user_card_id laimi, jei pateikiami abu.
Pirkimas
Naudokite sumą sumomis pagrįstoms kortelėms arba stamps_count aiškaus numerio atveju; stamps_count turi pirmenybę.
Atsekamumas
Žemėlapis external_order_id iš apmokėto užsakymo/receipt, kad būtų galima suderinti 7stamp įvykius.
HTTP veiksmas GET /templates

List Templates

Išvardija kortelių šablonus, pasiekiamus klavišu API. Naudokite jį norėdami išbandyti ryšį arba dinamiškai pasirinkti šabloną.

Pirmasis bandymas
Tai saugiausias pirmasis prašymas: jis neturi kūno ir nekeičia kliento duomenų.
Žemėlapį vėliau
Naudokite aktyvaus šablono ID kaip template_id tik tada, kai profilyje yra daugiau nei vienas aktyvus šablonas.
HTTP veiksmas GET /templates/{template_id}/design

Get Template Design

Grąžina žinomo šablono vaizdinio dizaino nustatymus, kurie yra naudingi, kai kitai sistemai reikia pateikti nuoseklų kortelės pasirinkimą.

HTTP veiksmas POST /vouchers/issue

Išduoti kuponą

Išduoda kuponą kortelės savininkui, pažymėtam External ID arba ⟦25369.

Reikalingas
kuponas.short_description. Taikykite kortelę naudodami external_id arba žinomą user_card_id.
Galiojimas
Naudokite validity_type su validity_value arba perskaitykite OpenAPI nuorodą, kad sužinotumėte fiksuotą galiojimo datą.
HTTP veiksmas POST /messages/send

Siųsti pranešimą

Siunčia turinį kortelės savininkui piniginės kortelės siuntimu ir /or el. paštu, atsižvelgiant į sukonfigūruotą kanalą ir sutikimo taisykles.

Kortelės stūmimas
card_push_text yra apribotas iki 20 simbolių ir reikalingas įdiegtas piniginės leidimas.
El. paštas
Siųsti temą ir tekstą; pagrindinis HTML palaikomas kūne.
Make modulis Full 7stamp endpoint URL

HTTP → Make a request

Tai yra Make modulis, kuris skambina kiekvienu 7stamp nurodytu maršrutu. Naudokite visą URL, pasirinkite dokumentuotą metodą, pridėkite Bearer antraštę ir naudokite JSON tik tada, kai maršrutui reikia kūno.

Bazė URL
https://api.7loc.com/cards-api
Antraštė
Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json už POST užklausas.

Trys Make scenarijai, kuriuos galite sukurti tiksliai taip, kaip parašyta

Toliau pateikti pavadinimai yra tikri Make moduliai. Pradėkite nuo pirmojo scenarijaus, paleiskite jį prieš vienkartinį kontaktą ir tik tada pridėkite maršrutizatorius, filtrus arba gamybos planavimą.

1. Naujas CRM kontaktas → išsiųsti 7stamp kortelės nuorodą

Laukiamas rezultatas: Klientas gauna install_url, grąžintą 7stamp; jūsų CRM gali išsaugoti tą URL tame pačiame kontaktų įraše.

  1. 1 Sukurkite scenarijų ir pridėkite savo CRM Naują/Created Kontaktinį aktyviklį. Kommo pasirinkite kontakto kūrimo aktyviklį ir vieną kartą paleiskite jį, kad įkeltumėte pavyzdinį kontaktą.
  2. 2 Pridėti HTTP → Make a request. Metodą nustatykite į POST ir URL į https://api.7loc.com/cards-api/cards/invite.
  3. 3 Pridėti Authorization: Bearer YOUR_7STAMP_⟧⟦ ir 25457⟧⟧ Content-Type: application/json. JSON turinyje susiekite CRM kontaktą ID į external_id ir nustatykite external_source kaip fiksuotą etiketę, pvz., kommo.
  4. 4 Vieną kartą paleiskite HTTP modulį. Patvirtinkite, kad išvestyje yra install_url, delivery_insert_code, external_id ir template_id.
  5. 5 Pridėkite savo el. pašto adresą/SMS/CRM atnaujinimo modulį po HTTP ir nurodykite install_url iš HTTP išvesties. Išsaugokite URL adresatu CRM, jei komanda vėliau turės jį išsiųsti dar kartą.

Patikrinkite: POST /cards/invite visada sukuria naują kvietimą. Pirmiausia naudokite Find Cards, jei jūsų verslo taisyklė yra vengti kito kvietimo esamam kontaktui.

2. Apmokėtas užsakymas → pridėkite lojalumo ženklų

Laukiamas rezultatas: Sėkmingas nuskaitymo atsakas apima sėkmę scan_id, stamps_added ir kortelės būseną po nuskaitymo, kad galėtumėte atlikti kitą veiksmą.

  1. 1 Pradėkite nuo apmokėto užsakymo aktyviklio POS/ecommerce. Make įsitikinkite, kad pavyzdyje yra stabilus klientas ID ir užsakymas/receipt ID.
  2. 2 Pridėkite HTTP → Make a request su POST https://api.7loc.com/cards-api/cards/scan ir ta pačia antrašte Bearer.
  3. 3 Žemėlapis external_id iš kliento, external_source iš sistemos pavadinimo ir external_order_id iš užsakymo ID. Pridėkite sumą sumomis pagrįstoms kortelėms arba stamps_count, jei norite aiškaus pašto ženklų skaičiaus.
  4. 4 Run once su bandomuoju užsakymu. Prieš įjungdami scenarijaus tvarkaraštį, patikrinkite grąžintą sėkmės vėliavėlę ir stamps_added.
  5. 5 Pasirinktinai pridėkite filtrą po veiksmo HTTP: tęskite tik tada, kai pasisekė, tada grįžkite į užsakymo/CRM įrašą scan_id arba stamps_added.

Patikrinkite: Naudokite tą patį external_order_id bandydami pakartotinai, kad užsakymą būtų galima atsekti vėlesniuose „Webhook“ įvykiuose; nedovanokite pašto ženklų du kartus po neaiškiai nepavykusio bėgimo.

3. 7stamp įvykis → atnaujinkite CRM

Laukiamas rezultatas: Make iš karto gauna įvykį 7stamp ir gali rasti atitinkantį įrašą ⟦255 external_id ir external_source.

  1. 1 Sukurkite atskirą Make scenarijų. Pridėkite Webhooks → Custom webhook, pasirinkite Pridėti, pavadinkite 7stamp-card-events ir nukopijuokite sugeneruotą URL.
  2. 2 Skiltyje 7stamp Admin atidarykite API & Integrations → Webhooks. Pridėkite URL ir pasirinkite nedidelį įvykių rinkinį, pvz., SCAN ir REWARD_EARNED.
  3. 3 Sukurkite vienkartinį bandomąjį nuskaitymą arba kortelės įvykį 7stamp. Grįžkite į Make ir naudokite Run once, kad Make nustatytų įvykio duomenų struktūrą.
  4. 4 Pridėkite CRM paieškos veiksmą naudodami external_id. Pridėkite filtrą arba maršruto parinktuvą prie event_type, kad SCAN, REWARD_EARNED ir VOUCHER_ISSUED galėtų atlikti skirtingus veiksmus.
  5. 5 Pridėkite veiksmą CRM naujinimas/note. Žemėlapis scanned_at, stamps_after, external_order_id ir issued_vouchers tik tada, kai tie laukai yra pasirinktam įvykio tipui.

Patikrinkite: Laikykite webhook URL privatų. Išbandykite tikrą įvykį prieš įjungdami negrįžtamus pranešimus, kuponus ar CRM pakeitimus.

Gaukite klavišą 7stamp API prieš atidarydami Make

Tai yra tikslūs 7stamp Admin ekranai. Sukurkite raktą vieną kartą, nukopijuokite jį į Make saugų HTTP ryšį/keychain, tada nedelsdami pašalinkite jį iš mainų srities.

7stamp Admin API ir integracijų ekranas su API Keys sąrašu ir Add API Key valdikliu
In 7stamp Admin, tada atidarykite integracijas2, 25425⟧, & API Keys ir pasirinkite Add API Key.
Naujas 7stamp API rakto dialogo langas su matomu kopijavimo valdikliu
Nukopijuokite raktą tik į saugų Make HTTP ryšį/keychain. Laikykite jį kaip slaptažodį ir pasukite, jei jis bus atskleistas.

Paruoškite ryšį prieš kurdami

Sukurkite vieną API raktą aplinkai

Lauke 7stamp Admin eikite į API & Integrations → API Keys → Add API Key. Išsaugokite vertę Make HTTP API-key connection/keychain, kai ši parinktis yra prieinama. Niekada nenurodykite rakto iš teksto lauko, nedėkite jo į pastabą ir nenaudokite jo naršyklėje esančioje darbo eigoje. Raktas priklauso vienai 7stamp darbo vietai/profile.

Naudokite stabilią External ID

Susiekite nekintamą, ID⟧ iš savo ID iš ID iš savo ⟦ POS arba prekybos platforma, pvz., CRM kontaktinis numeris ID arba klientas UUID. Pridėkite External Source, pvz., „Hubspot“, „shopify“ arba „poster“, kai tas pats identifikatorius gali būti rodomas daugiau nei vienoje sistemoje.

Nuspręskite, kuris šablonas bus taikomas

Kai prijungtame 7stamp profilyje yra vienas aktyvus kortelės šablonas, šablonas gali būti paliktas tuščias. Naudodami kelis šablonus susiekite arba pasirinkite template_id sąmoningai, kad kiekvienas kvietimas ir nuskaitymas pasiektų numatytą lojalumo programą.

Tiksli Make HTTP sąranka: sukurkite vieną kortelės kvietimą

Nukopijuokite tai į automatizavimo veiksmą 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
}

Sukurkite ir išbandykite pirmąjį Make scenarijų

01

In 7stamp Admin, create a key in API & Integrations → API Keys → Add API Key. Use a separate test profile/key when your account setup allows it.

02

Skiltyje Make sukurkite scenarijų ir pridėkite šaltinio aktyviklį. Paleiskite jį vieną kartą prieš sudarydami žemėlapius, kad galėtumėte matyti tikrą pavyzdį kontaktą arba apmokėtą užsakymą.

03

Spustelėkite kitą pliusą, ieškokite HTTP ir pasirinkite Make užklausą. Šiame puslapyje esančioje operacijos kortelėje nustatykite metodą, visą URL ir antraštes.

04

Naudokite GET https://api.7loc.com/cards-api/templates kaip pirmą užklausą. Sėkmingas atsakymas įrodo, kad raktas veikia nekeičiant jokių klientų duomenų.

05

Maršrutams POST pasirinkite application/json ir įklijuokite kūno formą iš šio vadovo. Nurodykite arklidę External ID; pridėti template_id tik tada, jei profilyje yra keli aktyvūs šablonai.

06

Vykdykite naudodami vienkartinį kontaktą, patikrinkite HTTP išvestį ir tik tada susiekite tikslius jo atsakymo laukus į kitą CRM, el. paštą arba pranešimų modulį.

Kada turėtumėte naudoti Make HTTP?

Naudokite HTTP su 7stamp dabar: tai dokumentais patvirtintas, gamybai paruoštas maršrutas, o ne sumažintas atsarginis variantas. Pasirinkite jį, kai reikia operacijos 7stamp, naujo API maršruto arba tinkinto POS/ERP ryšio. OpenAPI nuoroda yra metodo, viso kelio, kūno ir atsako schemos tiesos šaltinis; nešiklio raktas ir bazė URL lieka tokie patys.

Gaukite 7stamp įvykius Make

Jei norite įvykiais pagrįsto scenarijaus, pridėkite Webhooks → Custom webhook ir sukurkite žiniatinklio kabliuką. Nukopijuokite jo URL, atidarykite API & Integrations → Webhooks profilyje 7stamp, įklijuokite URL, pasirinkite įvykių tipus, išsaugokite ir išsiųskite tikrą bandomąjį įvykį. 7stamp profiliui priklauso ta prenumerata; dabartinis API neatskleidžia automatinio webhook prenumeratos/unsubscribe galinių taškų.

Nereikalaujama viešos Make jungties

Šiame puslapyje pateiktose instrukcijose naudojami Make moduliai, pasiekiami kiekvienai Make paskyrai. Jei ateityje norite turėti 7stamp vietinį modulį, o ne HTTP, atsiųskite mums reikalingą darbo eigą; iki tol HTTP ir Custom webhook apima kiekvieną dokumentuotą 7stamp operaciją.

Klauskite apie savąją jungtį

Dažnai užduodami klausimai

Nerandu 7stamp Make. Ar vis tiek galiu tai automatizuoti?

Taip. Šiandien Make nėra viešos programos 7stamp. Pridėkite HTTP > Make užklausą, naudokite visą 7stamp galinį tašką URL ir išsiųskite Authorization: Bearer, po kurio nurodykite raktą 7stamp API. HTTP gali iškviesti kiekvieną dokumentuotą galinį tašką.

Kur gauti Make ryšio prieigos raktą?

Skiltyje 7stamp Admin atidarykite API Integrations, tada API Keys, tada Add API Key. Raktas taikomas jį sukūrusiai darbo vietai/profile, todėl, kai tik įmanoma, naudokite bandymo scenarijus.

Kurį identifikatorių turėčiau susieti su External ID?

Naudokite stabilų identifikatorių iš šaltinio sistemos, pageidautina CRM kontaktinį numerį ID arba klientą UUID. Nenaudokite rodomo pavadinimo. Telefono numeris arba el. pašto adresas gali veikti, bet gali keistis ir turėtų būti tvarkomi nuosekliai.

Kaip 7stamp įvykius perkelti į Make?

Sukurkite Webhooks > Custom webhook Make, tada įklijuokite sugeneruotą URL į 7stamp profilio webhook nustatymus. Po pristatymo naudokite filtrą Make arba maršruto parinktuvą, kad galėtumėte apdoroti gaunamą numerį event_type.

Susiję puslapiai

Atidaryti Make Make HTTP pagalba Make Custom webhook pagalba 7stamp API nuoroda Webhook sąranka Zapier vadovas

Kitas žingsnis

Pasiruošę automatizuoti pirmąjį lojalumo veiksmą?

Sukurkite raktą API, išbandykite List Templates ir sukurkite vieną kvietimo arba nuskaitymo scenarijų su vienkartiniu kontaktu. Pridėkite maršruto parinktuvus ir pranešimų siuntimą tik tada, kai paprastas srautas bus patikimas.

Atidaryti 7stamp Admin Perskaitykite nuorodą API