Vodič za automatizaciju bez koda

Povežite 7stamp na Make — korak po korak

Vodič za implementaciju

Koristite Make za povezivanje 7stamp s CRM, POS, internetskom trgovinom, proračunskom tablicom, alatom za razmjenu poruka ili bilo kojim sustavom koji može slati podatke u scenarij. Ruta spremna za proizvodnju danas je Make aplikacija HTTP za 7stamp API pozive i Make Custom webhook za dolazne 7stamp događaje.

Još nema javne aplikacije 7stamp u biraču aplikacija Make. Nemojte čekati na jedno: dodajte HTTP → Make a request, upotrijebite točnu URL, metodu, Bearer zaglavlje i JSON u nastavku, zatim mapirajte polja iz svog izvornog modula. Ovo je isti 7stamp Integration API koji bi koristio budući konektor.

Otvori Make Otvori API referencu

Odaberite prvi scenarij koji odgovara vašem tijeku rada

Započnite s jednim događajem i jednim ishodom. Nakon što su testni podaci točni, dodajte filtre, usmjerivače, CRM ažuriranja i prateće poruke oko njih.

Izradite karticu nakon novog CRM kontakta

Koristite CRM kontakt ID kao External ID, izradite pozivnicu za karticu 7stamp, zatim pošaljite vraćenu instalaciju URL putem vaše uobičajene e-pošte, SMS ili putem koraka slanja poruka.

Dodajte marke nakon plaćene narudžbe

Pokrenite scenarij iz plaćene POS ili e-trgovinske narudžbe. Mapirajte njegovog stabilnog kupca ID i naručite ID u Scan a Card, zatim upotrijebite iznos ili eksplicitni broj markica.

Pošaljite nastavak za nagradu

Kada događaj s karticom prijavi nagradu ili vaučer, razgranajte scenarij: ažurirajte CRM, obavijestite tim i pošaljite push karticu novčanika ili e-poštu samo kada je to potrebno.

Upravljajte sustavom bez izvorne aplikacije Make

Koristite modul HTTP Make za izravni poziv 7stamp. Ovo je univerzalni izbor za prilagođeni POS, ERP, mehanizam za rezervacije ili bilo koju API-prvu uslugu.

7stamp operacije za pozivanje s Make HTTP

Za svaku karticu u nastavku dodajte HTTP → Make a request, zatim postavite metodu i URL točno kako je prikazano. Koristite isti ključ Bearer za svaki zahtjev. Potrebno mapiranje govori vam što trebate dostaviti s okidača CRM, POS ili e-trgovine.

Make okidač Webhooks → Custom webhook

Primi događaj kartice

Stvorite Custom webhook u Make, kopirajte njegov URL, a zatim zalijepite taj URL u postavke webhooka profila 7stamp. Ovo pokreće scenarij kada 7stamp pošalje događaj kao što je SCAN, REWARD_EARNED ili VOUCHER_ISSUED.

U Make: Webhooks → Custom webhook → Dodaj; dajte mu jasno ime i kopirajte generirani URL.
U 7stamp: Admin → API & Integrations → Webhooks; zalijepite URL, odaberite vrste događaja, spremite, zatim izradite testni događaj.

HTTP POST /cards/invite

Stvori akciju Card Invite

Stvara svježu osobnu instalaciju URL i kod za umetanje isporuke za jedan vanjski kontakt.

Obavezno: external_id — mapirajte svoju štalu CRM/contact ID, a ne ime.
Zatim upotrijebite: Mapirajte install_url iz odgovora u svoju e-poštu, SMS ili CRM korak ažuriranja.

HTTP akcija POST /cards/invite/bulk

Skupna izrada Card Invites

Stvara do 100 pozivnih veza u jednom zahtjevu. Koristite ga za kontroliranu migraciju ili kampanju, a ne neograničeni izvoz kontakata.

Potrebnih: stavki — JSON niz od 1–100 pojedinačnih objekata zahtjeva za poziv.
Označite: Pročitajte success_count, error_count i svaki rezultat prije slanja poveznica.

HTTP radnja GET /cards

Find Cards

Pronalazi zapise kartice prema External ID, s izbornim predloškom i filtrima izvora.

Obavezno: Parametar upita external_id.
Izborno: external_source i template_id sužavaju pretraživanje kada jedan sustav ima više programa.

HTTP akcija GET /cards/{user_card_id}

Dobijte detalje kartice

