No-code automation guide

Forbind 7stamp til Zapier — trin for trin

Implementeringsvejledning

Brug Zapier, når din arbejdsgang er en klar sekvens: en kontakt eller ordre vises, 7stamp udfører en handling, så opdateres et andet forretningsværktøj. Den sikre rute i dag er API af Zapier for udgående 7stamp API opkald og Webhooks by Zapier → Catch Hook for indgående 7stamp begivenheder.

Der er ingen offentlig 7stamp-app på Zapiers markedsplads. Brug API by Zapier → API Request, hvor det er tilgængeligt: ​​den gemmer en statisk API-nøgle i appforbindelsen i stedet for at afsløre den i et Zap-trin. Brug kun Webhooks by Zapier til indgående Catch Hook begivenheder; sæt ikke en 7stamp Bearer-nøgle i et synligt Webhooks-handlingsfelt.

Start med en lineær, testbar Zap

Hold den første Zap lille. Et pålideligt kontakt-til-kort eller betalt-ordre-til-stempler flow er et bedre udgangspunkt end en bred to-vejs CRM synkronisering.

Opret en invitation fra en CRM-kontakt

Udløs på en ny eller kvalificeret kontakt, kortlæg dens CRM ID til External ID til External ID, opret det installerede kort, og opret et returkort URL til en e-mail eller SMS trin.

Tilføj stempler efter kassen

Udløs fra den betalte ordre eller lukkede kvittering, kortlæg kundens identitet og ordre ID, og brug derefter Scan Card med ordrebeløbet eller det eksplicitte antal stempler.

Udsted en engangskupon til gendannelse

Brug en CRM regel, supportbegivenhed eller segmenteksport til at identificere en kunde, udstede en voucher til deres kort og sende en opfølgningsmeddelelse fra den korrekte kanal.

Skriv kortbegivenheder tilbage til dine CRM

Brug Webhooks by Zapier > Catch Hook til at modtage 7stamp kortbegivenheder. Match den returnerede External ID med CRM-posten, og tilføj den relevante note, tag eller opgave.

7stamp operationer at ringe fra API af Zapier

Tilføj API by Zapier → API Request efter din trigger. Opret én 7stamp API-nøgleforbindelse, og vælg derefter den nøjagtige metode og hele URL nedenfor. Hver operation returnerer felter, som du kan tilknytte til det næste Zap-trin.

API af Zapier handling POST /cards/invite

Opret Card Invite

Opretter en ny tegnebogskortinstallation URL og leveringsindsæt kode for én ekstern kontakt.

Påkrævet
external_id fra CRM/contact-udløseren.
Næste skridt
Tilknyt install_url til e-mail, SMS eller et CRM-felt.
API af Zapier handling POST /cards/invite/bulk

Masseopret Card Invites

Opretter op til 100 invitationslinks fra en kontrolleret JSON batch.

Påkrævet
elementarray med 1-100 invitationsobjekter.
Tjek
Læs success_count, error_count og hvert resultat før levering.
API af Zapier handling POST /cards/scan

Scan Card

Tilføjer stempler efter ⟦22111⟦2, 22111⟧22, 112, count, order ID og valgfri kvitteringsdata.

Identitet
external_id plus valgfri external_source; user_card_id vinder, hvis begge er til stede.
Stempelregel
stamps_count har prioritet over beløb.
API ved Zapier handling POST /vouchers/issue

Issue Voucher

Udsteder en kupon direkte til en kortejer.

Påkrævet
kupon.short_description og et mål external_id eller kendt user_card_id.
Resultat
Kort unique_code, status eller expires_at til en CRM note eller besked.
API af Zapier handling POST /messages/send

Send Message

Sender wallet-card push og/or e-mail til en kortejer.

Kort push
card_push_text er begrænset til 20 tegn.
E-mail
emne plus brødtekst; resultatet rapporterer om leveringen var i kø.
API af Zapier handling GET /cards

Find Cards

Finder kortposter efter External ID, med valgfri kildeskabelon og filter.

Påkrævet
external_id som en forespørgselsparameter.
Brug først
Brug før du opretter en invitation, når din regel undgår duplikerede invitationer.
API af Zapier handling GET /cards/{user_card_id}

Hent kortdetaljer

Læser et korts tilstand ved dets 7stamp interne ⟦421.

Påkrævet
Erstat {user_card_id} med en ID returneret af 7stamp.
Nyttigt output
stamps_count, tegnebogstilstand og active_vouchers_count.
API af Zapier handling GET /templates

List Templates

Viser skabeloner, der er tilgængelige for den tilsluttede profil og verificerer forbindelsen ⟦221.

Første test
Kald det før enhver skrivehandling: det ændrer ingen kundedata.
Brug senere
Et aktivt id bliver template_id, når der findes flere skabeloner.
API af Zapier handling GET /templates/{template_id}/design

Get Template Design

Henter en skabelons designindstillinger for en kendt skabelon ⟦22.

Zapier trigger Webhooks by Zapier → Catch Hook

Modtag kortbegivenheder

