Vytvorte kartu po novom kontakte CRM
Použite kontakt CRM ID ako External ID, vytvorte pozvánku na kartu 7stamp a potom odošlite vrátenú inštaláciu URL prostredníctvom svojho obvyklého e-mailu SMS alebo prostredníctvom správy.
Sprievodca automatizáciou bez kódu
Pripojte 7stamp k Make — krok za krokom
Sprievodca implementáciouPoužite Make na prepojenie 7stamp s CRM, POS, online obchodom, tabuľkovým procesorom, nástrojom na odosielanie správ alebo akýmkoľvek systémom, ktorý dokáže odosielať dáta do scenára. Dnešná trasa pripravená na výrobu je aplikácia HTTP HTTP pre 7stamp API hovory a Make Custom webhook pre prichádzajúce 7stamp udalosti.
There is no public 7stamp app in Make's app picker yet. Nečakajte na jedno: pridajte HTTP → Make a request, použite presnú metódu URL, hlavičku Bearer a JSON nižšie a potom namapujte polia zo zdrojového modulu. Toto je to isté 7stamp Integration API, ktoré by použil budúci konektor.
Vyberte prvý scenár, ktorý zodpovedá vášmu pracovnému postupu
Začnite jednou udalosťou a jedným výsledkom. Keď sú testovacie údaje správne, pridajte k nim filtre, smerovače, aktualizácie CRM a následné správy.
Známky pridajte po zaplatenej objednávke
Spustite scenár z platenej POS alebo objednávky elektronického obchodu. Namapujte svojho stabilného zákazníka ID a objednajte si ID do Skenovať kartu, potom použite sumu alebo explicitný počet známok.
Pošlite správu o odmene
Keď udalosť s kartou ohlási odmenu alebo poukaz, rozviňte scenár: aktualizujte CRM, upozornite tím a pošlite e-mailovú kartu alebo e-mail do peňaženky iba v prípade potreby.
Ovládanie systému bez natívnej aplikácie Make
Použite modul Make HTTP na priame volanie 7stamp. Toto je univerzálna voľba pre vlastnú službu POS, ERP, rezervačný systém alebo akúkoľvek prvú službu API.
7stamp operácie na volanie z Make HTTP
Pre každú kartu nižšie pridajte HTTP → Make a request, potom nastavte metódu a URL presne podľa obrázka. Pre každú požiadavku použite rovnaký kľúč Bearer. Požadované mapovanie vám povie, čo máte dodať zo spúšťača CRM, POS alebo elektronického obchodu.
Spúšťač Make
Webhooks → Custom webhook Prijať udalosť karty
Vytvorte Custom webhook v Make, skopírujte jeho URL, potom vložte toto URL do nastavení webhook profilu 7stamp. Toto spustí scenár, keď 7stamp odošle udalosť ako SCAN, REWARD_EARNED alebo VOUCHER_ISSUED.
- V Make
- Webhooks → Custom webhook → Pridať; dajte mu jasný názov a skopírujte jeho vygenerované URL.
- V 7stamp
- Správca → API & Integrations → Webhooks; prilepte URL, vyberte typy udalostí, uložte a potom vytvorte testovaciu udalosť.
HTTP
POST /cards/invite Vytvoriť akciu Card Invite
Vytvorí novú osobnú inštaláciu URL a kód na vloženie doručenia pre jeden externý kontakt.
- Povinné
- external_id — zmapujte svoju stajňu CRM/contact ID, nie meno.
- Potom použite
- Mapa install_url z odpovede do vášho e-mailu, SMS alebo CRM krok aktualizácie.
HTTP akcia
POST /cards/invite/bulk Hromadné vytváranie Card Invites
Vytvorí až 100 pozývacích odkazov v jednej žiadosti. Použite ho na kontrolovanú migráciu alebo kampaň, nie na neobmedzený export kontaktov.
- Povinné položky
- — pole JSON 1–100 jednotlivých objektov žiadosti o pozvanie.
- Skontrolujte
- Prečítajte si success_count, error_count a každý výsledok pred odoslaním akýchkoľvek odkazov.
HTTP akcia
GET /cards Find Cards
Nájde záznamy kariet podľa External ID s voliteľnou šablónou a zdrojovými filtrami.
- Povinné
- Parameter dopytu external_id.
- Voliteľné
- external_source a template_id zúžia vyhľadávanie, keď má jeden systém viacero programov.
HTTP akcia
GET /cards/{user_card_id} Získajte detail karty
Prečíta celý stav jednej karty, keď predchádzajúci krok vrátil jej interné User Card ID.
- Povinné
- Nahraďte {user_card_id} internou ID vrátenou dôveryhodnou odpoveďou 7stamp.
- Vyhnite sa
- Nehádajte ani neukladajte kartu ID z iného profilu.
HTTP akcia
POST /cards/scan Naskenovať kartu
Pridá známky zo sumy nákupu alebo explicitného počtu. Prijíma User Card ID alebo External ID a môže si ponechať referenciu externej objednávky.
- Identita
- Použite external_id a voliteľné external_source; user_card_id vyhráva, ak sú dodané oboje.
- Nákup
- Použite čiastku pre karty založené na sume alebo stamps_count pre explicitné číslo; stamps_count má prednosť.
- Sledovateľnosť
- Mapa external_order_id zo zaplatenej objednávky/receipt, takže 7stamp udalostí je možné spätne spárovať.
HTTP akcia
GET /templates List Templates
Zobrazí zoznam šablón kariet dostupných pre kláves API. Použite ho na testovanie pripojenia alebo na dynamický výber šablóny.
- Prvý test
- Toto je najbezpečnejšia prvá požiadavka: nemá telo a nemení údaje zákazníka.
- Mapovať neskôr
- Použite ID aktívnej šablóny ako template_id iba vtedy, ak má profil viac ako jednu aktívnu šablónu.
HTTP akcia
GET /templates/{template_id}/design Get Template Design
Vráti nastavenia vizuálneho dizajnu pre známu šablónu, čo je užitočné, keď iný systém potrebuje zobraziť konzistentný výber kariet.
HTTP akcia
POST /vouchers/issue Vydanie poukážky
Vydá poukážku majiteľovi karty identifikovanému External ID alebo User Card ID.
- Požadovaný kupón
- .short_description. Zacieľte kartu pomocou external_id alebo známeho user_card_id.
- Platnosť
- Použite validity_type s validity_value alebo si prečítajte referenciu OpenAPI pre pevný dátum vypršania platnosti.
HTTP akcia
POST /messages/send Odoslať správu
Odošle obsah majiteľovi karty prostredníctvom aplikácie Wallet-card push a /or e-mailu, v súlade s nakonfigurovaným kanálom a pravidlami súhlasu.
- Zatlačenie karty
- card_push_text je obmedzené na 20 znakov a vyžaduje si nainštalovanú peňaženku.
- Odoslať predmet plus telo; základná HTML je podporovaná v tele.
Make modul
Full 7stamp endpoint URL HTTP → Make a request
Toto je modul Make, ktorý volá každú 7stamp vyššie uvedenú trasu. Použite úplné URL, vyberte zdokumentovanú metódu, pridajte hlavičku Bearer a použite JSON len vtedy, keď trasa potrebuje telo.
- Základ URL
- https://api.7loc.com/cards-api
- Hlavička
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json pre POST žiadostí.
Tri scenáre Make, ktoré môžete zostaviť presne tak, ako sú napísané
Nižšie uvedené názvy sú skutočné moduly Make. Začnite s prvým scenárom, spustite ho proti jednorazovému kontaktu a až potom pridajte smerovače, filtre alebo plánovanie výroby.
1. Nový kontakt CRM → pošlite odkaz na kartu 7stamp
Očakávaný výsledok: Zákazník dostane install_url vrátené 7stamp; váš CRM môže ponechať toto URL v rovnakom zázname kontaktu.
- 1 Vytvorte scenár a pridajte spúšťač kontaktu CRM New/Created. Pre Kommo vyberte spúšťač vytvorenia kontaktu a spustite ho raz, aby sa načítal vzorový kontakt.
- 2 Pridajte HTTP → Make a request. Nastavte metódu na POST a URL na https://api.7loc.com/cards-api/cards/invite.
- 3 Pridajte Authorization: Bearer YOUR_7STAMP_⟧_4421 ⟦ application/json. V tele JSON namapujte kontakt CRM ID na external_id a nastavte external_source na pevný štítok, napríklad kommo.
- 4 Spustite modul HTTP raz. Potvrďte, že výstup má install_url, delivery_insert_code, external_id a template_id.
- 5 Pridajte svoj e-mail/SMS/CRM aktualizačný modul za HTTP a zmapujte install_url z výstupu HTTP. Uložte URL na kontakt CRM, ak ho tím bude musieť znova odoslať neskôr.
Skontrolujte: POST /cards/invite vždy vytvorí novú pozvánku. Najprv použite Find Cards, ak je vaším obchodným pravidlom vyhnúť sa ďalšej pozvánke pre existujúci kontakt.
2. Platená objednávka → pridať vernostné známky
Očakávaný výsledok: Úspešná odpoveď na skenovanie zahŕňa úspech, scan_id, stamps_added a stav karty po naskenovaní pre váš ďalší krok.
- 1 Začnite od spúšťača platenej objednávky POS/ecommerce. Make si istý, že jeho vzorka obsahuje stabilného zákazníka ID a objednávka/receipt ID.
- 2 Pridajte HTTP → Make a request s POST https://api.7loc.com/cards-api/cards/scan a rovnakú hlavičku Bearer.
- 3 Mapa external_id od zákazníka, external_source z názvu systému a external_order_id z objednávky ID. Pridajte sumu pre karty založené na sume alebo stamps_count pre explicitný počet pečiatok.
- 4 Run once s testovacou objednávkou. Pred povolením plánu scenára skontrolujte vrátený príznak úspechu a stamps_added.
- 5 Voliteľne pridajte filter po kroku HTTP: pokračujte len vtedy, keď je úspech pravdivý, potom napíšte scan_id alebo stamps_added späť do záznamu objednávky/CRM.
Skontrolujte: Použite to isté external_order_id pri opakovaných pokusoch, aby bolo možné objednávku vysledovať v neskorších udalostiach webhooku; neudeľujte známky dvakrát po nejasnom neúspešnom behu.
3. Udalosť 7stamp → aktualizujte udalosť CRM
Očakávaný výsledok: Make okamžite prijme udalosť 7stamp a môže nájsť zodpovedajúci záznam ⟧4470⦦ external_source.
- 1 Vytvorte samostatný scenár Make. Pridajte Webhooks → Custom webhook, vyberte Pridať, pomenujte to 7stamp-card-events a skopírujte vygenerované URL.
- 2 V 7stamp Admin otvorte API & Integrations → Webhooks. Pridajte to URL a vyberte malú skupinu udalostí, napríklad SCAN a REWARD_EARNED.
- 3 Vytvorte jednorazové testovacie skenovanie alebo udalosť karty v 7stamp. Vráťte sa na Make a pomocou Run once nechajte Make určiť dátovú štruktúru udalosti.
- 4 Pridajte krok vyhľadávania CRM pomocou external_id. Pridajte filter alebo smerovač na event_type, aby SCAN, REWARD_EARNED a VOUCHER_ISSUED mohli vykonávať rôzne akcie.
- 5 Pridajte akciu CRM update/note. Mapovať scanned_at, stamps_after, external_order_id a issued_vouchers len vtedy, keď sú tieto polia prítomné pre vybraný typ udalosti.
Skontrolujte: Udržujte webhook URL súkromný. Pred zapnutím nevratných správ, poukážok alebo zmien CRM otestujte skutočnú udalosť.
Získajte kľúč 7stamp API pred otvorením Make
Toto sú presné obrazovky 7stamp Admin. Vytvorte kľúč raz, skopírujte ho do zabezpečeného pripojenia HTTP/keychain Make a potom ho okamžite odstráňte zo schránky.
Pripravte pripojenie pred budovaním
Vytvorte jeden kľúč API na prostredie
V 7stamp Admin prejdite na API & Integrations → API Keys → Add API Key. Uložte hodnotu do spojenia kľúča Make HTTP API/keychain, keď je táto možnosť dostupná. Nikdy nemapujte kľúč z textového poľa, neumiestňujte ho do poznámky ani ho nepoužívajte v pracovnom postupe v prehliadači. Kľúč patrí k jednému 7stamp pracovisku/profile.
Použite stabilnú External ID
Mapujte nemennú ID z vašej platformy ⟧4376⟧, napríklad ⟧4376⟧ alebo ⦟7⟧. CRM kontakt ID alebo zákazník UUID. Pridajte External Source, ako napríklad hubspot, shopify alebo plagát, ak sa rovnaký identifikátor môže objaviť vo viac ako jednom systéme.
Rozhodnite sa, ktorá šablóna sa použije
Keď má pripojený profil 7stamp jednu aktívnu šablónu karty, Šablóna môže zostať prázdna. S viacerými šablónami namapujte alebo vyberte template_id zámerne, aby každá pozvánka a skenovanie dosiahli zamýšľaný vernostný program.
Presné nastavenie Make HTTP: vytvorte jednu pozvánku na kartu
Skopírujte to do svojho kroku automatizácie
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
}Zostavte a otestujte svoj prvý scenár Make
V 7stamp Admin vytvorte kľúč v ⟦4503 ⟦4503. Ak to nastavenie účtu umožňuje, použite samostatný testovací profil/key.
V Make vytvorte scenár a pridajte zdrojový spúšťač. Spustite ho raz pred mapovaním, aby ste videli skutočný vzorový kontakt alebo zaplatenú objednávku.
Kliknite na ďalšie plus, vyhľadajte HTTP a vyberte Make požiadavku. Nastavte metódu, úplné URL, a hlavičky z karty prevádzky na tejto stránke.
Ako prvú požiadavku použite GET https://api.7loc.com/cards-api/templates. Jeho úspešná odozva dokazuje, že kľúč funguje bez zmeny akýchkoľvek údajov o zákazníkoch.
Pre trasy POST vyberte application/json a vložte tvar tela z tohto sprievodcu. Mapujte stajňu External ID; pridajte template_id iba vtedy, ak má profil viacero aktívnych šablón.
Spustite s kontaktom na jedno použitie, skontrolujte výstup HTTP a až potom namapujte jeho presné polia odpovedí do ďalšieho CRM, e-mailu alebo modulu správ.
Kedy by ste mali použiť Make HTTP?
Teraz použite HTTP pre 7stamp: je to zdokumentovaná cesta pripravená na výrobu, nie znížená núdzová situácia. Vyberte si ho vždy, keď potrebujete operáciu 7stamp, novú trasu API alebo vlastné pripojenie POS/ERP. Referencia OpenAPI je zdrojom pravdy pre metódu, úplnú cestu, telo a schému odozvy; nosný kľúč a základňa URL zostávajú rovnaké.
Príjem 7stamp udalostí v Make
Pre scenár riadený udalosťami pridajte Webhooks → Custom webhook a vytvorte webhook. Skopírujte jeho URL, otvorte API & Integrations → Webhooks v profile 7stamp, vložte URL, vyberte typy udalostí, uložte a odošlite skutočnú testovaciu udalosť. Profil 7stamp vlastní toto predplatné; aktuálny API nevystavuje automatické koncové body odberu webhooku/unsubscribe.
Nevyžaduje sa žiadny verejný konektor Make
Pokyny na tejto stránke používajú moduly Make, ktoré sú dostupné pre každý účet Make. Ak chcete budúci natívny modul 7stamp namiesto HTTP, pošlite nám pracovný postup, ktorý potrebujete; dovtedy HTTP a Custom webhook pokrývajú každú zdokumentovanú operáciu 7stamp.
Často kladené otázky
Nemôžem nájsť 7stamp v Make. Môžem to ešte zautomatizovať?
Áno. V Make dnes nie je žiadna verejná aplikácia 7stamp. Pridajte požiadavku HTTP > Make, použite úplný koncový bod 7stamp URL a pošlite Authorization: Bearer nasledovaný kľúčom 7stamp API. HTTP môže volať každý zdokumentovaný koncový bod.
Kde získam token pre pripojenie Make?
V 7stamp Admin otvorte API Integrations, potom API Keys, potom Add API Key. Kľúč sa vzťahuje na pracovisko/profile, ktoré ho vytvorilo, takže vždy, keď je to možné, použite testovací profil pre testovacie scenáre.
Ktorý identifikátor mám namapovať ako External ID?
Použite stabilný identifikátor zo zdrojového systému, najlepšie CRM kontakt ID alebo zákazníka UUID. Nepoužívajte zobrazovaný názov. Telefónne číslo alebo e-mail môžu fungovať, ale môžu sa meniť a malo by sa s nimi zaobchádzať dôsledne.
Ako dostanem 7stamp udalosti do Make?
Vytvorte webhooky > Custom webhook v Make, potom vložte jeho vygenerovaný URL do nastavení webhooku profilu 7stamp. Po doručení použite filter Make alebo smerovač na spracovanie prichádzajúcich event_type.
Ďalší krok
Ste pripravení zautomatizovať prvú vernostnú akciu?
Vytvorte kľúč API, otestujte List Templates a vytvorte jeden scenár pozvánky alebo skenovania s kontaktom na jedno použitie. Pridajte smerovače a správy až potom, čo bude tento jednoduchý tok spoľahlivý.