Čita potpuno stanje jedne kartice kada je prethodni korak vratio svoj interni User Card ID.

Obavezno: Zamijenite {user_card_id} internim ID koje vraća pouzdani odgovor 7stamp.
Izbjegavajte: Ne pogađajte i ne spremajte karticu ID s drugog profila.

HTTP radnja POST /cards/scan

Skeniraj karticu

Dodaje marke iz iznosa kupnje ili izričitog brojanja. Prihvaća User Card ID ili External ID i može zadržati vanjsku referencu naloga.

Identitet: Koristite external_id i izborno external_source; user_card_id pobjeđuje ako su dostavljena oba.
Kupite: Koristite iznos za kartice koje se temelje na iznosu ili stamps_count za eksplicitni broj; stamps_count ima prednost.
Sljedivost: Mapirajte external_order_id iz plaćene narudžbe/receipt tako da se događaji 7stamp mogu usporediti.

HTTP akcija GET /templates

List Templates

Navodi predloške kartica dostupnih ključu API. Koristite ga za testiranje veze ili za dinamički odabir predloška.

Prvi test: Ovo je najsigurniji prvi zahtjev: nema tijelo i ne mijenja korisničke podatke.
Karta kasnije: Koristite ID aktivnog predloška kao template_id samo kada profil ima više od jednog aktivnog predloška.

HTTP radnja GET /templates/{template_id}/design

Get Template Design

Vraća postavke vizualnog dizajna za poznati predložak, korisno kada drugi sustav treba prikazati dosljedan izbor kartice.

HTTP akcija POST /vouchers/issue

Izdaj vaučer

Izdaje vaučer vlasniku kartice identificiranom na External ID ili User Card ID.

Potreban vaučer: .short_description. Ciljajte karticu s external_id ili poznatim user_card_id.
Valjanost: Koristite validity_type s validity_value ili pročitajte referencu OpenAPI za fiksni datum isteka.

HTTP akcija POST /messages/send

Pošalji poruku

Šalje sadržaj vlasniku kartice putem push-a novčanika-kartice i/or e-pošte, podložno konfiguriranom kanalu i pravilima pristanka.

Card push: card_push_text ograničen je na 20 znakova i zahtijeva instaliranu propusnicu novčanika.
E-pošta: Pošalji predmet i tijelo; osnovni HTML je podržan u tijelu.

Make modul Full 7stamp endpoint URL

HTTP → Make a request

Ovo je Make modul koji poziva svaku gornju rutu 7stamp. Koristite kompletan URL, odaberite dokumentiranu metodu, dodajte zaglavlje Bearer i koristite JSON samo kada ruta treba tijelo.

Baza URL: https://api.7loc.com/cards-api
Zaglavlje: Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json za POST zahtjeve.

Tri Make scenarija koja možete izgraditi točno onako kako je napisano

Imena ispod su pravi Make moduli. Započnite s prvim scenarijem, pokrenite ga s kontaktom za jednokratnu upotrebu i tek onda dodajte usmjerivače, filtre ili raspored proizvodnje.

1. Novi CRM kontakt → pošaljite vezu kartice 7stamp

Očekivani rezultat: Kupac prima install_url vraćen od 7stamp; vaš CRM može zadržati taj URL u istom kontaktu.

1 Napravite scenarij i dodajte svoj CRM's New/Created okidač kontakta. Za Kommo odaberite okidač za stvaranje kontakta i pokrenite ga jednom za učitavanje uzorka kontakta.
2 Dodajte HTTP → Make a request. Postavite Metodu na POST i URL na https://api.7loc.com/cards-api/cards/invite.
3 Dodajte Authorization: Bearer YOUR_7STAMP_API_KEY i Content-Type: application/json. U tijelu JSON, mapirajte kontakt CRM ID u external_id i postavite external_source na fiksnu oznaku kao što je kommo.
4 Pokrenite modul HTTP jednom. Potvrdite da izlaz ima install_url, delivery_insert_code, external_id i template_id.
5 Dodajte svoju e-poštu/SMS/CRM modul za ažuriranje nakon HTTP i mapirajte install_url iz izlaza HTTP. Spremite URL na kontaktu CRM ako ga tim mora ponovno poslati kasnije.

Označite: POST /cards/invite uvijek stvara novu pozivnicu. Prvo upotrijebite Find Cards ako je vaše poslovno pravilo izbjegavanje još jedne pozivnice za postojeći kontakt.

2. Plaćena narudžba → dodajte markice vjernosti