Catch Hook giver Zapier en unik HTTPS2. Indsæt det i 7stamp Admins webhook-indstillinger og test det med en rigtig kortbegivenhed.

I Zapier
Brug Catch Hook til parsede hændelsesdata; brug kun Catch Raw Hook, når du også har brug for rå anmodningsoverskrifter/body.
Match
Find the CRM contact using external_id and optional external_source from the event.

Tre Zapier arbejdsgange, du kan bygge trin for trin

Hvert scenarie bruger et rigtigt, aktuelt tilgængeligt Zapier-modul. Byg først en lille rute, og test den med en engangskontakt, før du tænder for Zap.

1. Kvalificeret CRM kontakt → udstede et kort

Forventet resultat: Det næste Zap-trin modtager install_url og kan sende det til kunden eller skrive det tilbage til CRM-posten.

  1. 1 Opret en Zap og vælg begivenheden CRM, der betyder, at en kontakt er kvalificeret til loyalitet. Test triggeren og bekræft, at du har kontaktens uforanderlige ID.
  2. 2 Tilføj API by Zapier → API Request. Opret eller vælg 7stamp API-nøgleforbindelsen, vælg POST, og indstil URL til https://api.7loc.com/cards-api/cards/invite.
  3. 3 Indstil brødteksten til JSON. Kortlæg CRM ID til external_id, indstil en fast external_source såsom kommo, og tilføj kun template_id, når mere end én 7stamp-skabelon er aktiv.
  4. 4 Test handlingen. Bekræft, at svaret indeholder install_url og delivery_insert_code for den samme external_id.
  5. 5 Tilføj din CRM-opdatering, e-mail eller SMS-handling. Kort install_url fra API-svaret; undlad at hardkode eller kopiere en test URL.

Tjek: Opret Card Invite returnerer altid en ny invitation. Tilføj først en Find Cards-anmodning eller et Zapier-filter, hvis din politik er én invitation pr. kontakt.

2. Betalt ordre → præmiestempler

Forventet resultat: Ordren opretter en sporbar 7stamp-scanning, og Zap'en kan optage stamps_added eller scan_id i kildesystemet.

  1. 1 Brug en betalt ordre/Closed Kvitteringsudløser og test den. Bekræft, at kunden ID og den unikke ordre ID begge er til stede, før du fortsætter.
  2. 2 Tilføj API by Zapier → API Request med POST https://api.7loc.com/cards-api/cards/scan og vælg den samme 7stamp-forbindelse.
  3. 3 Send JSON med external_id, external_source, external_order_id og enten beløb for beløbsbaserede skabeloner eller stamps_count for en eksplicit stempeltildeling.
  4. 4 Test med en engangsbestilling. Undersøg succes, scan_id og stamps_added i svaret.
  5. 5 Tilføj et filter, der kun fortsætter efter et vellykket svar, og opdater derefter ordren/CRM med det bekræftede resultat.

Tjek: Hvis Zap afspilles igen, skal du kontrollere den originale ordre, før du sender endnu en scanning. Hold external_order_id stabil, så begivenheden kan afstemmes senere.

3. 7stamp begivenhed → opret en CRM note eller opgave

Forventet resultat: Zapier modtager en parset 7stamp for 5 hændelse, finder den relevante kunde, 2 og 6 opfølgning.

  1. 1 Opret en ny Zap med Webhooks by Zapier som udløser. Vælg Catch Hook, fortsæt og kopier den unikke URL vist i testtrinnet.
  2. 2 I 7stamp Admin, åbn API & Integrations → Webhooks, tilføj Catch Hook URL, vælg kun nødvendige hændelsestyper og gem.
  3. 3 Forårsage en reel testscanning eller korthændelse. Tilbage i Zapier, klik på Test trigger og bekræft event_type, external_id og external_source ankommer som prøvefelter.
  4. 4 Tilføj en CRM Find kontakthandling ved hjælp af external_id. Tilføj en filter- eller stierregel for event_type, adskil f.eks. SCAN fra REWARD_EARNED.
  5. 5 Opret en CRM note/task og kortlæg kun felter, der eksisterer for den pågældende begivenhed, såsom scanned_at, stamps_after, external_order_id2 eller ⟦2.

Tjek: En Catch Hook URL er en hemmelighed. Hvis Zap'en overføres til en anden ejer, skal du opdatere URL i 7stamp Admin, før du stoler på den.

Opret 7stamp API-nøglen, før du bygger Zap'en

Dette er 7stamp-sidetrinene. Gør dette én gang, og brug derefter kun nøglen i forbindelsen API by Zapier – ikke i et Webhooks by Zapier handlingsfelt eller en note.

7stamp Admin API & Integrationsskærmen med Add API Key handlingen
Open API & Integrations, choose API Keys, then create a separate key for the Zap where your account setup allows it.
Nyligt genereret 7stamp API-nøgle klar til at blive kopieret
Kopiér nøglen til den sikre API ved Zapier-forbindelse, ikke ind i et almindeligt tekst Webhooks-trin eller et delt dokument.

Forbindelsesregler, der forhindrer datamismatch

Behold nøglen API i en API ved Zapier forbindelse

