Opprett et kort etter en ny CRM-kontakt
Bruk CRM-kontakten ID som External ID, opprett en 7stamp-kortinvitasjon, og send deretter den returnerte installasjonen URL via din vanlige e-post, SMS eller meldingstrinn.
Automatiseringsguide uten kode
Koble 7stamp til Make — trinn for trinn
ImplementeringsveiledningBruk Make til å koble 7stamp med en CRM, POS, nettbutikk, regneark, meldingsverktøy eller et hvilket som helst system som kan sende data inn i et scenario. Den produksjonsklare ruten i dag er Makes HTTP-app for 7stamp API-anrop og Makes Custom webhook for innkommende 7stamp-arrangementer.
Det er ingen offentlig 7stamp-app i Makes appvelger ennå. Ikke vent på en: legg til HTTP → Make a request, bruk den nøyaktige URL, metoden, Bearer overskriften og JSON nedenfor, og kartlegg deretter feltene fra kildemodulen din. Dette er den samme 7stamp Integration API som en fremtidig kobling vil bruke.
Velg det første scenariet som samsvarer med arbeidsflyten din
Start med en hendelse og ett resultat. Når testdataene er korrekte, legg til filtre, rutere, CRM-oppdateringer og oppfølgingsmeldinger rundt det.
Legg til frimerker etter en betalt bestilling
Utløs scenariet fra en betalt POS eller e-handelsordre. Kartlegg den stabile kunden ID og bestill ID til Skann et kort, og bruk deretter et beløp eller eksplisitt stempeltelling.
Send en belønningsoppfølging
Når en korthendelse rapporterer en belønning eller kupong, forgrener du scenariet: oppdater CRM, varsle teamet og send et lommebokkort-push eller e-post bare når det er nødvendig.
Håndter et system uten en innebygd Make-app
Bruk Makes HTTP-modul for å ringe 7stamp direkte. Dette er det universelle valget for en tilpasset POS, ERP, bestillingsmotor eller hvilken som helst API-first service.
7stamp operasjoner å ringe fra Make HTTP
For hvert kort nedenfor, legg til HTTP → Make a request, sett deretter metoden og URL nøyaktig som vist. Bruk samme Bearer-nøkkel for hver forespørsel. Den nødvendige kartleggingen forteller deg hva du skal levere fra CRM, POS eller e-handelsutløseren.
Make trigger
Webhooks → Custom webhook Motta en korthendelse
Opprett en Custom webhook i Make, kopier dens URL, og lim deretter inn den URL i ⟦23398h-profilens innstillinger. Dette starter et scenario når 7stamp sender en hendelse som SCAN, REWARD_EARNED eller VOUCHER_ISSUED.
- I Make
- Webhooks → Custom webhook → Legg til; gi den et tydelig navn og kopier den genererte URL.
- I 7stamp
- Admin → API & Integrations → Webhooks; lim inn URL, velg hendelsestyper, lagre, og lag deretter en testhendelse.
HTTP handling
POST /cards/invite Opprett en Card Invite
Oppretter en ny personlig installasjon URL og leverings-sett inn kode for én ekstern kontakt.
- Påkrevd
- external_id — kartlegg stallen din CRM/contact ID, ikke et navn.
- Bruk deretter
- Kart install_url fra svaret til e-posten din, SMS eller CRM oppdateringstrinn.
HTTP handling
POST /cards/invite/bulk Masseoppretting Card Invites
Oppretter opptil 100 invitasjonslenker i én forespørsel. Bruk den for en kontrollert migrering eller kampanje, ikke en ubegrenset kontakteksport.
- Nødvendige
- elementer — en JSON rekke med 1–100 individuelle invitasjonsforespørselsobjekter.
- Sjekk
- Les success_count, error_count og hvert resultat før du sender noen linker.
HTTP handling
GET /cards Find Cards
Finner kortposter etter External ID, med valgfri mal og kildefiltre.
- Påkrevd
- Spørringsparameter external_id.
- Valgfritt
- external_source og template_id begrenser oppslaget når ett system har flere programmer.
HTTP handling
GET /cards/{user_card_id} Få en kortdetaljer
Leser hele tilstanden til ett kort når et tidligere trinn har returnert sin interne User Card ID.
- Påkrevd
- Erstatt {user_card_id} med den interne ID returnert av et klarert 7stamp-svar.
- Unngå
- Ikke gjett eller lagre et kort ID fra en annen profil.
HTTP handling
POST /cards/scan Skann et kort
Legger til frimerker fra et kjøpsbeløp eller en eksplisitt telling. Den godtar User Card ID eller External ID og kan beholde den eksterne ordrereferansen.
- Identitet
- Bruk external_id og valgfri external_source; user_card_id vinner hvis begge følger med.
- Kjøp
- Bruk beløp for beløpsbaserte kort eller stamps_count for et eksplisitt nummer; stamps_count prioriteres.
- Sporbarhet
- Kartlegg external_order_id fra den betalte bestillingen/receipt slik at 7stamp hendelser kan matches tilbake.
HTTP handling
GET /templates List Templates
Viser kortmalene som er tilgjengelige for API-nøkkelen. Bruk den til å teste tilkoblingen eller til å velge en mal dynamisk.
- Første test
- Dette er den sikreste første forespørselen: den har ingen kropp og endrer ikke kundedata.
- Kart senere
- Bruk en aktiv mals id som template_id bare når profilen har mer enn én aktiv mal.
HTTP handling
GET /templates/{template_id}/design Get Template Design
Returnerer de visuelle designinnstillingene for en kjent mal, nyttig når et annet system må vise et konsistent kortvalg.
HTTP handling
POST /vouchers/issue Utsted en kupong
Utsteder en kupong til en korteier identifisert av External ID eller User Card ID.
- Nødvendig
- -kupong.short_description. Målrett kortet med external_id eller en kjent user_card_id.
- Gyldighet
- Bruk validity_type med validity_value, eller les OpenAPI-referansen for en fast utløpsdato.
HTTP handling
POST /messages/send Send en melding
Sender innhold til korteieren gjennom lommebokkort-push og/or e-post, underlagt de konfigurerte kanalene og samtykkereglene.
- Kort-push
- card_push_text er begrenset til 20 tegn og krever et installert lommebokpass.
- E-post
- Send emne pluss brødtekst; basic HTML støttes i kroppen.
Make modul
Full 7stamp endpoint URL HTTP → Make a request
Dette er Make-modulen som ringer hver 7stamp-rute ovenfor. Bruk en komplett URL, velg den dokumenterte metoden, legg til Bearer-overskriften, og bruk JSON bare når ruten trenger en tekst.
- Base URL
- https://api.7loc.com/cards-api
- Topptekst
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json for POST forespørsler.
Tre Make-scenarier du kan bygge nøyaktig som skrevet
Navnene nedenfor er de virkelige Make-modulene. Start med det første scenariet, kjør det mot en engangskontakt, og legg først til rutere, filtre eller produksjonsplanlegging.
1. Ny CRM kontakt → send en 7stamp kortlenke
Forventet resultat: Kunden mottar install_url returnert av 7stamp; din CRM kan beholde den URL i samme kontaktpost.
- 1 Lag et scenario og legg til CRMs nye/Created kontaktutløser. For Kommo, velg kontaktopprettingsutløseren og kjør den én gang for å laste inn en prøvekontakt.
- 2 Legg til HTTP → Make a request. Sett metode til POST og URL til https://api.7loc.com/cards-api/cards/invite.
- 3 Legg til Authorization: Bearer YOUR_7STAMP_4⟧ og Content-Type: application/json. I JSON-kroppen, kartlegg CRM-kontakten ID til external_id og sett external_source til en fast etikett som kommo.
- 4 Kjør HTTP-modulen én gang. Bekreft at utgangen har install_url, delivery_insert_code, external_id og template_id.
- 5 Legg til e-post/SMS/CRM oppdateringsmodul etter HTTP og kart install_url fra HTTP-utgangen. Lagre URL på CRM-kontakten hvis teamet må sende det på nytt senere.
Sjekk: POST /cards/invite lager alltid en ny invitasjon. Bruk Find Cards først hvis forretningsregelen din er å unngå en ny invitasjon til en eksisterende kontakt.
2. Betalt ordre → legg til lojalitetsstempler
Forventet resultat: Et vellykket skannesvar inkluderer suksess, scan_id, stamps_added og post-skanningskortets status for neste trinn.
- 1 Start fra POS/ecommerce Utløseren for betalt ordre. Make sikker på at prøven inneholder en stabil kunde ID og bestillingen/receipt ID.
- 2 Legg til HTTP → Make a request med POST https://api.7loc.com/cards-api/cards/scan og den samme Bearer-overskriften.
- 3 Kart external_id fra kunden, external_source fra systemnavnet og external_order_id fra bestillingen ID. Legg til beløp for beløpsbaserte kort, eller stamps_count for et eksplisitt antall stempler.
- 4 Run once med en testbestilling. Sjekk det returnerte suksessflagget og stamps_added før du aktiverer scenarioplanen.
- 5 Legg eventuelt til et filter etter HTTP-trinnet: fortsett bare når suksessen er sann, skriv deretter scan_id eller stamps_added tilbake til ordre-/CRM-posten.
Sjekk: Bruk samme external_order_id på nye forsøk slik at bestillingen kan spores i senere webhook-hendelser; ikke tildel frimerker to ganger etter et uklart mislykket løp.
3. 7stamp-hendelsen → oppdater CRM
Forventet resultat: Make mottar 7stamp-hendelsen umiddelbart og kan finne treffet via ⟦235 external_id og external_source.
- 1 Lag et eget Make-scenario. Legg til Webhooks → Custom webhook, velg Legg til, navngi den 7stamp-korthendelser, og kopier den genererte URL.
- 2 I 7stamp Admin, åpne API & Integrations → Webhooks. Legg til URL og velg et lite sett med hendelser, for eksempel SCAN og REWARD_EARNED.
- 3 Lag en engangstestskanning eller korthendelse i 7stamp. Gå tilbake til Make og bruk Run once for å la Make bestemme hendelsesdatastrukturen.
- 4 Legg til et CRM søketrinn ved å bruke external_id. Legg til et filter eller ruter på event_type slik at SCAN, REWARD_EARNED og VOUCHER_ISSUED kan utføre forskjellige handlinger.
- 5 Legg til handlingen CRM update/note. Kartlegg scanned_at, stamps_after, external_order_id og issued_vouchers bare når disse feltene er til stede for den valgte hendelsestypen.
Sjekk: Hold webhooken URL privat. Test en reell hendelse før du slår på irreversible meldinger, kuponger eller CRM endringer.
Få 7stamp API-nøkkelen før du åpner Make
Dette er de nøyaktige 7stamp Admin-skjermene. Opprett nøkkelen én gang, kopier den inn i Makes sikre HTTP-tilkobling/keychain, og fjern den umiddelbart fra utklippstavlen.
Forbered tilkoblingen før du bygger
Opprett én API-nøkkel per miljø
I 7stamp Admin, gå til API & Integrations → API Keys → Add API Key. Lagre verdien i Makes HTTP API-nøkkeltilkobling/keychain når det alternativet er tilgjengelig. Aldri kartlegg nøkkelen fra et tekstfelt, plasser den i et notat eller bruk den i en nettleservendt arbeidsflyt. En nøkkel tilhører én 7stamp arbeidsplass/profile.
Bruk en stall External ID
Kartlegg den uforanderlige ID fra din ⟦23,49⟦23 POS, eller handelsplattform – for eksempel en CRM kontakt ID eller kunde UUID. Legg til External Source som hubspot, shopify eller poster når samme identifikator kan vises i mer enn ett system.
Bestem hvilken mal som gjelder
Når den tilkoblede 7stamp-profilen har én aktiv kortmal, kan malen stå tom. Med flere maler, kart eller velg template_id bevisst slik at hver invitasjon og skanning når det tiltenkte lojalitetsprogrammet.
Nøyaktig Make HTTP oppsett: lag én kortinvitasjon
Kopier dette inn i automatiseringstrinnet
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
}Bygg og test ditt første Make scenario
I 7stamp Admin3, lag en nøkkel i 2362. Bruk en egen testprofil/key når kontooppsettet tillater det.
I Make oppretter du et scenario og legger til kildeutløseren. Kjør den én gang før kartlegging, slik at du kan se en ekte prøvekontakt eller betalt ordre.
Klikk på neste pluss, søk etter HTTP, og velg Make en forespørsel. Still inn metoden, fullstendig URL, og overskrifter fra operasjonskortet på denne siden.
Bruk GET https://api.7loc.com/cards-api/templates som første forespørsel. Det vellykkede svaret beviser at nøkkelen fungerer uten å endre kundedata.
For POST-ruter, velg application/json og lim inn kroppsformen fra denne veiledningen. Kartlegg en stall External ID; legg til template_id bare hvis profilen har flere aktive maler.
Kjør med en engangskontakt, inspiser HTTP-utgangen, og først deretter kartlegge dets eksakte svarfelt til neste CRM, e-post- eller meldingsmodul.
Når bør du bruke Make HTTP?
Bruk HTTP for 7stamp nå: det er den dokumenterte, produksjonsklare ruten, ikke en redusert reserve. Velg det når du trenger en 7stamp-operasjon, en ny API-rute eller en tilpasset POS/ERP-tilkobling. OpenAPI-referansen er kilden til sannhet for metoden, hele banen, kroppen og responsskjemaet; bærenøkkelen og basen URL forblir de samme.
Motta 7stamp hendelser i Make
For et hendelsesdrevet scenario, legg til Webhooks → Custom webhook og lag en webhook. Kopier URL, åpne API & Integrations → Webhooks i 7stamp-profilen, lim inn URL, velg hendelsestyper, lagre og send en ekte testhendelse. 7stamp-profilen eier det abonnementet; gjeldende API avslører ikke endepunkter for automatisk webhook-abonnement/unsubscribe.
Ingen offentlig Make-kobling er nødvendig
Instruksjonene på denne siden bruker Make-moduler som er tilgjengelige for hver Make-konto. Hvis du vil ha en fremtidig innfødt 7stamp-modul i stedet for HTTP, send oss arbeidsflyten du trenger; Inntil da dekker HTTP og Custom webhooks hver dokumenterte 7stamp operasjon.
Vanlige spørsmål
Jeg finner ikke 7stamp i Make. Kan jeg fortsatt automatisere det?
Ja. Det er ingen offentlig 7stamp-app i Make i dag. Legg til HTTP > Make en forespørsel, bruk hele 7stamp endepunktet URL, og send Authorization: Bearer etterfulgt av ⟦233.50⟧. HTTP kan ringe alle dokumenterte endepunkter.
Hvor får jeg tokenet for Make-tilkoblingen?
I 7stamp Admin åpner du API Integrations, deretter API Keys og deretter Add API Key. Nøkkelen er beregnet på arbeidsplassen/profile som opprettet den, så bruk en testprofil for testscenarier når det er mulig.
Hvilken identifikator skal jeg tilordne som External ID?
Bruk den stabile identifikatoren fra kildesystemet, fortrinnsvis en CRM kontakt ID eller kunde UUID. Ikke bruk et visningsnavn. Et telefonnummer eller e-post kan fungere, men kan endres og bør håndteres konsekvent.
Hvordan får jeg 7stamp hendelser inn i Make?
Opprett en Webhooks > Custom webhook i Make, og lim deretter den genererte URL inn i webhook-innstillingene til 7stamp-profilen. Bruk et Make-filter eller ruter etter levering for å håndtere innkommende event_type.
Neste trinn
Klar til å automatisere den første lojalitetshandlingen?
Lag API-nøkkelen, test List Templates, og bygg ett invitasjons- eller skannscenario med en engangskontakt. Legg til rutere og meldinger først etter at den enkle flyten er pålitelig.