Luo kortti uuden CRM yhteystiedon jälkeen
Käytä CRM yhteystietoa ID nimellä External ID, luo 7stamp korttikutsu ja lähetä sitten palautettu asennus URL tavallisella sähköpostilla, SMS tai viestillä.
Kooditon automaatioopas
Yhdistä 7stamp numeroon Make — vaihe vaiheelta
KäyttöönottoopasKäytä numeroa Make yhdistääksesi numeron CRM, POS, verkkokauppaan, laskentataulukkoon, viestityökaluun tai mihin tahansa järjestelmään, joka voi lähettää tietoja skenaarioon. Tuotantovalmis reitti tänään on Make:n HTTP sovellus numeron 7stamp API puheluille ja sovelluksen Make Custom webhook saapuville 7stamp tapahtumille.
Henkilön Make sovellusvalitsimessa ei ole vielä julkista sovellusta 7stamp. Älä odota yhtä: lisää HTTP → Make a request, käytä tarkkaa URL, metodia, Bearer-otsikkoa ja JSON alla ja yhdistä sitten kentät lähdemoduulistasi. Tämä on sama 7stamp Integration API, jota tuleva liitin käyttäisi.
Valitse ensimmäinen skenaario, joka vastaa työnkulkuasi
Aloita yhdellä tapahtumalla ja yhdellä tuloksella. Kun testitiedot ovat oikein, lisää niiden ympärille suodattimia, reitittimiä, CRM-päivityksiä ja seurantaviestejä.
Lisää leimat maksetun tilauksen jälkeen
Käynnistä skenaario maksetusta numerosta POS tai verkkokauppatilauksesta. Kartoita sen vakaa asiakas ID ja tilaa ID Scan a Card -sovellukseen ja käytä sitten summaa tai nimenomaista leimamäärää.
Lähetä palkintoseuranta
Kun korttitapahtuma ilmoittaa palkinnosta tai kupongista, haaroittele skenaario: päivitä CRM, ilmoita asiasta tiimille ja lähetä lompakkokortti push tai sähköposti vain tarvittaessa.
Käsittele järjestelmää ilman alkuperäistä Make-sovellusta
Käytä Make-moduulia HTTP soittaaksesi suoraan numeroon 7stamp. Tämä on universaali valinta mukautetulle POS, ERP, varausmoottorille tai mille tahansa API-ensipalvelulle.
7stamp toiminnot numerosta Make HTTP
Lisää jokaiselle alla olevalle kortille HTTP → Make a request, aseta menetelmä ja URL täsmälleen kuvan mukaisesti. Käytä samaa Bearer-avainta jokaisessa pyynnössä. Vaadittu kartoitus kertoo, mitä CRM-, POS- tai verkkokauppatriggeristäsi tulee toimittaa.
Make laukaisin
Webhooks → Custom webhook Vastaanota korttitapahtuma
Luo Custom webhook tiedostoon Make, kopioi sen URL ja liitä se URL verkkoprofiilin ⟦20530-asetuksiin. Tämä käynnistää skenaarion, kun 7stamp lähettää tapahtuman, kuten SCAN, REWARD_EARNED tai VOUCHER_ISSUED.
- Kohdassa Make
- Webhooks → Custom webhook → Lisää; anna sille selkeä nimi ja kopioi sen luotu URL.
- Kohteessa 7stamp
- Järjestelmänvalvoja → API & Integrations → Webhooks; liitä URL, valitse tapahtumatyypit, tallenna ja luo sitten testitapahtuma.
HTTP toiminto
POST /cards/invite Luo Card Invite
Luo uuden henkilökohtaisen asennuksen URL ja toimitus-lisäkoodin yhdelle ulkoiselle yhteyshenkilölle.
- Pakollinen
- external_id — kartoita talliasi CRM/contact ID, älä nimeä.
- Käytä sitten
- karttaa install_url vastauksesta sähköpostiisi, SMS tai CRM päivitysvaihetta.
HTTP toiminto
POST /cards/invite/bulk Joukkoluo Card Invites
Luo jopa 100 kutsulinkkiä yhdessä pyynnössä. Käytä sitä ohjattuun siirtoon tai kampanjaan, älä rajoittamattomaan yhteystietojen vientiin.
- Pakolliset
- kohteet — JSON joukko 1–100 yksittäistä kutsupyyntöobjektia.
- Tarkista
- Lue success_count, error_count ja jokainen tulos ennen linkkien lähettämistä.
HTTP toiminto
GET /cards Find Cards
Etsii korttitietueita tunnuksen External ID mukaan valinnaisen mallin ja lähdesuodattimien avulla.
- Pakollinen
- Kyselyparametri external_id.
- Valinnainen
- external_source ja template_id rajaavat hakua, kun yhdessä järjestelmässä on useita ohjelmia.
HTTP toiminto
GET /cards/{user_card_id} Hanki kortin tiedot
Lukee yhden kortin täyden tilan, kun edellinen vaihe on palauttanut sisäisen User Card ID.
- Pakollinen
- Korvaa {user_card_id} sisäisellä ID, jonka palauttaa luotettava 7stamp.
- Vältä
- Älä arvaa tai säilytä korttia ID eri profiilista.
HTTP toiminto
POST /cards/scan Skannaa kortti
Lisää leimoja ostosummasta tai nimenomaisesta määrästä. Se hyväksyy numerot User Card ID tai External ID ja voi säilyttää ulkoisen tilausviitteen.
- Identiteetti
- Käytä external_id ja valinnaista external_source; user_card_id voittaa, jos molemmat toimitetaan.
- Osta
- Käytä summaa summaperusteisissa korteissa tai stamps_count selkeässä numerossa; stamps_count on etusijalla.
- Jäljitettävyys
- Kartta external_order_id maksetusta tilauksesta/receipt jotta 7stamp tapahtumia voidaan yhdistää.
HTTP toiminto
GET /templates List Templates
Luettelo näppäimelle API käytettävissä olevat korttimallit. Käytä sitä yhteyden testaamiseen tai mallin valitsemiseen dynaamisesti.
- Ensimmäinen testi
- Tämä on turvallisin ensimmäinen pyyntö: sillä ei ole kehoa eikä se muuta asiakastietoja.
- Karttaa myöhemmin
- Käytä aktiivisen mallin tunnusta template_id vain, kun profiilissa on useampi kuin yksi aktiivinen malli.
HTTP toiminto
GET /templates/{template_id}/design Get Template Design
Palauttaa tunnetun mallin visuaalisen suunnittelun asetukset, mikä on hyödyllistä, kun toisen järjestelmän on näytettävä yhtenäinen korttivalinta.
HTTP toiminta
POST /vouchers/issue Myönnä kuponki
Myöntää kupongin kortin omistajalle, jonka tunnukset ovat External ID tai ⟦20589.
- Pakollinen
- kuponki.short_description. Kohdista korttiin external_id tai tunnettu user_card_id.
- Voimassaolo
- Käytä numeroa validity_type yhdessä validity_value:n kanssa tai lue viite OpenAPI kiinteää viimeistä käyttöpäivää varten.
HTTP toiminto
POST /messages/send Lähetä viesti
Lähettää sisällön kortin omistajalle lompakkokorttipussilla ja/or sähköpostilla määritetyn kanavan ja suostumussääntöjen mukaisesti.
- Card push
- card_push_text on rajoitettu 20 merkkiin ja vaatii asennetun lompakkokortin.
- Sähköposti
- Lähetä aihe ja teksti; perus HTML on tuettu kehossa.
Make moduuli
Full 7stamp endpoint URL HTTP → Make a request
Tämä on Make moduuli, joka soittaa jokaista 7stamp yläpuolella olevaa reittiä. Käytä täydellistä URL, valitse dokumentoitu menetelmä, lisää Bearer-otsikko ja käytä JSON vain, kun reitti tarvitsee rungon.
- Pohja URL
- https://api.7loc.com/cards-api
- Otsikko
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json POST pyynnöille.
Kolme Make skenaariota, jotka voit rakentaa täsmälleen kirjoitetulla tavalla
Alla olevat nimet ovat todellisia Make-moduuleja. Aloita ensimmäisestä skenaariosta, suorita se kertakäyttöistä kontaktia vasten ja vasta sitten lisää reitittimet, suodattimet tai tuotannon ajoitus.
1. Uusi CRM yhteystieto → lähetä 7stamp korttilinkki
Odotettu tulos: Asiakas saa numeron install_url, jonka palauttaa numero 7stamp; CRM voi säilyttää sen URL samassa yhteystietotietueessa.
- 1 Luo skenaario ja lisää CRM:n uusi/Created Yhteystiedot. Valitse kohteelle Kommo kontaktinluontitriggeri ja suorita se kerran ladataksesi esimerkkiyhteystiedon.
- 2 Lisää HTTP → Make a request. Aseta menetelmäksi POST ja URL arvoon https://api.7loc.com/cards-api/cards/invite.
- 3 Lisää Authorization: Bearer YOUR_7STAMP__K7EY3 ja 20677⟧⟧ Content-Type: application/json. Merkitse JSON-tekstissä yhteystieto CRM ID muotoon external_id ja aseta external_source kiinteäksi tunnisteeksi, kuten kommo.
- 4 Suorita HTTP-moduuli kerran. Varmista, että tulosteessa on install_url, delivery_insert_code, external_id ja template_id.
- 5 Lisää sähköpostisi/SMS/CRM päivitysmoduuli numeron HTTP jälkeen ja kartoita install_url tulosteesta HTTP. Tallenna URL yhteystietoon CRM, jos tiimin on lähetettävä se myöhemmin uudelleen.
Tarkista: POST /cards/invite luo aina uuden kutsun. Käytä numeroa Find Cards ensin, jos yrityksesi sääntösi on välttää toista kutsua olemassa olevalle kontaktille.
2. Maksettu tilaus → lisää kanta-asiakasleimat
Odotettu tulos: Onnistunut skannausvastaus sisältää onnistumisen, scan_id, stamps_added ja skannauksen jälkeisen kortin tilan seuraavaa vaihetta varten.
- 1 Aloita POS/ecommerce maksetun tilauksen laukaisimesta. Make varmistaa, että sen näyte sisältää vakaan asiakkaan ID ja tilauksen/receipt ID.
- 2 Lisää HTTP → Make a request ja POST https://api.7loc.com/cards-api/cards/scan ja sama Bearer otsikko.
- 3 Kartta external_id asiakkaalta, external_source järjestelmän nimestä ja external_order_id tilauksesta ID. Lisää summa summaperusteisille korteille tai stamps_count, jos haluat nimenomaisen määrän postimerkkejä.
- 4 Run once testitilauksella. Tarkista palautettu onnistumislippu ja stamps_added ennen skenaarion aikataulun käyttöönottoa.
- 5 Voit halutessasi lisätä suodattimen vaiheen HTTP jälkeen: jatka vain, kun onnistuminen on tosi, ja kirjoita sitten tilaus/CRM-tietueeseen scan_id tai stamps_added.
Tarkista: Käytä samaa numeroa external_order_id uudelleenyritysten yhteydessä, jotta tilaus voidaan jäljittää myöhemmissä webhook-tapahtumissa; älä myönnä postimerkkejä kahdesti epäselvän epäonnistuneen ajon jälkeen.
3. 7stamp tapahtuma → päivitä CRM
Odotettu tulos: Make vastaanottaa tapahtuman 7stamp välittömästi kautta ⟦207 ja löytää vastaavan tietueen ⟦22222 external_id ja external_source.
- 1 Luo erillinen Make skenaario. Lisää Webhooks → Custom webhook, valitse Lisää, nimeä se 7stamp-kortti-tapahtumat ja kopioi luotu URL.
- 2 Avaa numerossa 7stamp Admin API & Integrations → Webhooks. Lisää URL ja valitse pieni joukko tapahtumia, esimerkiksi SCAN ja REWARD_EARNED.
- 3 Luo kertakäyttöinen testiskannaus tai korttitapahtuma kohteessa 7stamp. Palaa numeroon Make ja käytä koodia Run once, jotta Make määrittää tapahtumatietorakenteen.
- 4 Lisää hakuvaihe CRM käyttämällä external_id. Lisää suodatin tai reititin numeroihin event_type, jotta SCAN, REWARD_EARNED ja VOUCHER_ISSUED voivat suorittaa erilaisia toimintoja.
- 5 Lisää CRM päivitys/note -toiminto. Kartta scanned_at, stamps_after, external_order_id ja issued_vouchers vain, kun kyseiset kentät ovat läsnä valitulle tapahtumatyypille.
Tarkista: Pidä webhook URL yksityisenä. Testaa todellista tapahtumaa ennen peruuttamattomien viestien, tositteiden tai CRM muutosten käyttöönottoa.
Hanki avain 7stamp API ennen kuin avaat Make
Nämä ovat tarkat 7stamp Admin-näytöt. Luo avain kerran, kopioi se Make suojattuun HTTP-yhteyteen/keychain ja poista se sitten välittömästi leikepöydältä.
Valmistele yhteys ennen rakentamista
Luo yksi API-avain ympäristöä kohden
Siirry kohtaan 7stamp Admin kohtaan API & Integrations → API Keys → Add API Key. Tallenna arvo Make:n HTTP API-avainliitäntään/keychain, kun tämä vaihtoehto on käytettävissä. Älä koskaan yhdistä avainta tekstikentästä, sijoita sitä muistiinpanoon tai käytä sitä selaimeen päin olevassa työnkulussa. Avain kuuluu yhdelle työpaikalle 7stamp/profile.
Käytä tallia External ID
Kartoita muuttumaton ID omasta numerostasi ID POS tai kaupankäyntialusta – esimerkiksi CRM yhteystieto ID tai asiakas UUID. Lisää External Source, kuten hubspot, shopify tai juliste, kun sama tunniste saattaa esiintyä useammassa kuin yhdessä järjestelmässä.
Päätä käytettävä malli
Kun yhdistetyssä profiilissa 7stamp on yksi aktiivinen korttimalli, Malli voidaan jättää tyhjäksi. Kartoita tai valitse template_id tietoisesti useilla malleilla, jotta jokainen kutsu ja skannaus saavuttaa aiotun kanta-asiakasohjelman.
Tarkat Make HTTP asetukset: luo yksi korttikutsu
Kopioi tämä automaatiovaiheeseen
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
}Luo ja testaa ensimmäinen Make skenaario
Kohdassa 7stamp Admin, luo 20 avain 7stamp Admin. Käytä erillistä testiprofiilia/key, kun tilisi asetukset sallivat sen.
Luo skenaario kohdassa Make ja lisää lähdetriggeri. Suorita se kerran ennen kartoitusta, jotta näet todellisen näytekontaktin tai maksetun tilauksen.
Napsauta seuraavaa plusmerkkiä, hae HTTP ja valitse pyyntö Make. Aseta menetelmä, täydellinen URL ja otsikot tämän sivun käyttökortista.
Käytä numeroa GET https://api.7loc.com/cards-api/templates ensimmäisenä pyyntönä. Sen onnistunut vastaus osoittaa, että avain toimii muuttamatta asiakastietoja.
Reiteille POST valitse application/json ja liitä kehon muoto tästä oppaasta. Kartoita talli External ID; lisää template_id vain, jos profiilissa on useita aktiivisia malleja.
Suorita kertakäyttöisellä koskettimella, tarkasta HTTP-tuloste ja vasta sitten yhdistä sen tarkat vastauskentät seuraavaan CRM-, sähköposti- tai viestimoduuliin.
Milloin sinun tulee käyttää numeroa Make HTTP?
Käytä numeroa HTTP kohteelle 7stamp nyt: se on dokumentoitu, tuotantovalmius reitti, ei vähennetty palautus. Valitse se aina, kun tarvitset toiminnon 7stamp, uuden API reitin tai mukautetun POS/ERP yhteyden. Viite OpenAPI on menetelmän, täydellisen polun, rungon ja vastausskeeman totuuden lähde; siirtotieavain ja kanta URL pysyvät samoina.
Vastaanota 7stamp tapahtumia kohdassa Make
Jos haluat tapahtumapohjaisen skenaarion, lisää Webhooks → Custom webhook ja luo webhook. Kopioi sen URL, avaa API & Integrations → Webhooks profiilissa 7stamp, liitä URL, valitse tapahtumatyypit, tallenna ja lähetä todellinen testitapahtuma. Profiili 7stamp omistaa kyseisen tilauksen; nykyinen API ei paljasta automaattisia webhook-tilaus/unsubscribe -päätepisteitä.
Julkista Make-liitintä ei vaadita
Tämän sivun ohjeissa käytetään Make-moduuleja, jotka ovat saatavilla jokaiselle Make tilille. Jos haluat tulevaisuuden alkuperäisen moduulin 7stamp HTTP sijaan, lähetä meille tarvitsemasi työnkulku; siihen asti HTTP ja Custom webhooks kattavat kaikki dokumentoidut 7stamp toiminnot.
Usein kysytyt kysymykset
En löydä numeroa 7stamp kohteesta Make. Voinko silti automatisoida sen?
Kyllä. Alueella Make ei ole julkista sovellusta 7stamp tänään. Lisää HTTP > Make pyyntö, käytä täydellistä 7stamp päätepistettä URL ja lähetä Authorization: Bearer ja sen jälkeen 7stamp API. HTTP voi kutsua jokaista dokumentoitua päätepistettä.
Mistä saan tunnuksen Make-yhteydelle?
Avaa kohdassa 7stamp Admin API Integrations, sitten API Keys ja sitten Add API Key. Avain kattaa sen luoneen työpaikan/profile, joten käytä testiprofiilia testiskenaarioissa aina kun mahdollista.
Mikä tunniste minun pitäisi määrittää External IDksi?
Käytä lähdejärjestelmän vakaata tunnistetta, mieluiten CRM yhteystietoa ID tai asiakasta UUID. Älä käytä näyttönimeä. Puhelinnumero tai sähköpostiosoite voi toimia, mutta se voi muuttua, ja sitä tulee käsitellä johdonmukaisesti.
Miten saan 7stamp-tapahtumat numeroon Make?
Luo Webhooks > Custom webhook tiedostoon Make ja liitä sen luoma URL profiilin 7stamp webhook-asetuksiin. Käytä Make-suodatinta tai reititintä toimituksen jälkeen saapuvan numeron event_type käsittelemiseen.
Aiheeseen liittyvät sivut
Seuraava askel
Oletko valmis automatisoimaan ensimmäisen uskollisuustoiminnon?
Luo avain API, testaa List Templates ja rakenna yksi kutsu- tai skannausskenaario kertakäyttöisellä yhteyshenkilöllä. Lisää reitittimet ja viestit vasta sitten, kun yksinkertainen kulku on luotettava.