Vytvořte kartu po novém kontaktu CRM
Použijte CRM kontakt ID jako External ID, vytvořte pozvánku na kartu 7stamp a poté odešlete vrácenou instalaci URL prostřednictvím svého obvyklého e-mailu, SMS, nebo pomocí zprávy.
Průvodce automatizací bez kódu
Připojte 7stamp k Make — krok za krokem
Průvodce implementacíPomocí Make propojte 7stamp s CRM, POS, online obchodem, tabulkovým procesorem, nástrojem pro zasílání zpráv nebo jakýmkoli systémem, který může odesílat data do scénáře. Dnešní produkční trasa je aplikace Make HTTP pro 7stamp API volání a Make Custom webhook pro příchozí 7stamp události.
Ve výběru aplikací Make zatím není žádná veřejná aplikace 7stamp. Nečekejte na jedno: přidejte HTTP → Make a request, použijte přesnou metodu URL, hlavičku Bearer a JSON níže a poté namapujte pole ze zdrojového modulu. Toto je stejné 7stamp Integration API, které by použil budoucí konektor.
Vyberte první scénář, který odpovídá vašemu pracovnímu postupu
Začněte jednou událostí a jedním výsledkem. Jakmile jsou testovací data správná, přidejte kolem nich filtry, routery, aktualizace CRM a následné zprávy.
Přidejte razítka po zaplacené objednávce
Spusťte scénář z placené POS nebo objednávky elektronického obchodu. Namapujte svého stabilního zákazníka ID a objednejte ID do Skenování karty, poté použijte částku nebo explicitní počet známek.
Odešlete zprávu o odměně
Když událost s kartou oznámí odměnu nebo poukaz, větvete scénář: aktualizujte CRM, upozorněte tým a pošlete peněženku nebo e-mail pouze v případě potřeby.
Správa systému bez nativní aplikace Make
Použijte modul Make HTTP k přímému volání 7stamp. Toto je univerzální volba pro vlastní POS, ERP, rezervační systém nebo jakoukoli první službu API.
7stamp operace pro volání z Make HTTP
Ke každé níže uvedené kartě přidejte HTTP → Make a request, poté nastavte metodu a URL přesně podle obrázku. Pro každý požadavek použijte stejný klíč Bearer. Požadované mapování vám řekne, co máte dodat ze spouštěče CRM, POS nebo elektronického obchodu.
Spouštěč Make
Webhooks → Custom webhook Přijmout událost karty
Vytvořte Custom webhook v Make, zkopírujte jeho URL a vložte toto URL do nastavení ⟦13838 profilu web.hook Tím se spustí scénář, když 7stamp odešle událost jako SCAN, REWARD_EARNED nebo VOUCHER_ISSUED.
- V Make
- Webhooks → Custom webhook → Přidat; dejte mu jasný název a zkopírujte jeho vygenerované URL.
- V 7stamp
- Správce → API & Integrations → Webhooks; vložte URL, vyberte typy událostí, uložte a poté vytvořte testovací událost.
HTTP
POST /cards/invite Vytvořit akci Card Invite
Vytvoří novou osobní instalaci URL a kód pro vložení dodávky pro jeden externí kontakt.
- Vyžadováno
- external_id — zmapujte svou stáj CRM/contact ID, nikoli jméno.
- Poté použijte
- Mapa install_url z odpovědi do vašeho e-mailu, SMS nebo CRM krok aktualizace.
HTTP akce
POST /cards/invite/bulk Hromadné vytvoření Card Invites
Vytvoří až 100 zvacích odkazů v jedné žádosti. Použijte jej pro řízenou migraci nebo kampaň, nikoli pro neomezený export kontaktů.
- Povinné položky
- — pole JSON 1–100 jednotlivých objektů žádosti o pozvání.
- Před odesláním jakýchkoli odkazů zkontrolujte
- Přečtěte si success_count, error_count a každý výsledek.
HTTP akce
GET /cards Find Cards
Vyhledá záznamy karet podle External ID, s volitelnou šablonou a zdrojovými filtry.
- Vyžadováno
- Parametr dotazu external_id.
- Volitelné
- external_source a template_id zužují vyhledávání, když má jeden systém více programů.
HTTP akce
GET /cards/{user_card_id} Získejte detail karty
Přečte celý stav jedné karty, když předchozí krok vrátil její vnitřní User Card ID.
- Vyžadováno
- Nahraďte {user_card_id} interním ID vráceným důvěryhodnou odpovědí 7stamp.
- Vyhněte se
- Nehádejte ani neukládejte kartu ID z jiného profilu.
HTTP akce
POST /cards/scan Naskenovat kartu
Přidá známky z částky nákupu nebo explicitního počtu. Přijímá User Card ID nebo External ID a může si ponechat externí referenční číslo objednávky.
- Identita
- Použijte external_id a volitelné external_source; user_card_id vyhrává, pokud jsou dodány oba.
- Nákup
- Použijte částku pro karty založené na částce nebo stamps_count pro explicitní číslo; stamps_count má přednost.
- Sledovatelnost
- Mapujte external_order_id z placené objednávky/receipt, takže 7stamp událostí lze zpětně spárovat.
HTTP akce
GET /templates List Templates
Zobrazí seznam šablon karet dostupných pro klávesu API. Použijte jej k testování připojení nebo k dynamickému výběru šablony.
- První test
- Toto je nejbezpečnější první požadavek: nemá žádné tělo a nemění údaje o zákaznících.
- Mapovat později
- Použijte ID aktivní šablony jako template_id pouze v případě, že profil má více než jednu aktivní šablonu.
HTTP akce
GET /templates/{template_id}/design Get Template Design
Vrátí nastavení vizuálního návrhu pro známou šablonu, což je užitečné, když jiný systém potřebuje zobrazit konzistentní výběr karet.
HTTP akce
POST /vouchers/issue Vydání voucheru
Vydá poukaz majiteli karty identifikovanému External ID nebo User Card ID.
- Požadovaný voucher
- .short_description. Zacilte kartu pomocí external_id nebo známého user_card_id.
- Platnost
- Použijte validity_type s validity_value nebo si přečtěte odkaz OpenAPI pro pevné datum vypršení platnosti.
HTTP akce
POST /messages/send Odeslat zprávu
Odešle obsah majiteli karty prostřednictvím peněženky-karty push a /or e-mailu, v souladu s nakonfigurovaným kanálem a pravidly souhlasu.
- Karta push
- card_push_text je omezena na 20 znaků a vyžaduje nainstalovanou peněženku.
- Odeslat předmět plus tělo; základní HTML je podporován v těle.
Make modul
Full 7stamp endpoint URL HTTP → Make a request
Toto je modul Make, který volá každou 7stamp trasu. Použijte kompletní URL, vyberte zdokumentovanou metodu, přidejte záhlaví Bearer a použijte JSON pouze v případě, že trasa potřebuje tělo.
- Základ URL
- https://api.7loc.com/cards-api
- Záhlaví
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json pro požadavky POST.
Tři scénáře Make, které můžete sestavit přesně tak, jak byly napsány
Níže uvedené názvy jsou skutečné moduly Make. Začněte s prvním scénářem, spusťte jej proti jednorázovému kontaktu a teprve poté přidejte směrovače, filtry nebo plánování výroby.
1. Nový kontakt CRM → zaslání odkazu na kartu 7stamp
Očekávaný výsledek: Zákazník obdrží install_url vrácené 7stamp; vaše CRM může ponechat toto URL ve stejném záznamu kontaktu.
- 1 Vytvořte scénář a přidejte aktivační událost kontaktu CRM New/Created. Pro Kommo vyberte spouštěč vytvoření kontaktu a spusťte jej jednou, aby se načetl vzorový kontakt.
- 2 Přidejte HTTP → Make a request. Nastavte metodu na POST a URL na https://api.7loc.com/cards-api/cards/invite.
- 3 Přidejte Authorization: Bearer YOUR_7STAMP_9_KEY a KEY13 Content-Type: application/json. V těle JSON namapujte kontakt CRM ID na external_id a nastavte external_source na pevný štítek, jako je kommo.
- 4 Spusťte modul HTTP jednou. Potvrďte, že výstup má install_url, delivery_insert_code, external_id a template_id.
- 5 Přidejte svůj e-mail/SMS/CRM aktualizační modul za HTTP a namapujte install_url z výstupu HTTP. Uložte si URL na CRM kontaktu, pokud jej tým bude muset poslat znovu později.
Před odesláním jakýchkoli odkazů zkontrolujte: POST /cards/invite vždy vytvoří novou pozvánku. Pokud je vaším obchodním pravidlem vyhnout se dalšímu pozvání pro stávající kontakt, použijte nejprve Find Cards.
2. Placená objednávka → přidat věrnostní známky
Očekávaný výsledek: Úspěšná odpověď na skenování zahrnuje úspěch, scan_id, stamps_added a stav karty po naskenování pro váš další krok.
- 1 Začněte od spouštěče placené objednávky POS/ecommerce. Make jistý, že jeho vzorek obsahuje stabilního zákazníka ID a objednávka/receipt ID.
- 2 Přidejte HTTP → Make a request s POST https://api.7loc.com/cards-api/cards/scan a stejným záhlavím Bearer.
- 3 Mapa external_id od zákazníka, external_source z názvu systému a external_order_id z objednávky ID. Přidejte částku pro karty založené na částce nebo stamps_count pro explicitní počet známek.
- 4 Run once s testovací objednávkou. Před povolením plánu scénáře zkontrolujte vrácený příznak úspěchu a stamps_added.
- 5 Volitelně přidejte filtr po kroku HTTP: pokračujte pouze tehdy, když je úspěch pravdivý, poté napište scan_id nebo stamps_added zpět do záznamu objednávky/CRM.
Před odesláním jakýchkoli odkazů zkontrolujte: Použijte stejné external_order_id při opakování, aby bylo možné objednávku vysledovat v pozdějších událostech webhooku; neudělujte známky dvakrát po nejasném neúspěšném běhu.
3. Událost 7stamp → aktualizujte událost CRM
Očekávaný výsledek: Make okamžitě přijme událost 7stamp a může najít odpovídající 40 30⟦140 external_source.
- 1 Vytvořte samostatný scénář Make. Přidejte Webhooks → Custom webhook, vyberte Přidat, pojmenujte jej 7stamp-card-events a zkopírujte vygenerované URL.
- 2 V 7stamp Admin otevřete API & Integrations → Webhooks. Přidejte to URL a vyberte malou sadu událostí, například SCAN a REWARD_EARNED.
- 3 Vytvořte jednorázový testovací sken nebo událost karty v 7stamp. Vraťte se na Make a pomocí Run once nechte Make určit datovou strukturu události.
- 4 Přidejte krok hledání CRM pomocí external_id. Přidejte filtr nebo router na event_type, takže SCAN, REWARD_EARNED a VOUCHER_ISSUED mohou provádět různé akce.
- 5 Přidejte akci CRM aktualizace/note. Mapujte scanned_at, stamps_after, external_order_id a issued_vouchers pouze tehdy, když jsou tato pole přítomna pro vybraný typ události.
Před odesláním jakýchkoli odkazů zkontrolujte: Udržujte webhook URL soukromý. Před zapnutím nevratných zpráv, voucherů nebo změn CRM otestujte skutečnou událost.
Získejte klíč 7stamp API před otevřením Make
Toto jsou přesné obrazovky 7stamp Admin. Vytvořte klíč jednou, zkopírujte jej do zabezpečeného připojení HTTP/keychain Make a poté jej okamžitě odstraňte ze schránky.
Připravte připojení před vybudováním
Vytvořte jeden klíč API pro každé prostředí
V 7stamp Admin přejděte na API & Integrations → API Keys → Add API Key. Uložte hodnotu do klíče Make HTTP API-key connection/keychain, pokud je tato možnost k dispozici. Nikdy nemapujte klíč z textového pole, nevkládejte jej do poznámky ani jej nepoužívejte v pracovním postupu v prohlížeči. Klíč patří k jednomu 7stamp pracovišti/profile.
Použijte stabilní External ID
Mapujte neměnné ID z vašeho ⟦8⟦139 nebo 6⟦⟦139 obchodní platforma – například CRM kontakt ID nebo zákazník UUID. Přidejte External Source, jako je hubspot, shopify nebo plakát, pokud se stejný identifikátor může objevit ve více než jednom systému.
Rozhodněte, která šablona se použije
Když má připojený profil 7stamp jednu aktivní šablonu karty, šablona může zůstat prázdná. S více šablonami namapujte nebo vyberte template_id záměrně, aby každá pozvánka a sken dosáhly zamýšleného věrnostního programu.
Přesné nastavení Make HTTP: vytvořte jednu pozvánku na kartu
Zkopírujte to do vašeho kroku automatizace
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
}Sestavte a otestujte svůj první scénář Make
V 7stamp Admin vytvořte 3⟧6 40. Pokud to nastavení účtu umožňuje, použijte samostatný testovací profil/key.
V Make vytvořte scénář a přidejte zdrojový spouštěč. Spusťte jej jednou před mapováním, abyste viděli skutečný vzorový kontakt nebo zaplacenou objednávku.
Klikněte na další plus, vyhledejte HTTP a vyberte Make požadavek. Nastavte metodu, úplné URL, a záhlaví z provozní karty na této stránce.
Jako první požadavek použijte GET https://api.7loc.com/cards-api/templates. Jeho úspěšná odezva dokazuje, že klíč funguje beze změny údajů o zákaznících.
Pro trasy POST vyberte application/json a vložte tvar těla z tohoto průvodce. Mapujte stáj External ID; přidat template_id pouze v případě, že profil má více aktivních šablon.
Spusťte s jednorázovým kontaktem, zkontrolujte výstup HTTP a teprve poté namapujte jeho přesná pole odpovědí do dalšího CRM, e-mailu nebo modulu zpráv.
Kdy byste měli používat Make HTTP?
Použijte HTTP pro 7stamp nyní: je to zdokumentovaná cesta připravená k výrobě, nikoli snížená záložní. Vyberte si ji, kdykoli potřebujete operaci 7stamp, novou trasu API nebo vlastní připojení POS/ERP. Odkaz OpenAPI je zdrojem pravdy pro metodu, úplnou cestu, tělo a schéma odezvy; klíč a základna URL zůstávají stejné.
Příjem 7stamp událostí v Make
Pro událostmi řízený scénář přidejte Webhooks → Custom webhook a vytvořte webhook. Zkopírujte jeho URL, otevřete API & Integrations → Webhooks v profilu 7stamp, vložte URL, vyberte typy událostí, uložte a odešlete skutečnou testovací událost. Profil 7stamp vlastní toto předplatné; aktuální API neodhaluje automatické koncové body odběru webhooku/unsubscribe.
Není vyžadován žádný veřejný konektor Make
Pokyny na této stránce používají moduly Make, které jsou dostupné pro každý účet Make. Pokud chcete budoucí nativní modul 7stamp spíše než HTTP, pošlete nám pracovní postup, který potřebujete; do té doby HTTP a Custom webhook pokrývají každou zdokumentovanou operaci 7stamp.
Často kladené otázky
Nemohu najít 7stamp v Make. Mohu to ještě zautomatizovat?
Ano. V Make dnes není žádná veřejná aplikace 7stamp. Přidejte požadavek HTTP > Make, použijte úplný koncový bod 7stamp URL a odešlete Authorization: Bearer následovaný vaším klíčem ⟦137. HTTP může volat každý zdokumentovaný koncový bod.
Kde získám token pro připojení Make?
V 7stamp Admin otevřete API Integrace, poté API Keys a poté Add API Key. Klíč je zaměřen na pracoviště/profile, které jej vytvořilo, takže kdykoli je to možné, použijte testovací profil pro testovací scénáře.
Který identifikátor mám namapovat jako External ID?
Použijte stabilní identifikátor ze zdrojového systému, nejlépe CRM kontakt ID nebo zákazníka UUID. Nepoužívejte zobrazovaný název. Telefonní číslo nebo e-mail mohou fungovat, ale mohou se měnit a mělo by se s nimi zacházet důsledně.
Jak dostanu události 7stamp do Make?
Vytvořte webhooky > Custom webhook v Make, poté vložte jeho vygenerovaný URL do nastavení webhooku profilu 7stamp. Po doručení použijte filtr Make nebo router pro zpracování příchozího event_type.
Další krok
Jste připraveni automatizovat první věrnostní akci?
Vytvořte klíč API, otestujte List Templates a vytvořte jeden scénář pozvánky nebo skenování s kontaktem na jedno použití. Směrovače a zasílání zpráv přidejte až poté, co bude tento jednoduchý tok spolehlivý.