Opret et kort efter en ny CRM-kontakt
Brug CRM-kontakten ID som External ID, opret en 7stamp-kortinvitation, og send derefter den returnerede installation URL via din sædvanlige e-mail, SMS eller besked.
Ingen kode automatiseringsvejledning
Tilslut 7stamp til Make — trin for trin
ImplementeringsvejledningBrug Make til at forbinde 7stamp med en CRM, POS, onlinebutik, regneark, beskedværktøj eller et hvilket som helst system, der kan sende data ind i et scenarie. Den produktionsklare rute i dag er Makes HTTP app til 7stamp API opkald og Makes Custom webhook til indgående 7stamp begivenheder.
Der er endnu ingen offentlig 7stamp-app i Makes appvælger. Vent ikke på en: tilføj HTTP → Make a request, brug den nøjagtige URL, metode, Bearer header og JSON nedenfor, og kortlæg derefter felterne fra dit kildemodul. Dette er det samme 7stamp Integration API som et fremtidigt stik ville bruge.
Vælg det første scenarie, der matcher din arbejdsgang
Start med én begivenhed og ét resultat. Når testdataene er korrekte, skal du tilføje filtre, routere, CRM opdateringer og opfølgende beskeder omkring det.
Tilføj stempler efter en betalt ordre
Udløs scenariet fra en betalt POS eller e-handelsordre. Kortlæg dens stabile kunde ID og bestil ID til Scan et kort, og brug derefter et beløb eller et eksplicit stempeltal.
Send en belønningsopfølgning
Når en korthændelse rapporterer en belønning eller voucher, skal du forgrene scenariet: Opdater CRM, underret teamet og send kun et pungkort-push eller e-mail, når det er nødvendigt.
Håndter et system uden en indbygget Make-app
Brug Makes HTTP-modul til at ringe direkte til 7stamp. Dette er det universelle valg for en brugerdefineret POS, ERP, bookingmaskine eller enhver API-first service.
7stamp operationer at ringe fra Make HTTP
For hvert kort nedenfor skal du tilføje HTTP → Make a request, derefter indstille metoden og URL nøjagtigt som vist. Brug den samme Bearer-nøgle for hver anmodning. Den påkrævede kortlægning fortæller dig, hvad du skal levere fra din CRM, POS eller e-handelstrigger.
Make trigger
Webhooks → Custom webhook Modtag en kortbegivenhed
Opret en Custom webhook i Make, kopier dens URL, og indsæt derefter den URL i ⟦22442h profilindstillingerne for ⟦22442h. Dette starter et scenarie, når 7stamp sender en begivenhed såsom SCAN, REWARD_EARNED eller VOUCHER_ISSUED.
- I Make
- Webhooks → Custom webhook → Tilføj; giv det et klart navn og kopier dets genererede URL.
- I 7stamp
- Admin → API & Integrations → Webhooks; indsæt URL, vælg hændelsestyper, gem, og opret derefter en testhændelse.
HTTP handling
POST /cards/invite Opret en Card Invite
Opretter en frisk personlig installation URL og leveringsindsæt kode for én ekstern kontakt.
- Påkrævet
- external_id — kortlæg din stald CRM/contact ID, ikke et navn.
- Brug derefter
- Kort install_url fra svaret til din e-mail, SMS eller CRM opdateringstrin.
HTTP handling
POST /cards/invite/bulk Masseopret Card Invites
Opretter op til 100 invitationslinks i én anmodning. Brug det til en kontrolleret migrering eller kampagne, ikke en ubegrænset kontakteksport.
- Påkrævede
- elementer — en JSON matrix af 1-100 individuelle invitationsanmodningsobjekter.
- Tjek
- Læs success_count, error_count og hvert resultat, før du sender nogen links.
HTTP handling
GET /cards Find Cards
Finder kortposter efter External ID med valgfri skabelon og kildefiltre.
- Påkrævet
- Forespørgselsparameter external_id.
- Valgfri
- external_source og template_id indsnævrer opslaget, når et system har flere programmer.
HTTP handling
GET /cards/{user_card_id} Få en kortdetaljer
Læser den fulde tilstand af et kort, når et tidligere trin har returneret dets interne User Card ID.
- Påkrævet
- Erstat {user_card_id} med den interne ID returneret af et betroet 7stamp-svar.
- Undgå
- Gæt eller gem ikke et kort ID fra en anden profil.
HTTP handling
POST /cards/scan Scan et kort
Tilføjer stempler fra et købsbeløb eller en eksplicit optælling. Den accepterer User Card ID eller External ID og kan beholde den eksterne ordrereference.
- Identitet
- Brug external_id og valgfri external_source; user_card_id vinder, hvis begge er leveret.
- Køb
- Brug beløb til beløbsbaserede kort eller stamps_count for et eksplicit nummer; stamps_count har prioritet.
- Sporbarhed
- Kort external_order_id fra den betalte ordre/receipt, så 7stamp begivenheder kan matches tilbage.
HTTP handling
GET /templates List Templates
Viser de kortskabeloner, der er tilgængelige for nøglen API. Brug den til at teste forbindelsen eller til at vælge en skabelon dynamisk.
- Første test
- Dette er den sikreste første anmodning: den har ingen krop og ændrer ikke kundedata.
- Kort senere
- Brug kun en aktiv skabelons id som template_id, når profilen har mere end én aktiv skabelon.
HTTP handling
GET /templates/{template_id}/design Get Template Design
Returnerer de visuelle designindstillinger for en kendt skabelon, nyttigt, når et andet system skal vise et ensartet kortvalg.
HTTP handling
POST /vouchers/issue Udsted en voucher
Udsteder en voucher til en kortejer identificeret af External ID eller User Card ID.
- Påkrævet
- kupon.short_description. Målret kortet med external_id eller en kendt user_card_id.
- Gyldighed
- Brug validity_type med validity_value, eller læs referencen OpenAPI for en fast udløbsdato.
HTTP handling
POST /messages/send Send en besked
Sender indhold til kortejeren via wallet-card push og/or e-mail, underlagt de konfigurerede kanal- og samtykkeregler.
- Kort push
- card_push_text er begrænset til 20 tegn og kræver et installeret wallet pass.
- Send emne plus brødtekst; basic HTML er understøttet i kroppen.
Make modul
Full 7stamp endpoint URL HTTP → Make a request
Dette er Make-modulet, der ringer til hver 7stamp-rute ovenfor. Brug en komplet URL, vælg den dokumenterede metode, tilføj Bearer overskriften, og brug kun JSON, når ruten har brug for en tekst.
- Base URL
- https://api.7loc.com/cards-api
- Header
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json for POST anmodninger.
Tre Make scenarier, du kan bygge nøjagtigt som skrevet
Navnene nedenfor er de rigtige Make moduler. Start med det første scenarie, kør det mod en engangskontakt, og tilføj først derefter routere, filtre eller produktionsplanlægning.
1. Ny CRM kontakt → send et 7stamp kortlink
Forventet resultat: Kunden modtager install_url returneret af 7stamp; din CRM kan opbevare den URL i den samme kontaktpost.
- 1 Opret et scenario og tilføj din CRMs nye/Created kontaktudløser. For Kommo skal du vælge udløseren for oprettelse af kontakt og køre den én gang for at indlæse en prøvekontakt.
- 2 Tilføj HTTP → Make a request. Indstil metode til POST og URL til https://api.7loc.com/cards-api/cards/invite.
- 3 Tilføj Authorization: Bearer YOUR_7STAMP_8⟧ og Content-Type: application/json. I JSON-kroppen skal du kortlægge CRM-kontakten ID til external_id og indstille external_source til en fast etiket såsom kommo.
- 4 Kør modulet HTTP én gang. Bekræft, at outputtet har install_url, delivery_insert_code, external_id og template_id.
- 5 Tilføj din e-mail/SMS/CRM opdateringsmodul efter HTTP og kort install_url fra HTTP output. Gem URL på CRM-kontakten, hvis holdet skal sende det igen senere.
Tjek: POST /cards/invite skaber altid en frisk invitation. Brug først Find Cards, hvis din forretningsregel er at undgå en anden invitation til en eksisterende kontakt.
2. Betalt ordre → tilføje loyalitetsstempler
Forventet resultat: Et vellykket scanningssvar inkluderer succes, scan_id, stamps_added og post-scanningskortets tilstand for dit næste trin.
- 1 Start fra udløseren POS/ecommerce Betalt ordre. Make sikker på, at dens prøve indeholder en stabil kunde ID og ordren/receipt ID.
- 2 Tilføj HTTP → Make a request med POST https://api.7loc.com/cards-api/cards/scan og den samme Bearer header.
- 3 Kort external_id fra kunden, external_source fra systemnavnet og external_order_id fra ordren ID. Tilføj beløb for beløbsbaserede kort, eller stamps_count for et eksplicit antal stempler.
- 4 Run once med en testordre. Tjek det returnerede succesflag og stamps_added, før du aktiverer scenarietplanen.
- 5 Tilføj eventuelt et filter efter HTTP-trinnet: Fortsæt kun, når succesen er sand, og skriv derefter scan_id eller stamps_added tilbage til ordre/CRM-posten.
Tjek: Brug den samme external_order_id på genforsøg, så ordren kan spores i senere webhook-begivenheder; uddel ikke frimærker to gange efter et uklart mislykket løb.
3. 7stamp begivenheden → opdater CRM
Forventet resultat: Make modtager 7stamp begivenheden med det samme og kan finde den matchende optagelse via ⟦26 external_id og external_source.
- 1 Opret et separat Make-scenarie. Tilføj Webhooks → Custom webhook, vælg Tilføj, navngiv den 7stamp-card-events, og kopier den genererede URL.
- 2 I 7stamp Admin, åben API & Integrations → Webhooks. Tilføj det URL og vælg et lille sæt begivenheder, for eksempel SCAN og REWARD_EARNED.
- 3 Opret en engangstestscanning eller kortbegivenhed i 7stamp. Vend tilbage til Make og brug Run once til at lade Make bestemme hændelsesdatastrukturen.
- 4 Tilføj et CRM søgetrin ved hjælp af external_id. Tilføj et filter eller en router på event_type, så SCAN, REWARD_EARNED og VOUCHER_ISSUED kan udføre forskellige handlinger.
- 5 Tilføj handlingen CRM update/note. Kort kun scanned_at, stamps_after, external_order_id og issued_vouchers, når disse felter er til stede for den valgte hændelsestype.
Tjek: Hold webhooken URL privat. Test en reel begivenhed, før du slår irreversible beskeder, kuponer eller CRM ændringer til.
Hent 7stamp API-nøglen, før du åbner Make
Dette er de nøjagtige 7stamp Admin-skærme. Opret nøglen én gang, kopier den ind i Makes sikre HTTP forbindelse/keychain, og fjern den derefter straks fra din udklipsholder.
Forbered forbindelsen, før du bygger
Opret én API nøgle pr. miljø
I 7stamp Admin skal du gå til API & Integrations → API Keys → Add API Key. Gem værdien i Makes HTTP API-nøgleforbindelse/keychain, når denne mulighed er tilgængelig. Tilknyt aldrig nøglen fra et tekstfelt, placer den i en note eller brug den i en browservendt arbejdsgang. En nøgle tilhører én 7stamp arbejdsplads/profile.
Brug en stald External ID
Kortlæg den uforanderlige ID fra din ⟦22,5 POS eller handelsplatform – for eksempel en CRM kontakt ID eller kunde UUID. Tilføj External Source såsom hubspot, shopify eller poster, når den samme identifikator kan forekomme i mere end ét system.
Beslut hvilken skabelon der gælder
Når den tilsluttede 7stamp-profil har én aktiv kortskabelon, kan skabelonen efterlades tom. Med flere skabeloner, kortlæg eller vælg template_id bevidst, så hver invitation og scanning når det tilsigtede loyalitetsprogram.
Præcis Make HTTP opsætning: Opret én kortinvitation
Kopier dette til dit automatiseringstrin
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
}Byg og test dit første Make-scenarie
I 7stamp Admin7 skal du oprette en nøgle i 2.6. Brug en separat testprofil/key, når din kontoopsætning tillader det.
I Make skal du oprette et scenarie og tilføje kildeudløseren. Kør det én gang før kortlægning, så du kan se en ægte prøvekontakt eller betalt ordre.
Klik på det næste plus, søg efter HTTP, og vælg Make en anmodning. Indstil metoden, fuld URL, og overskrifter fra operationskortet på denne side.
Brug GET https://api.7loc.com/cards-api/templates som den første anmodning. Dets succesfulde svar beviser, at nøglen virker uden at ændre kundedata.
For POST-ruter skal du vælge application/json og indsætte kropsformen fra denne guide. Kortlæg en stald External ID; tilføj kun template_id, hvis profilen har flere aktive skabeloner.
Kør med en engangskontakt, inspicér HTTP-outputtet, og kort derefter dets nøjagtige svarfelter til det næste CRM-, e-mail- eller beskedmodul.
Hvornår skal du bruge Make HTTP?
Brug HTTP til 7stamp nu: det er den dokumenterede, produktionsklare rute, ikke en reduceret reserve. Vælg det, når du har brug for en 7stamp-operation, en ny API-rute eller en tilpasset POS/ERP-forbindelse. OpenAPI-referencen er kilden til sandhed for metoden, den fulde vej, kroppen og svarskemaet; bærenøgle og base URL forbliver de samme.
Modtag 7stamp begivenheder i Make
For et begivenhedsdrevet scenarie skal du tilføje Webhooks → Custom webhook og oprette en webhook. Kopier dens URL, åbn API & Integrations → Webhooks i 7stamp-profilen, indsæt URL, vælg begivenhedstyperne, gem og send en rigtig testbegivenhed. 7stamp-profilen ejer dette abonnement; den nuværende API afslører ikke automatiske webhook-abonnement/unsubscribe-slutpunkter.
Der kræves ingen offentlig Make-stik
Instruktionerne på denne side bruger Make-moduler, der er tilgængelige for hver Make-konto. Hvis du vil have et fremtidigt indfødt 7stamp-modul frem for HTTP, så send os det workflow, du har brug for; indtil da dækker HTTP og Custom webhooks alle dokumenterede 7stamp operationer.
Ofte stillede spørgsmål
Jeg kan ikke finde 7stamp i Make. Kan jeg stadig automatisere det?
Yes. There is no public 7stamp app in Make today. Add HTTP > Make a request, use the complete 7stamp endpoint URL, and send Authorization: Bearer followed by your 7stamp API key. HTTP can call every documented endpoint.
Hvor får jeg tokenet til Make-forbindelsen?
I 7stamp Admin skal du åbne API Integrationer, derefter API Keys og derefter Add API Key. Nøglen er beregnet til den arbejdsplads/profile, der oprettede den, så brug en testprofil til testscenarier, når det er muligt.
Hvilken identifikator skal jeg kortlægge som External ID?
Brug den stabile identifikator fra kildesystemet, helst en CRM kontakt ID eller kunde UUID. Brug ikke et vist navn. Et telefonnummer eller en e-mail kan fungere, men kan ændre sig og bør håndteres konsekvent.
Hvordan får jeg 7stamp begivenheder ind i Make?
Opret en Webhooks > Custom webhook i Make, og indsæt derefter dens genererede URL i webhook-indstillingerne for 7stamp-profilen. Brug et Make-filter eller en router efter levering til at håndtere den indgående event_type.
Næste skridt
Klar til at automatisere den første loyalitetshandling?
Opret API-nøglen, test List Templates, og byg et invitations- eller scanningsscenario med en engangskontakt. Tilføj kun routere og beskeder, når det simple flow er pålideligt.