In 7stamp Admin, choose API & Integrations → API Keys → Add API Key. In API by Zapier, create an API-key connection with a static Authorization header containing Bearer followed by that key. API by Zapier keeps the credential in the connection instead of a visible Zap step; restrict access to the connection and rotate the key if it is exposed.

Kort External ID og External Source konsekvent

External ID er din egen stabile kunde-id; External Source etiketter, hvor det kom fra, for eksempel hubspot, bitrix24, shopify eller plakat. Brug det samme par til oprettelse, find, scanning, voucher og webhook-flow.

Ved, hvilken kortidentifikator der vinder

Kortmålretningshandlinger accepterer User Card ID eller External ID. Når begge er til stede, har User Card ID prioritet. Brug kun den interne ID, efter at den blev returneret af et betroet 7stamp-trin; ellers foretrækker kildesystemet External ID.

Præcis API ved Zapier anmodning: tildel et stempel

Kopier dette til dit automatiseringstrin 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"
}

Byg din første Zap

01

Opret en 7stamp API6 nøgle i Admin.2.2.8 Brug en separat testnøgle/profile, når den er tilgængelig.

02

I Zapier skal du oprette en Zap og teste kildeudløseren. Brug en rigtig prøve, så kontakten ID, kunde ID, ordre ID og beløb er tilgængelige for kortlægning.

03

Tilføj API by Zapier → API Request. Opret en 7stamp forbindelse til den statiske Bearer Authorization header i stedet for at placere hemmeligheden i et Webhooks by Zapier handlingsfelt.

04

Ring først GET https://api.7loc.com/cards-api/templates. Dette bekræfter nøglen fungerer og viser, hvilke aktive skabelon-id'er der er tilgængelige uden at ændre kundedata.

05

Vælg POST /cards/invite eller POST /cards/scan, indstil JSON som kropstype, og kortlæg det stabile ⟦222300⟦6 plus de relevante skabeloner fra stabile ⟦22300⟦6⟦ udløseren.

06

Kør handlingen med en engangskontakt, inspicér dens nøjagtige svarfelter, og tilknyt derefter disse felter til det næste CRM, e-mail- eller meddelelsestrin, før du udgiver Zap.

Brug kun den universelle anmodning til dokumenterede ruter

Brug API af Zapier til en 7stamp-anmodning med en Bearer23 ⟦ key in static: ⟦ key in head: en app-forbindelse. Brug Webhooks by Zapier til Catch Hook begivenhedslevering, ikke som det foretrukne sted for en 7stamp hemmelighed. Behold basen URL på https://api.7loc.com/cards-api, brug den offentlige OpenAPI reference til nøjagtige skemaer, og send aldrig legitimationsoplysninger eller kundedata til en ubekræftet URL.

Modtag 7stamp begivenheder gennem Catch Hook

Opret Webhooks by Zapier → Catch Hook, kopier den unikke URL vist i testopsætningen, indsæt den i 2231's profil, vælg web-profil, 4 begivenhedstyperne, og send derefter en rigtig testscanning eller kortbegivenhed. Brug begivenhedens nyttelasts External ID og External Source til at finde den rigtige CRM-kontakt. Vælg kun Catch Raw Hook, når du specifikt har brug for den ikke-parserede brødtekst og anmodningsoverskrifter.

Brug den sikre Zapier-rute nu

API af Zapier og Catch Hook er tilstrækkelige til enhver offentlig ⟦22039-begivenhed og kort⟧. Hvis du har brug for en fremtidig indfødt 7stamp Zapier app, så send os den nøjagtige handling/trigger dit team bruger mest.

Spørg om et indbygget stik

Ofte stillede spørgsmål

Hvor kan jeg finde 7stamp-appen i Zapier?

Der er ingen offentlig 7stamp markedsplads-app i dag. Brug API by Zapier → API Request til 7stamp API opkald og Webhooks by Zapier → Catch Hook til indgående 7stamp begivenheder.

Hvor opretter jeg tokenet Zapier?

Opret en 7stamp API-nøgle i Admin under API & Integrations → API Keys → Add API Key. Gem det som en statisk Bearer Authorization header i API by Zapier forbindelsen, ikke i et synligt Webhooks by Zapier handlingsfelt.

Hvordan kan Zapier modtage et frimærke- eller kuponbegivenhed?

Opret en Catch Hook i Webhooks by Zapier, indsæt den genererede URL i 7stamp profilens webhook-indstillinger, vælg begivenhederne, og send en testbegivenhed, før du aktiverer CRM-opdateringer.

Skal jeg vælge Zapier eller Make?

Vælg Zapier for en overvejende lineær trigger-action workflow. Vælg Make, når du har brug for routere, komplekse transformationer eller lange scenarier med flere filialer. Begge bruger den samme 7stamp API-nøgle og endepunkter.

Næste skridt

Byg den første Zap med en testkontakt

Opret API-nøglen, test GET /templates til API ved Zapier, og opbyg derefter en kontakt-til-kort eller ordre-til-stempler handling. Tilføj Catch Hook, når det udgående flow har et bevist testresultat.