Očekivani rezultat: Uspješan odgovor skeniranja uključuje uspjeh, scan_id, stamps_added i stanje kartice nakon skeniranja za vaš sljedeći korak.

1 Počnite od okidača POS/ecommerce Paid Order. Make siguran da njegov uzorak sadrži stabilnog kupca ID i narudžbu/receipt ID.
2 Dodajte HTTP → Make a request s POST https://api.7loc.com/cards-api/cards/scan i istim zaglavljem Bearer.
3 Karta external_id od kupca, external_source od naziva sustava i external_order_id od narudžbe ID. Dodajte iznos za kartice na temelju iznosa ili stamps_count za izričit broj maraka.
4 Run once uz probnu narudžbu. Provjerite vraćenu oznaku uspjeha i stamps_added prije nego omogućite raspored scenarija.
5 Po želji dodajte filtar nakon koraka HTTP: nastavite tek kada je uspjeh istinit, a zatim upišite scan_id ili stamps_added natrag u zapis narudžbe/CRM.

Označite: Koristite isti external_order_id pri ponovnim pokušajima kako bi se redoslijed mogao pratiti u kasnijim događajima web-dojavnika; nemojte dodjeljivati markice dvaput nakon nejasnog neuspjelog izvođenja.

3. 7stamp događaj → ažuriraj CRM

Očekivani rezultat: Make odmah prima događaj 7stamp i može pronaći odgovarajući zapis CRM putem external_id i external_source.

1 Napravite zaseban scenarij Make. Dodajte Webhooks → Custom webhook, odaberite Dodaj, nazovite ga 7stamp-card-events i kopirajte generirani URL.
2 U 7stamp Admin otvorite API & Integrations → Webhooks. Dodajte to URL i odaberite mali skup događaja, na primjer SCAN i REWARD_EARNED.
3 Stvorite jednokratno probno skeniranje ili događaj kartice u 7stamp. Vratite se na Make i koristite Run once da dopustite Make da odredi strukturu podataka događaja.
4 Dodajte korak pretraživanja CRM pomoću external_id. Dodajte filtar ili usmjerivač na event_type kako bi SCAN, REWARD_EARNED i VOUCHER_ISSUED mogli poduzimati različite radnje.
5 Dodajte radnju CRM update/note. Karta scanned_at, stamps_after, external_order_id i issued_vouchers samo ako su ta polja prisutna za odabranu vrstu događaja.

Označite: Držite webhook URL privatnim. Testirajte stvarni događaj prije uključivanja nepovratnih poruka, vaučera ili CRM promjena.

Uzmite ključ 7stamp API prije otvaranja Make

Ovo su točno 7stamp Admin zasloni. Stvorite ključ jednom, kopirajte ga u sigurnu HTTP vezu/keychain Make, a zatim ga odmah uklonite iz međuspremnika.

7stamp Admin API & Integrations zaslon s popisom API Keys i Add API Key kontrolom — U 7stamp Admin otvorite API & Integrations, zatim **API Keys**, i odaberite **Add API Key**.

Novi dijalog ključa 7stamp API s vidljivom kontrolom kopiranja — Kopirajte ključ samo u sigurnu Make HTTP vezu/keychain. Tretirajte ga kao lozinku i rotirajte ga ako je izložen.

Pripremite vezu prije izgradnje

Kreirajte jedan ključ API po okruženju

U 7stamp Admin idite na API & Integrations → API Keys → Add API Key. Pohranite vrijednost u Make HTTP API-ključnoj vezi/keychain kada je ta opcija dostupna. Nikada nemojte mapirati ključ iz tekstualnog polja, stavljati ga u bilješku ili ga koristiti u tijeku rada u pregledniku. Ključ pripada jednom 7stamp radnom mjestu/profile.

Koristite stabilno External ID

Mapirajte nepromjenjivo ID iz vašeg CRM, POS ili trgovačka platforma—na primjer CRM kontakt ID ili kupac UUID. Dodajte External Source kao što je hubspot, shopify ili poster kada se isti identifikator može pojaviti u više od jednog sustava.

Odlučite koji se predložak primjenjuje

Kada povezani 7stamp profil ima jedan aktivni predložak kartice, Predložak se može ostaviti prazan. S višestrukim predlošcima, mapirajte ili odaberite template_id namjerno tako da svaka pozivnica i skeniranje dosegnu željeni program vjernosti.

Točna postavka Make HTTP: stvorite jednu pozivnicu za karticu

