Ustvarite kartico po novem stiku CRM
Uporabite stik CRM ID kot External ID, ustvarite povabilo kartice 7stamp in nato pošljite vrnjeno namestitev URL prek vašega običajnega e-poštnega sporočila, SMS ali koraka sporočila.
Vodnik za avtomatizacijo brez kode
Povežite 7stamp z Make — korak za korakom
Vodnik za implementacijoUporabite Make za povezavo 7stamp s CRM, POS, spletno trgovino, preglednico, orodjem za sporočanje ali katerim koli sistemom, ki lahko pošilja podatke v scenarij. Današnja pot, pripravljena za produkcijo, je aplikacija HTTP za Make za klice 7stamp API in Custom webhook za dohodne dogodke 7stamp za Make.
V izbirniku aplikacij Make še ni javne aplikacije 7stamp. Ne čakajte na enega: dodajte HTTP → Make a request, uporabite natančno URL, metodo, Bearer glavo in JSON spodaj, nato preslikajte polja iz vašega izvornega modula. To je isti 7stamp Integration API, ki bi ga uporabljal prihodnji konektor.
Izberite prvi scenarij, ki se ujema z vašim potekom dela
Začnite z enim dogodkom in enim rezultatom. Ko so testni podatki pravilni, dodajte filtre, usmerjevalnike, posodobitve CRM in nadaljnja sporočila okoli njih.
Dodajte žige po plačanem naročilu
Sprožite scenarij iz plačanega POS ali naročila v e-trgovini. Preslikajte njegovo stabilno stranko ID in naročite ID v Scan a Card, nato pa uporabite znesek ali izrecno število znamk.
Pošljite nadaljnje obvestilo o nagradi
Ko dogodek s kartico poroča o nagradi ali kuponu, razvejajte scenarij: posodobite CRM, obvestite ekipo in pošljite potisno sporočilo kartice denarnice ali e-pošto le, ko je to potrebno.
Upravljajte s sistemom brez izvorne aplikacije Make
Uporabite modul HTTP Make za neposreden klic 7stamp. To je univerzalna izbira za POS, ERP, mehanizem za rezervacije ali katero koli prvo storitev API.
7stamp operacije za klic iz Make HTTP
Za vsako kartico spodaj dodajte HTTP → Make a request, nato nastavite metodo in URL točno tako, kot je prikazano. Za vsako zahtevo uporabite isti ključ Bearer. Zahtevana preslikava vam pove, kaj morate zagotoviti iz sprožilca CRM, POS ali e-trgovine.
Make sprožilec
Webhooks → Custom webhook Prejmite dogodek kartice
Ustvarite Custom webhook v Make, kopirajte njegov URL in nato prilepite ta URL v nastavitve webhook profila 7stamp. To zažene scenarij, ko 7stamp pošlje dogodek, kot je SCAN, REWARD_EARNED ali VOUCHER_ISSUED.
- V Make
- Webhooks → Custom webhook → Dodaj; dajte mu jasno ime in kopirajte ustvarjeno URL.
- V 7stamp
- Admin → API & Integrations → Webhooks; prilepite URL, izberite vrste dogodkov, shranite in nato ustvarite preizkusni dogodek.
HTTP
POST /cards/invite Ustvari dejanje Card Invite
Ustvari novo osebno namestitev URL in kodo za vstavljanje dostave za en zunanji stik.
- Zahtevano
- external_id — preslikajte svoj hlev CRM/contact ID, ne ime.
- Nato uporabite
- Preslikaj install_url iz odgovora v vaš e-poštni naslov, SMS ali korak posodobitve CRM.
HTTP dejanje
POST /cards/invite/bulk Množično ustvarjanje Card Invites
Ustvari do 100 povezav s povabilom v eni zahtevi. Uporabite ga za nadzorovano selitev ali kampanjo, ne za neomejen izvoz stikov.
- Zahtevanih
- elementov — JSON niz 1–100 posameznih objektov zahteve za povabilo.
- Označite
- Preberite success_count, error_count in vsak rezultat, preden pošljete povezave.
HTTP dejanje
GET /cards Find Cards
Najde zapise kartic po External ID z izbirno predlogo in izvornimi filtri.
- Zahtevano
- Poizvedbeni parameter external_id.
- Izbirno
- external_source in template_id zožita iskanje, ko ima en sistem več programov.
HTTP dejanje
GET /cards/{user_card_id} Pridobite podrobnosti kartice
Prebere celotno stanje ene kartice, ko je prejšnji korak vrnil njen notranji User Card ID.
- Zahtevano
- Zamenjajte {user_card_id} z notranjim ID, ki ga vrne zaupanja vreden odgovor 7stamp.
- Izogibajte se
- Ne ugibajte in ne shranjujte kartice ID iz drugega profila.
HTTP dejanje
POST /cards/scan Skeniraj kartico
Doda žige iz zneska nakupa ali izrecnega števila. Sprejema User Card ID ali External ID in lahko obdrži zunanjo referenco naročila.
- Identiteta
- Uporabite external_id in neobvezno external_source; user_card_id zmaga, če sta dobavljena oba.
- Nakup
- Uporabite znesek za kartice, ki temeljijo na znesku, ali stamps_count za izrecno številko; stamps_count ima prednost.
- Sledljivost
- Preslikava external_order_id iz plačanega naročila /receipt, da se lahko dogodki 7stamp primerjajo nazaj.
HTTP dejanje
GET /templates List Templates
Navaja predloge kartic, ki so na voljo za ključ API. Uporabite ga za preizkus povezave ali za dinamično izbiro predloge.
- Prvi test
- To je najvarnejša prva zahteva: nima telesa in ne spreminja podatkov o strankah.
- Preslikaj pozneje
- ID aktivne predloge uporabite kot template_id samo, če ima profil več kot eno aktivno predlogo.
HTTP dejanje
GET /templates/{template_id}/design Get Template Design
Vrne nastavitve vizualnega oblikovanja za znano predlogo, uporabno, ko mora drug sistem prikazati dosledno izbiro kartice.
HTTP dejanje
POST /vouchers/issue Izdaj kupon
Izda kupon lastniku kartice, identificiranem z External ID ali User Card ID.
- Potreben kupon
- .short_description. Ciljajte na kartico z external_id ali znanim user_card_id.
- Veljavnost
- Uporabite validity_type z validity_value ali preberite referenco OpenAPI za fiksni datum poteka.
HTTP dejanje
POST /messages/send Pošlji sporočilo
Pošlje vsebino lastniku kartice prek potiskanja denarnice in /or e-pošte, v skladu s konfiguriranim kanalom in pravili o soglasju.
- Card push
- card_push_text je omejen na 20 znakov in zahteva nameščeno prepustnico denarnice.
- E-pošta
- Pošlji zadevo in telo; osnovni HTML je podprt v telesu.
Make modul
Full 7stamp endpoint URL HTTP → Make a request
To je modul Make, ki kliče vsako zgornjo pot 7stamp. Uporabite celoten URL, izberite dokumentirano metodo, dodajte glavo Bearer in uporabite JSON samo, če pot potrebuje telo.
- Osnova URL
- https://api.7loc.com/cards-api
- Glava
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json za zahteve POST.
Trije scenariji Make, ki jih lahko sestavite točno tako, kot je napisano
Spodnja imena so pravi moduli Make. Začnite s prvim scenarijem, ga zaženite s stikom za enkratno uporabo in šele nato dodajte usmerjevalnike, filtre ali načrtovanje proizvodnje.
1. Nov kontakt CRM → pošlji povezavo do kartice 7stamp
Pričakovani rezultat: Stranka prejme install_url vrnjeno od 7stamp; vaš CRM lahko obdrži to URL v istem zapisu stikov.
- 1 Ustvarite scenarij in dodajte svoj sprožilec novega stika CRM/Created. Za Kommo izberite sprožilec za ustvarjanje stika in ga enkrat zaženite, da naložite vzorčni stik.
- 2 Dodajte HTTP → Make a request. Nastavite metodo na POST in URL na https://api.7loc.com/cards-api/cards/invite.
- 3 Dodajte Authorization: Bearer YOUR_7STAMP_API_KEY in Content-Type: application/json. V telesu JSON preslikajte stik CRM ID v external_id in nastavite external_source na fiksno oznako, kot je kommo.
- 4 Enkrat zaženite modul HTTP. Potrdite, da ima izhod install_url, delivery_insert_code, external_id in template_id.
- 5 Dodajte modul za posodobitev e-pošte/SMS/CRM za HTTP in preslikajte install_url iz izhoda HTTP. Shranite URL na kontakt CRM, če ga bo morala ekipa znova poslati pozneje.
Označite: POST /cards/invite vedno ustvari novo povabilo. Najprej uporabite Find Cards, če je vaše poslovno pravilo izogibanje še enemu povabilu za obstoječi stik.
2. Plačano naročilo → dodajte žige zvestobe
Pričakovani rezultat: Uspešen odziv na skeniranje vključuje uspeh, scan_id, stamps_added in stanje kartice po skeniranju za vaš naslednji korak.
- 1 Začnite s sprožilcem Plačano naročilo POS/ecommerce. Make prepričan, da njegov vzorec vsebuje stabilno stranko ID in naročilo /receipt ID.
- 2 Dodajte HTTP → Make a request z POST https://api.7loc.com/cards-api/cards/scan in enako glavo Bearer.
- 3 Preslikava external_id od stranke, external_source iz imena sistema in external_order_id iz naročila ID. Dodajte znesek za kartice, ki temeljijo na znesku, ali stamps_count za jasno določeno število znamk.
- 4 Run once s testnim naročilom. Preverite vrnjeno zastavico za uspeh in stamps_added, preden omogočite urnik scenarija.
- 5 Po želji dodajte filter po koraku HTTP: nadaljujte šele, ko je uspeh resničen, nato zapišite scan_id ali stamps_added nazaj v zapis naročila/CRM.
Označite: Uporabite isto external_order_id pri ponovnih poskusih, tako da je vrstni red mogoče izslediti v kasnejših dogodkih webhook; ne podeljujte žigov dvakrat po nejasni neuspešni vožnji.
3. 7stamp dogodek → posodobi CRM
Pričakovani rezultat: Make takoj prejme dogodek 7stamp in lahko najde ustrezni zapis CRM prek external_id in external_source.
- 1 Ustvarite ločen scenarij Make. Dodajte Webhooks → Custom webhook, izberite Dodaj, poimenujte 7stamp-card-events in kopirajte ustvarjeni URL.
- 2 V 7stamp Admin odprite API & Integrations → Webhooks. Dodajte to URL in izberite majhen niz dogodkov, na primer SCAN in REWARD_EARNED.
- 3 Ustvarite poskusno skeniranje ali dogodek kartice za enkratno uporabo v 7stamp. Vrnite se na Make in uporabite Run once, da Make določi strukturo podatkov o dogodku.
- 4 Dodajte iskalni korak CRM z uporabo external_id. Dodajte filter ali usmerjevalnik na event_type, da lahko SCAN, REWARD_EARNED in VOUCHER_ISSUED izvajajo različna dejanja.
- 5 Dodajte dejanje CRM posodobitev/note. Preslikava scanned_at, stamps_after, external_order_id in issued_vouchers samo, če so ta polja prisotna za izbrano vrsto dogodka.
Označite: Webhook URL naj bo zaseben. Preizkusite resničen dogodek, preden vklopite nepreklicna sporočila, bone ali spremembe CRM.
Pridobite ključ 7stamp API, preden odprete Make
To so točno tisti zasloni 7stamp Admin. Enkrat ustvarite ključ, ga kopirajte v varno povezavo HTTP/keychain Make in ga takoj odstranite iz odložišča. Zaslon
Pripravite povezavo pred gradnjo
Ustvarite en ključ API na okolje
V 7stamp Admin pojdite na API & Integrations → API Keys → Add API Key. Shranite vrednost v povezavo s ključem Make HTTP API/keychain, ko je ta možnost na voljo. Nikoli ne preslikajte ključa iz besedilnega polja, ga ne postavite v opombo ali ga uporabite v poteku dela v brskalniku. Ključ pripada enemu 7stamp delovnem mestu/profile.
Uporabite stabilno External ID
Preslikajte nespremenljivo ID iz vašega CRM, POS ali trgovine platforma—na primer kontakt CRM ID ali stranka UUID. Dodajte External Source, kot je hubspot, shopify ali poster, ko se isti identifikator lahko pojavi v več kot enem sistemu.
Odločite se, katera predloga velja.
Ko ima povezani profil 7stamp eno aktivno predlogo kartice, lahko predlogo pustite prazno. Z več predlogami namerno preslikajte ali izberite template_id, tako da vsako povabilo in skeniranje doseže predvideni program zvestobe.
Natančna nastavitev Make HTTP: ustvarite eno povabilo za kartico
Kopirajte to v svoj korak avtomatizacije
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
}Zgradite in preizkusite svoj prvi scenarij Make
V 7stamp Admin ustvarite ključ v API & Integrations → API Keys → Add API Key. Uporabite ločen testni profil/key, če to omogoča nastavitev vašega računa.
V Make ustvarite scenarij in dodajte izvorni sprožilec. Zaženite ga enkrat pred preslikavo, da boste lahko videli pravi vzorec stika ali plačanega naročila.
Kliknite naslednji plus, poiščite HTTP in izberite Make zahtevo. Nastavite metodo, polno URL, in glave iz operacijske kartice na tej strani.
Uporabi GET https://api.7loc.com/cards-api/templates kot prvo zahtevo. Njegov uspešen odziv dokazuje, da ključ deluje brez spreminjanja podatkov o strankah.
Za poti POST izberite application/json in prilepite obliko telesa iz tega vodnika. Zemljevid hleva External ID; dodajte template_id le, če ima profil več aktivnih predlog.
Zaženite s kontaktom za enkratno uporabo, preglejte izhod HTTP in šele nato preslikajte njegova natančna odgovorna polja v naslednji modul CRM, e-pošto ali sporočila.
Kdaj uporabiti Make HTTP?
Zdaj uporabite HTTP za 7stamp: to je dokumentirana pot, pripravljena za proizvodnjo, ne zmanjšana nadomestna možnost. Izberite ga, kadar koli potrebujete operacijo 7stamp, novo pot API ali povezavo POS/ERP po meri. Referenca OpenAPI je vir resnice za metodo, celotno pot, telo in odzivno shemo; nosilni ključ in osnova URL ostaneta enaka.
Prejemanje 7stamp dogodkov v Make
Za scenarij, ki temelji na dogodkih, dodajte Webhooks → Custom webhook in ustvarite webhook. Kopirajte njegov URL, odprite API & Integrations → Webhooks v profilu 7stamp, prilepite URL, izberite vrste dogodkov, shranite in pošljite pravi preizkusni dogodek. Profil 7stamp je lastnik te naročnine; trenutni API ne izpostavlja končnih točk samodejne naročnine na webhook/unsubscribe.
Javni priključek Make ni potreben
Navodila na tej strani uporabljajo module Make, ki so na voljo za vsak račun Make. Če želite prihodnji izvorni modul 7stamp namesto HTTP, nam pošljite potek dela, ki ga potrebujete; do takrat HTTP in Custom webhooks pokrivata vsako dokumentirano operacijo 7stamp.
Pogosto zastavljena vprašanja
Ne najdem 7stamp v Make. Ali ga lahko vseeno avtomatiziram?
Da. Danes v Make ni javne aplikacije 7stamp. Dodajte HTTP > Make zahtevo, uporabite celotno končno točko 7stamp URL in pošljite Authorization: Bearer, ki mu sledi vaš ključ 7stamp API. HTTP lahko kliče vsako dokumentirano končno točko.
Kje dobim žeton za povezavo Make?
V 7stamp Admin odprite API Integracije, nato API Keys in nato Add API Key. Ključ je omejen na delovno mesto/profile, ki ga je ustvarilo, zato uporabite testni profil za testne scenarije, kadar koli je to mogoče.
Kateri identifikator naj preslikam kot External ID?
Uporabite stabilni identifikator iz izvornega sistema, po možnosti kontakt CRM ID ali stranko UUID. Ne uporabljajte prikaznega imena. Telefonska številka ali e-pošta lahko delujeta, vendar se lahko spremenita in z njo je treba ravnati dosledno.
Kako spravim dogodke 7stamp v Make?
Ustvarite Webhooks > Custom webhook v Make, nato prilepite ustvarjeni URL v nastavitve webhooka profila 7stamp. Po dostavi uporabite filter Make ali usmerjevalnik za obdelavo dohodnega event_type.
Naslednji korak
Ste pripravljeni avtomatizirati prvo akcijo zvestobe?
Ustvarite ključ API, preizkusite List Templates in ustvarite en scenarij povabila ali skeniranja s kontaktom za enkratno uporabo. Dodajte usmerjevalnike in sporočanje šele, ko je ta preprost tok zanesljiv.