Opprett en invitasjon fra en CRM-kontakt
Utløs en ny eller kvalifisert kontakt, kartlegg dens CRM ID til External ID til External ID, opprett et returkort URL til en e-post eller SMS trinn.
Automatiseringsguide uten kode
Koble 7stamp til Zapier — trinn for trinn
ImplementeringsveiledningBruk Zapier når arbeidsflyten din er en klar sekvens: en kontakt eller ordre vises, 7stamp utfører en handling, så oppdateres et annet forretningsverktøy. Den sikre ruten i dag er API av Zapier for utgående 7stamp API anrop og Webhooks by Zapier → Catch Hook for innkommende 7stamp hendelser.
Det er ingen offentlig 7stamp-app på Zapiers markedsplass. Bruk API by Zapier → API Request der det er tilgjengelig: den lagrer en statisk API-nøkkel i apptilkoblingen i stedet for å eksponere den i et Zap-trinn. Bruk Webhooks by Zapier bare for innkommende Catch Hook hendelser; ikke legg inn en 7stamp Bearer-nøkkel i et synlig Webhooks-handlingsfelt.
Start med en lineær, testbar Zap
Hold den første Zap liten. En pålitelig kontakt-til-kort- eller betalt ordre-til-stempler-flyt er et bedre utgangspunkt enn en bred toveis CRM-synkronisering.
Legg til frimerker etter kassen
Utløs fra den betalte bestillingen eller lukkede kvitteringen, kartlegg kundeidentiteten og bestill ID, bruk deretter Scan Card med bestillingsbeløpet eller eksplisitt antall stempler.
Utsted en engangskupong for gjenoppretting
Bruk en CRM-regel, støttehendelse eller segmenteksport for å identifisere en kunde, utstede en kupong til kortet deres og sende en oppfølgingsmelding fra riktig kanal.
Skriv korthendelser tilbake til CRM
Bruk Webhooks by Zapier > Catch Hook for å motta 7stamp kortbegivenheter. Match den returnerte External ID med CRM-posten og legg til den relevante notaten, taggen eller oppgaven.
7stamp operasjoner å ringe fra API innen Zapier
Legg til API by Zapier → API Request etter utløseren. Opprett én 7stamp API-nøkkelforbindelse, velg deretter den nøyaktige metoden og hele URL nedenfor. Hver operasjon returnerer felt som du kan tilordne til neste Zap-trinn.
API av Zapier handling
POST /cards/invite Opprett Card Invite
Oppretter en ny lommebokkortinstallasjon URL og leveringskode for én ekstern kontakt.
- Obligatorisk
- external_id fra CRM/contact-utløseren.
- Neste trinn
- Tilordne install_url til e-post, SMS eller et CRM-felt.
API av Zapier handling
POST /cards/invite/bulk Masseoppretting Card Invites
Oppretter opptil 100 invitasjonslenker fra en kontrollert JSON batch.
- Nødvendig
- elementarray med 1–100 invitasjonsobjekter.
- Sjekk
- Les success_count, error_count, og hvert resultat før levering.
API av Zapier handling
POST /cards/scan Scan Card
Legger til stempler etter ⟦23067⟦230, 8 stempel, 8, 8 eller 8 ID, og valgfrie kvitteringsdata.
- Identitet
- external_id pluss valgfritt external_source; user_card_id vinner hvis begge er tilstede.
- Stempelregel
- stamps_count prioriteres fremfor beløp.
API ved Zapier handling
POST /vouchers/issue Issue Voucher
Utsteder en kupong direkte til en korteier.
- Nødvendig
- -kupong.short_description og et mål external_id eller kjent user_card_id.
- Resultat
- Kartlegg unique_code, status eller expires_at til et CRM notat eller melding.
API av Zapier handling
POST /messages/send Send Message
Sender lommebokkort-push og/or-e-post til en korteier.
- Kort-push
- card_push_text er begrenset til 20 tegn.
- E-post
- emne pluss brødtekst; resultatet rapporterer om levering var i kø.
API av Zapier handling
GET /cards Find Cards
Finner kortposter etter External ID, med valgfri kildemal og filter.
- Obligatorisk
- external_id som spørringsparameter.
- Bruk først
- Bruk før du oppretter en invitasjon når regelen din unngår dupliserte invitasjoner.
API av Zapier handling
GET /cards/{user_card_id} Hent kortdetaljer
Leser statusen til et kort ved dets 7stamp interne ⟦2309.
- Påkrevd
- Erstatt {user_card_id} med en ID returnert av 7stamp.
- Nyttig utgang
- stamps_count, lommebokstatus og active_vouchers_count.
API av Zapier handling
GET /templates List Templates
Viser maler som er tilgjengelige for den tilkoblede profilen og bekrefter koblingen ⟦231.
- Første test
- Kall den før noen skrivehandling: den endrer ingen kundedata.
- Bruk senere
- En aktiv id blir template_id når det finnes flere maler.
API av Zapier handling
GET /templates/{template_id}/design Get Template Design
Henter en mals designinnstillinger for en kjent mal ⟦231.
Zapier trigger
Webhooks by Zapier → Catch Hook Motta korthendelser
Catch Hook gir Zapier en unik HTTPS1⟧1. Lim den inn i 7stamp Admins webhook-innstillinger og test den med en ekte korthendelse.
- I Zapier
- Bruk Catch Hook for analyserte hendelsesdata; bruk Catch Raw Hook bare når du også trenger rå forespørselshoder/body.
- Match
- Find the CRM contact using external_id and optional external_source from the event.
Tre Zapier arbeidsflyter du kan bygge trinn for trinn
Hvert scenario bruker en ekte, tilgjengelig Zapier-modul. Bygg en liten rute først og test den med en engangskontakt før du slår på Zap.
1. Kvalifisert CRM kontakt → utsted et kort
Forventet resultat: Det neste Zap-trinn mottar install_url og kan sende det til kunden eller skrive det tilbake til CRM-posten.
- 1 Opprett en Zap og velg CRM-hendelsen som betyr at en kontakt er kvalifisert for lojalitet. Test utløseren og bekreft at du har kontaktens uforanderlige ID.
- 2 Legg til API by Zapier → API Request. Opprett eller velg 7stamp API-nøkkelforbindelsen, velg POST, og sett URL til https://api.7loc.com/cards-api/cards/invite.
- 3 Sett brødteksten til JSON. Kartlegg CRM ID til external_id, sett en fast external_source som kommo, og legg til template_id bare når mer enn én 7stamp-mal er aktiv.
- 4 Test handlingen. Bekreft at svaret inneholder install_url og delivery_insert_code for samme external_id.
- 5 Legg til CRM-oppdateringen, e-post eller SMS-handlingen. Kart install_url fra API-svaret; ikke hardkode eller kopier en test URL.
Sjekk: Opprett Card Invite returnerer alltid en ny invitasjon. Legg til en Find Cards-forespørsel eller et Zapier-filter først hvis policyen din er én invitasjon per kontakt.
2. Betalt ordre → tildelingsstempler
Forventet resultat: Bestillingen oppretter en sporbar 7stamp skanning og Zap kan registrere stamps_added eller scan_id i kildesystemet.
- 1 Bruk en betalt ordre/Closed Kvitteringsutløser og test den. Bekreft at kunden ID og den unike ordren ID begge er tilstede før du fortsetter.
- 2 Legg til API by Zapier → API Request med POST https://api.7loc.com/cards-api/cards/scan og velg den samme 7stamp-tilkoblingen.
- 3 Send JSON med external_id, external_source, external_order_id, og enten beløp for beløpsbaserte maler eller stamps_count for en eksplisitt stempelpremie.
- 4 Test med engangsbestilling. Inspiser suksess, scan_id og stamps_added i svaret.
- 5 Legg til et filter som bare fortsetter etter et vellykket svar, og oppdater deretter bestillingen/CRM med det bekreftede resultatet.
Sjekk: Hvis Zap spilles av på nytt, sjekk den opprinnelige bestillingen før du sender en ny skanning. Hold external_order_id stabil slik at arrangementet kan avstemmes senere.
3. 7stamp-hendelse → opprett et CRM-notat eller oppgave
Forventet resultat: Zapier mottar en analysert 7stamp-2-hendelse, finner 2-kunden, 2 og 2 oppfølging.
- 1 Lag en ny Zap med Webhooks by Zapier som utløser. Velg Catch Hook, fortsett og kopier den unike URL vist i testtrinnet.
- 2 I 7stamp Admin, åpne API & Integrations → Webhooks, legg til Catch Hook URL, velg bare nødvendige hendelsestyper og lagre.
- 3 Forårsak en ekte testskanning eller korthendelse. Tilbake i Zapier, klikk på Test trigger og bekreft at event_type, external_id og external_source ankommer som eksempelfelt.
- 4 Legg til en CRM Finn kontakthandling ved å bruke external_id. Legg til en filter- eller baner-regel for event_type, for eksempel separat SCAN fra REWARD_EARNED.
- 5 Opprett en CRM-notat/task og kart bare felt som eksisterer for den hendelsen, for eksempel scanned_at, stamps_after, external_order_id2 eller 34⟦3.
Sjekk: En Catch Hook URL er en hemmelighet. Hvis Zap blir overført til en annen eier, oppdater URL i 7stamp Admin før du stoler på den.
Lag 7stamp API-nøkkelen før du bygger Zap
Dette er 7stamp-sidetrinnene. Gjør dette én gang, og bruk deretter nøkkelen bare innenfor API by Zapier-forbindelsen – ikke i et Webhooks by Zapier-handlingsfelt eller et notat.
Tilkoblingsregler som forhindrer datamismatch
Behold API-nøkkelen i en API ved Zapier-tilkobling
I 7stamp Admin, velg 2721. I API by Zapier oppretter du en API-nøkkelforbindelse med en statisk Authorization-overskrift som inneholder Bearer etterfulgt av den nøkkelen. API av Zapier beholder legitimasjonen i forbindelsen i stedet for et synlig Zap-trinn; begrense tilgangen til tilkoblingen og roter nøkkelen hvis den er synlig.
Kart External ID og External Source konsekvent
External ID er din egen stabile kundeidentifikator; External Source merker hvor det kom fra, for eksempel hubspot, bitrix24, shopify eller plakat. Bruk det samme paret for opprettelse, finn, skanning, voucher og webhook-flyt.
Vit hvilken kortidentifikator som vinner
Kortmålrettingshandlinger godtar User Card ID eller External ID. Når begge er tilstede, har User Card ID prioritet. Bruk den interne ID bare etter at den ble returnert av et klarert 7stamp-trinn; ellers foretrekker kildesystemet External ID.
Nøyaktig API ved Zapier forespørsel: gi ett stempel
Kopier dette inn i automatiseringstrinnet
http Method: POST
URL: https://api.7loc.com/cards-api/cards/scan
Headers:
Authorization: Bearer YOUR_7STAMP_API_KEY
Content-Type: application/json
Data:
{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"stamps_count": 1,
"external_order_id": "order_2048"
}Bygg din første Zap
Lag en 7stamp API2-nøkkel i Admin:2.2.2. Bruk en egen testnøkkel/profile når tilgjengelig.
I Zapier, lag en Zap og test kildeutløseren. Bruk en ekte prøve slik at kontakten ID, kunde ID, bestilling ID og beløp er tilgjengelig for kartlegging.
Legg til API by Zapier → API Request. Opprett en 7stamp-tilkobling for den statiske Bearer Authorization-overskriften i stedet for å legge hemmeligheten i et Webhooks by Zapier-handlingsfelt.
Ring først GET https://api.7loc.com/cards-api/templates. Dette bekrefter nøkkelen fungerer og viser hvilke aktive mal-IDer som er tilgjengelige uten å endre kundedata.
Velg POST /cards/invite eller POST /cards/scan, sett JSON som kroppstype, og kartlegg stallen External ID pluss den relevante malen⟦23262 utløserfeltet.
Kjør handlingen med en engangskontakt, inspiser dens eksakte svarfelt, og tilord deretter disse feltene til neste CRM, e-post eller meldingstrinn før du publiserer Zap.
Bruk den universelle forespørselen kun for dokumenterte ruter
Bruk API av Zapier for en 7stamp-forespørsel med en Bearer API-nøkkel: den holder statiske topptekstnøkler i en app-tilkobling. Bruk Webhooks by Zapier for Catch Hook levering av hendelser, ikke som det foretrukne stedet for en 7stamp-hemmelighet. Hold basen URL på https://api.7loc.com/cards-api, bruk den offentlige OpenAPI-referansen for eksakte skjemaer, og send aldri legitimasjon eller kundedata til en ubekreftet URL.
Motta 7stamp hendelser gjennom Catch Hook
Opprett Webhooks by Zapier → Catch Hook, kopier den unike URL vist i testoppsettet, lim den inn i 7stamp-profilens webhook-innstillinger, velg hendelsestypene, og send deretter en ekte testskanning eller korthendelse. Bruk hendelsesnyttelastens External ID og External Source for å finne den rette CRM-kontakten. Velg Catch Raw Hook bare når du spesifikt trenger den ikke-parserte brødteksten og forespørselshodene.
Bruk den sikre Zapier-ruten nå
API av Zapier og Catch Hook er tilstrekkelig for alle offentlige ⟦22995-hendelser og kort⟧. Hvis du trenger en fremtidig innfødt 7stamp Zapier-app, send oss den nøyaktige handlingen/trigger teamet ditt bruker mest.
Vanlige spørsmål
Hvor finner jeg 7stamp-appen i Zapier?
Det er ingen offentlig 7stamp markedsplass-app i dag. Bruk API by Zapier → API Request for 7stamp API-anrop og Webhooks by Zapier → Catch Hook for innkommende 7stamp-hendelser.
Hvor oppretter jeg tokenet Zapier?
Opprett en 7stamp API-nøkkel i Admin under API & Integrations → API Keys → Add API Key. Lagre den som en statisk Bearer Authorization-overskrift i API by Zapier-tilkoblingen, ikke i et synlig Webhooks by Zapier-handlingsfelt.
Hvordan kan Zapier motta et stempel eller en kupongbegivenhet?
Opprett en Catch Hook i Webhooks by Zapier, lim den genererte URL inn i 7stamp-profilens webhook-innstillinger, velg hendelsene og send en testhendelse før du aktiverer CRM-oppdateringer.
Skal jeg velge Zapier eller Make?
Velg Zapier for en hovedsakelig lineær trigger-action arbeidsflyt. Velg Make når du trenger rutere, komplekse transformasjoner eller lange scenarier med flere grener. Begge bruker samme 7stamp API-nøkkel og endepunkter.
Neste trinn
Bygg den første Zap med en testkontakt
Opprett API-nøkkelen, test GET /templates til API ved Zapier, og bygg deretter én kontakt-til-kort eller ordre-til-stempler-handling. Legg til Catch Hook når den utgående flyten har et påvist testresultat.