Looge kaart pärast uut CRM kontakti
Kasutage CRM kontakti ID kui External ID, looge 7stamp kaardikutse, seejärel saatke tagastatud installifail URL oma tavapärase e-posti, numbri SMS või sõnumisammu kaudu.
Koodita automatiseerimise juhend
Ühendage 7stamp numbriga Make — samm-sammult
RakendusjuhendKasutage numbrit Make numbri 7stamp ühendamiseks numbritega CRM, POS, veebipoe, arvutustabeli, sõnumitööriista või mis tahes süsteemiga, mis suudab andmeid stsenaariumi saata. Tänane tootmisvalmis marsruut on Make rakendus HTTP numbri 7stamp API kõnede jaoks ja Make Custom webhook sissetulevate 7stamp sündmuste jaoks.
Kasutaja Make rakenduste valijas pole veel avalikku rakendust 7stamp. Ärge oodake: lisage HTTP → Make a request, kasutage täpset URL, meetodit, Bearer päist ja JSON allpool, seejärel kaardistage väljad lähtemoodulist. See on sama 7stamp Integration API, mida tulevane pistik kasutaks.
Valige esimene stsenaarium, mis sobib teie töövooga
Alustage ühe sündmuse ja ühe tulemusega. Kui testiandmed on õiged, lisage nende ümber filtrid, ruuterid, CRM värskendused ja järelteated.
Pärast tasulist tellimust lisage templid
Käivitage stsenaarium tasulisest numbrist POS või e-poe tellimusest. Kaardistage oma stabiilne klient ID ja tellige ID kaardi skannimisse, seejärel kasutage summat või täpset templite arvu.
Saatke preemia järelkontroll
Kui kaardisündmus teatab preemiast või vautšerist, harutage stsenaariumi: värskendage numbrit CRM, teavitage meeskonda ja saatke rahakotikaardi tõukesõnum või e-kiri ainult vajaduse korral.
Käsitsege süsteemi, millel puudub algrakendus Make
Kasutage numbrile 7stamp otse helistamiseks moodulit Make HTTP. See on universaalne valik kohandatud POS, ERP, broneerimismootori või mis tahes API-esimese teenuse jaoks.
7stamp toimingud numbrilt Make HTTP helistamiseks
Lisage iga alloleva kaardi jaoks HTTP → Make a request, seejärel määrake meetod ja URL täpselt nii, nagu näidatud. Kasutage iga päringu jaoks sama klahvi Bearer. Nõutav vastendus ütleb teile, mida CRM, POS või e-poe käivitaja kaudu edastada.
Make päästik
Webhooks → Custom webhook Saate kaardisündmuse
Looge Custom webhook failis Make, kopeerige see URL, seejärel kleepige see URL profiili 7stamp veebihooki seadetesse. See käivitab stsenaariumi, kui 7stamp saadab sündmuse, näiteks SCAN, REWARD_EARNED või VOUCHER_ISSUED.
- In Make
- Webhooks → Custom webhook → Lisa; andke sellele selge nimi ja kopeerige selle loodud URL.
- In 7stamp
- Administraator → API & Integrations → Webhooks; kleepige URL, valige sündmuste tüübid, salvestage ja looge testsündmus.
HTTP
POST /cards/invite Looge toiming Card Invite
Loob värske isikliku installi URL ja tarnimis-sisestamiskoodi ühe väliskontakti jaoks.
- Nõutav
- external_id — kaardista oma tall CRM/contact ID, mitte nimi.
- Seejärel kasutage e-kirja vastusest kaarti
- kaarti install_url, SMS või CRM värskendamise sammu.
HTTP toiming
POST /cards/invite/bulk Hulgiloomine Card Invites
Loob ühes päringus kuni 100 kutselinki. Kasutage seda kontrollitud migratsiooni või kampaania jaoks, mitte kontaktide piiramatuks eksportimiseks.
- Nõutavad
- üksused – massiiv JSON, mis koosneb 1–100 individuaalsest kutsetaotluse objektist.
- Kontrollige
- Enne linkide saatmist lugege success_count, error_count ja iga tulemust.
HTTP toiming
GET /cards Find Cards
Otsib kaardikirjeid External ID järgi koos valikuliste mallide ja allikafiltritega.
- Nõutav
- Päringu parameeter external_id.
- Valikuline
- external_source ja template_id kitsendavad otsingut, kui ühes süsteemis on mitu programmi.
HTTP toiming
GET /cards/{user_card_id} Hankige kaardi üksikasjad
Loeb ühe kaardi täielikku olekut, kui eelmine samm on tagastanud oma sisemise User Card ID.
- Nõutav
- Asendage {user_card_id} sisemise numbriga ID, mille tagastas usaldusväärne 7stamp vastus.
- Väldi
- Ärge arvake ära ega salvestage kaarti ID teisest profiilist.
HTTP toiming
POST /cards/scan Kaardi skannimine
Lisab ostusummale või selgele arvule templid. See aktsepteerib User Card ID või External ID ja võib säilitada välise tellimuse viite.
- Identiteet
- Kasutage external_id ja valikulist external_source; user_card_id võidab, kui mõlemad on varustatud.
- Ost
- Kasutage summat summapõhiste kaartide jaoks või stamps_count selge numbri jaoks; stamps_count on prioriteetne.
- Jälgitavus
- Kaardista external_order_id tasutud tellimusest/receipt, et 7stamp sündmusi saaks tagasi sobitada.
HTTP toiming
GET /templates List Templates
Loetleb klahvi API jaoks saadaolevad kaardimallid. Kasutage seda ühenduse testimiseks või malli dünaamiliseks valimiseks.
- Esimene test
- See on kõige turvalisem esimene päring: sellel puudub keha ja see ei muuda kliendiandmeid.
- Kaardistada hiljem
- Kasutage aktiivse malli ID-d kujul template_id ainult siis, kui profiilil on rohkem kui üks aktiivne mall.
HTTP toiming
GET /templates/{template_id}/design Get Template Design
Tagastab teadaoleva malli visuaalse kujunduse sätted, mis on kasulik, kui mõni muu süsteem peab kuvama ühtse kaardivaliku.
HTTP toiming
POST /vouchers/issue Väljasta vautšer
Väljastab vautšeri kaardi omanikule, keda tähistab External ID või ⟧9117⟧.
- Nõutav vautšer
- .short_description. Sihtige kaarti numbriga external_id või tuntud numbriga user_card_id.
- Kehtivus
- Kasutage validity_type koos numbriga validity_value või lugege viidet OpenAPI fikseeritud aegumiskuupäeva kohta.
HTTP toiming
POST /messages/send Saada sõnum
Saadab sisu kaardi omanikule rahakotikaardi tõuke ja /or meili teel, järgides konfigureeritud kanalit ja nõusolekureegleid.
- Kaarditõuge
- card_push_text on piiratud 20 tähemärgiga ja nõuab installitud rahakotikaarti.
- E-post
- Saada teema ja sisu; põhiline HTML on kehas toetatud.
Make moodul
Full 7stamp endpoint URL HTTP → Make a request
See on Make moodul, mis helistab igal ülaloleval marsruudil 7stamp. Kasutage täielikku numbrit URL, valige dokumenteeritud meetod, lisage päis Bearer ja kasutage numbrit JSON ainult siis, kui marsruut vajab keha.
- Alus URL
- https://api.7loc.com/cards-api
- Päis
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json POST taotluste jaoks.
Kolm Make stsenaariumi, mille saate koostada täpselt nii, nagu kirjutatud
Allolevad nimed on tõelised Make moodulid. Alustage esimesest stsenaariumist, käivitage see ühekordselt kasutatava kontakti vastu ja alles seejärel lisage ruuterid, filtrid või tootmise ajakava.
1. Uus CRM kontakt → saada 7stamp kaardi link
Eeldatav tulemus: Klient saab numbri install_url, mille saatis 7stamp; teie CRM võib hoida seda URL samas kontaktikirjes.
- 1 Looge stsenaarium ja lisage oma numbri CRM uus/Created kontaktipäästik. Kommo puhul valige kontakti loomise päästik ja käivitage see näidiskontakti laadimiseks üks kord.
- 2 Lisa HTTP → Make a request. Määra meetodiks POST ja URL väärtusele https://api.7loc.com/cards-api/cards/invite.
- 3 Add Authorization: Bearer YOUR_7STAMP_API_KEY and Content-Type: application/json. In the JSON body, map the CRM contact ID into external_id and set external_source to a fixed label such as kommo.
- 4 Käivitage moodul HTTP üks kord. Veenduge, et väljundis on install_url, delivery_insert_code, external_id ja template_id.
- 5 Lisage oma e-posti aadress/SMS/CRM värskendusmoodul pärast numbrit HTTP ja kaardi install_url väljundist HTTP. Kui meeskond peab selle hiljem uuesti saatma, salvestage URL kontaktile CRM.
Kontrollige: POST /cards/invite loob alati uue kutse. Kasutage esmalt numbrit Find Cards, kui teie ärireegel on vältida olemasoleva kontakti kutset.
2. Tasutud tellimus → lisage püsiklienditemplid
Eeldatav tulemus: Edukas skannimise vastus hõlmab scan_id, stamps_added ja kaardi skannimisjärgset olekut järgmise sammu jaoks.
- 1 Alustage tasulise tellimuse päästikust POS/ecommerce. Make veenduge, et selle näidis sisaldab stabiilset klienti ID ja tellimust/receipt ID.
- 2 Lisa HTTP → Make a request koos POST https://api.7loc.com/cards-api/cards/scan ja sama Bearer päisega.
- 3 Kaart external_id kliendilt, external_source süsteemi nimelt ja external_order_id tellimuselt ID. Lisage summa summapõhiste kaartide jaoks või stamps_count kindla arvu markide jaoks.
- 4 Run once koos testtellimusega. Enne stsenaariumi ajakava lubamist kontrollige tagastatud edu lippu ja stamps_added.
- 5 Soovi korral lisage filter pärast sammu HTTP: jätkake ainult siis, kui õnnestumine on tõene, seejärel kirjutage scan_id või stamps_added tagasi tellimuse/CRM kirjesse.
Kontrollige: Kasutage sama external_order_id korduskatsetel, et tellimust oleks võimalik jälgida hilisemates veebihaagi sündmustes; ärge andke marke kaks korda pärast ebaselget ebaõnnestunud jooksu.
3. 7stamp sündmus → värskenda CRM
Eeldatav tulemus: Make võtab sündmuse 7stamp kohe vastu ja leiab sobiva ⟦9 kirje ⟦9250 kaudu external_source.
- 1 Looge eraldi Make stsenaarium. Lisage Webhooks → Custom webhook, valige Lisa, nimetage see 7stamp-card-events ja kopeerige loodud URL.
- 2 Avage failis 7stamp Admin API & Integrations → Webhooks. Lisage see URL ja valige väike sündmuste kogum, näiteks SCAN ja REWARD_EARNED.
- 3 Looge numbris 7stamp ühekordselt kasutatav testskannimine või kaardisündmus. Naaske numbrile Make ja kasutage numbrit Run once, et lasta Make määrata sündmuse andmete struktuur.
- 4 Lisage CRM otsingusamm, kasutades numbrit external_id. Lisage numbritele event_type filter või ruuter, et numbrid SCAN, REWARD_EARNED ja VOUCHER_ISSUED saaksid teha erinevaid toiminguid.
- 5 Lisage toiming CRM värskendus/note. Kaardistada scanned_at, stamps_after, external_order_id ja issued_vouchers ainult siis, kui need väljad on valitud sündmusetüübi jaoks olemas.
Kontrollige: Hoidke veebihaak URL privaatseks. Enne pöördumatute sõnumite, vautšerite või CRM muudatuste sisselülitamist testige tõelist sündmust.
Hankige enne Make
These are the exact 7stamp Admin screens. Create the key once, copy it into Make's secure HTTP connection/keychain, then immediately remove it from your clipboard.
Valmistage ühendus enne loomist ette
Looge üks võti API keskkonna kohta
Minge jaotises 9146⟧ aadressile API & Integrations → API Keys → Add API Key. Kui see valik on saadaval, salvestage väärtus kausta Make HTTP API-klahviühendus/keychain. Ärge kunagi kaardistage võtit tekstiväljalt, asetage seda märkmesse ega kasutage seda brauseri poole suunatud töövoos. Võti kuulub ühele 7stamp töökohale/profile.
Kasutage stabiilset External ID
Kaardistage muutumatu ID oma numbrilt ID oma numbrilt ⟦159,56⟦9,58⟦915. kaubandusplatvorm – näiteks CRM kontakt ID või klient UUID. Lisage External Source (nt hubspot, shopify või poster), kui sama identifikaator võib esineda mitmes süsteemis.
Otsustage, milline mall rakendub
Kui ühendatud profiilil 7stamp on üks aktiivne kaardimall, võib mall tühjaks jätta. Mitme malliga kaardistage või valige template_id teadlikult, et iga kutse ja skannimine jõuaks kavandatud lojaalsusprogrammi.
Täpne Make HTTP seadistus: looge üks kaardikutse
Kopeerige see oma automatiseerimisetappi
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
}Ehitage ja testige oma esimene Make stsenaarium
Loendis 7stamp Admin looge võti 3⟦⟧928. Kasutage eraldi testprofiili/key, kui teie konto seadistus seda võimaldab.
Looge jaotises Make stsenaarium ja lisage allika päästik. Käivitage see enne kaardistamist üks kord, et saaksite näha tõelist näidiskontakti või tasulist tellimust.
Klõpsake järgmisel plussil, otsige HTTP ja valige päring Make. Määrake meetod, täielik URL ja päised sellel lehel olevalt operatsioonikaardilt.
Kasutage esimese päringuna GET https://api.7loc.com/cards-api/templates. Selle edukas vastus tõestab, et võti töötab ilma kliendiandmeid muutmata.
Marsruutide POST jaoks valige application/json ja kleepige kehakuju sellest juhendist. Kaardistage tall External ID; lisage template_id ainult siis, kui profiilil on mitu aktiivset malli.
Käivitage ühekordse kontaktiga, kontrollige väljundit HTTP ja alles seejärel kaardistage selle täpsed vastuseväljad järgmisesse CRM, meili- või sõnumimoodulisse.
Millal peaksite kasutama numbrit Make HTTP?
Kasutage numbrit HTTP kohe numbri 7stamp jaoks: see on dokumenteeritud, tootmisvalmis marsruut, mitte vähendatud varu. Valige see alati, kui vajate toimingut 7stamp, uut API marsruuti või kohandatud POS/ERP ühendust. Viide OpenAPI on tõe allikas meetodi, täieliku tee, keha ja vastuse skeemi kohta; kandevõti ja alus URL jäävad samaks.
Võtke vastu 7stamp sündmusi jaotises Make
Sündmuspõhise stsenaariumi jaoks lisage Webhooks → Custom webhook ja looge veebihaak. Kopeerige selle URL, avage API & Integrations → Webhooks profiilis 7stamp, kleepige URL, valige sündmuste tüübid, salvestage ja saatke tõeline testsündmus. See tellimus kuulub profiilile 7stamp; praegune API ei avalda veebihaagi automaatse tellimise/unsubscribe lõpp-punkte.
Avalikku Make pistikut pole vaja
Sellel lehel olevad juhised kasutavad Make mooduleid, mis on saadaval iga Make konto jaoks. Kui soovite tulevast moodulit 7stamp, mitte HTTP, saatke meile vajalik töövoog; kuni selle ajani hõlmavad HTTP ja Custom webhook iga dokumenteeritud 7stamp toimingut.
Korduma kippuvad küsimused
Ma ei leia numbrit 7stamp jaotisest Make. Kas ma saan seda veel automatiseerida?
Jah. Täna pole dokumendis Make avalikku rakendust 7stamp. Lisage taotlus HTTP > Make, kasutage täielikku 7stamp lõpp-punkti URL ja saatke Authorization: Bearer, millele järgneb võti 7stamp API. HTTP saab helistada igale dokumenteeritud lõpp-punktile.
Kust ma saan ühenduse Make märgi?
Avage jaotises 7stamp Admin API Integratsioonid, seejärel API Keys ja seejärel Add API Key. Võti ulatub selle loonud töökohale/profile, seega kasutage võimalusel katsestsenaariumide jaoks testprofiili.
Millise identifikaatori peaksin kaardistama kui External ID?
Kasutage lähtesüsteemi stabiilset identifikaatorit, eelistatavalt CRM kontakti ID või klienti UUID. Ärge kasutage kuvatavat nime. Telefoninumber või e-posti aadress võib toimida, kuid võib muutuda ja seda tuleks järjepidevalt käsitleda.
Kuidas saada 7stamp sündmused Make-sse?
Looge jaotises Make veebihaagid > Custom webhook, seejärel kleepige selle loodud URL profiili 7stamp veebihaagi seadetesse. Pärast kohaletoimetamist kasutage sissetuleva numbri event_type käsitlemiseks filtrit või ruuterit.
Järgmine samm
Kas olete valmis automatiseerima esimest lojaalsustoimingut?
Looge võti API, testige numbrit List Templates ja looge üks kutse- või skannimisstsenaarium ühekordselt kasutatava kontaktiga. Lisage ruuterid ja sõnumid alles pärast seda, kui lihtne voog on usaldusväärne.