Kopirajte ovo u svoj korak automatizacije 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
}

Izgradite i testirajte svoj prvi scenarij Make

U 7stamp Admin, kreirajte ključ u API & Integrations → API Keys → Add API Key. Upotrijebite zaseban testni profil/key kada postavke vašeg računa to dopuštaju.

U Make kreirajte scenarij i dodajte izvorni okidač. Pokrenite ga jednom prije mapiranja kako biste mogli vidjeti pravi uzorak kontakta ili plaćene narudžbe.

Kliknite sljedeći plus, potražite HTTP i odaberite Make zahtjev. Postavite metodu, puni URL, i zaglavlja s kartice operacija na ovoj stranici.

Koristite GET https://api.7loc.com/cards-api/templates kao prvi zahtjev. Njegov uspješan odgovor dokazuje da ključ radi bez promjene podataka o klijentu.

Za rute POST odaberite application/json i zalijepite oblik tijela iz ovog vodiča. Mapirajte štalu External ID; dodajte template_id samo ako profil ima više aktivnih predložaka.

Pokrenite s kontaktom za jednokratnu upotrebu, pregledajte izlaz HTTP i tek onda preslikajte njegova točna polja odgovora u sljedeći modul CRM, e-pošte ili poruka.

Kada biste trebali koristiti Make HTTP?

Upotrijebite HTTP za 7stamp sada: to je dokumentirana ruta spremna za proizvodnju, a ne smanjena zamjena. Odaberite ga kad god trebate operaciju 7stamp, novu rutu API ili prilagođenu vezu POS/ERP. Referenca OpenAPI je izvor istine za metodu, puni put, tijelo i shemu odgovora; ključ nositelja i baza URL ostaju isti.

Primanje 7stamp događaja u Make

Za scenarij vođen događajima dodajte Webhooks → Custom webhook i izradite webhook. Kopirajte njegov URL, otvorite API & Integrations → Webhooks u profilu 7stamp, zalijepite URL, odaberite vrste događaja, spremite i pošaljite pravi probni događaj. Profil 7stamp posjeduje tu pretplatu; trenutni API ne izlaže krajnje točke automatske pretplate na webhook/unsubscribe.

Nije potreban javni Make konektor

Upute na ovoj stranici koriste Make module koji su dostupni svakom Make računu. Ako želite budući izvorni modul 7stamp umjesto HTTP, pošaljite nam tijek rada koji vam je potreban; do tada, HTTP i Custom webhook pokrivaju svaku dokumentiranu operaciju 7stamp.

Pitajte o izvornom konektoru

Često postavljana pitanja

Ne mogu pronaći 7stamp u Make. Mogu li ga ipak automatizirati?

Da. Danas ne postoji javna aplikacija 7stamp u Make. Dodajte HTTP > Make zahtjev, upotrijebite potpunu 7stamp krajnju točku URL i pošaljite Authorization: Bearer nakon čega slijedi vaš ključ 7stamp API. HTTP može nazvati svaku dokumentiranu krajnju točku.

Gdje mogu dobiti token za vezu Make?

U 7stamp Admin otvorite API Integracije, zatim API Keys, zatim Add API Key. Ključ je obuhvaćen radnim mjestom/profile koje ga je kreiralo, stoga koristite testni profil za testne scenarije kad god je to moguće.

Koji identifikator trebam mapirati kao External ID?

Koristite stabilni identifikator iz izvornog sustava, po mogućnosti CRM kontakt ID ili korisnik UUID. Nemojte koristiti ime za prikaz. Telefonski broj ili e-mail mogu funkcionirati, ali se mogu promijeniti i s njima treba postupati dosljedno.

Kako mogu staviti 7stamp događaja u Make?

Stvorite Webhooks > Custom webhook u Make, zatim zalijepite generirani URL u postavke webhooka profila 7stamp. Koristite Make filtar ili usmjerivač nakon isporuke za rukovanje dolaznim event_type.

Povezane stranice

Otvori Make Make HTTP pomoć Make Custom webhook pomoć 7stamp API referenca Postavljanje Webhooka Zapier vodič

Sljedeći korak

Jeste li spremni automatizirati prvu akciju vjernosti?

Izradite ključ API, testirajte List Templates i izradite jedan poziv ili scenarij skeniranja s jednokratnim kontaktom. Dodajte usmjerivače i slanje poruka tek nakon što taj jednostavan tijek postane pouzdan.

Otvorite 7stamp Admin Pročitajte API referencu