Skapa ett kort efter en ny CRM-kontakt
Använd CRM-kontakten ID som External ID, skapa en 7stamp-kortinbjudan och skicka sedan den returnerade installationen URL via din vanliga e-post, SMS eller meddelandesteg.
Automationsguide utan kod
Anslut 7stamp till Make — steg för steg
ImplementeringsguideAnvänd Make för att ansluta 7stamp med en CRM, POS, onlinebutik, kalkylblad, meddelandeverktyg eller vilket system som helst som kan skicka data till ett scenario. Den produktionsklara rutten idag är Makes HTTP app för 7stamp API samtal och Makes Custom webhook för inkommande 7stamp händelser.
Det finns ingen offentlig 7stamp-app i Makes appväljare än. Vänta inte på en: lägg till HTTP → Make a request, använd den exakta URL, metoden, Bearer header och JSON nedan, mappa sedan fälten från din källmodul. Detta är samma 7stamp Integration API som en framtida kontakt skulle använda.
Välj det första scenariot som matchar ditt arbetsflöde
Börja med en händelse och ett resultat. När testdata är korrekta, lägg till filter, routrar, CRM uppdateringar och uppföljningsmeddelanden runt det.
Lägg till stämplar efter en betald beställning
Utlösa scenariot från en betald POS eller e-handelsorder. Kartlägg sin stabila kund ID och beställ ID till Skanna ett kort, använd sedan ett belopp eller explicit stämpelräkning.
Skicka en belöningsuppföljning
När en korthändelse rapporterar en belöning eller kupong, förgrena scenariot: uppdatera CRM, meddela teamet och skicka ett plånbokskortstryck eller e-post endast när det behövs.
Hantera ett system utan en inbyggd Make-app
Använd Makes HTTP-modul för att ringa 7stamp direkt. Detta är det universella valet för en anpassad POS, ERP, bokningsmotor eller någon API-första service.
7stamp operationer att ringa från Make HTTP
För varje kort nedan, lägg till HTTP → Make a request, ställ sedan in metoden och URL exakt som visas. Använd samma Bearer-nyckel för varje begäran. Den nödvändiga mappningen talar om för dig vad du ska tillhandahålla från din CRM, POS eller e-handelstrigger.
Make trigger
Webhooks → Custom webhook Ta emot en korthändelse
Skapa en Custom webhook i Make, kopiera dess URL och klistra sedan in den URL i profilinställningarna för ⟦19574hook. Detta startar ett scenario när 7stamp skickar en händelse som SCAN, REWARD_EARNED eller VOUCHER_ISSUED.
- In Make
- Webhooks → Custom webhook → Lägg till; ge den ett tydligt namn och kopiera dess genererade URL.
- I 7stamp
- Admin → API & Integrations → Webhooks; klistra in URL, välj händelsetyper, spara och skapa sedan en testhändelse.
HTTP-åtgärd
POST /cards/invite Skapa en Card Invite
Skapar en ny personlig installation URL och leverans-infoga kod för en extern kontakt.
- Obligatoriskt
- external_id — kartlägg ditt stall CRM/contact ID, inte ett namn.
- Använd sedan
- Karta install_url från svaret till din e-post, SMS eller CRM uppdateringssteget.
HTTP åtgärd
POST /cards/invite/bulk Skapa bulk Card Invites
Skapar upp till 100 inbjudningslänkar i en begäran. Använd den för en kontrollerad migrering eller kampanj, inte en obegränsad kontaktexport.
- Obligatoriska
- objekt — en JSON array med 1–100 individuella objekt för inbjudningsförfrågningar.
- Kontrollera
- Läs success_count, error_count och varje resultat innan du skickar några länkar.
HTTP åtgärd
GET /cards Find Cards
Hittar kortposter efter External ID, med valfria mallar och källfilter.
- Obligatorisk
- Frågeparameter external_id.
- Valfritt
- external_source och template_id begränsar sökningen när ett system har flera program.
HTTP åtgärd
GET /cards/{user_card_id} Få en kortdetalj
Läser hela statusen för ett kort när ett tidigare steg har returnerat sin interna User Card ID.
- Krävs
- Ersätt {user_card_id} med den interna ID som returneras av ett pålitligt 7stamp-svar.
- Undvik
- Gissa eller lagra inte ett kort ID från en annan profil.
HTTP åtgärd
POST /cards/scan Skanna ett kort
Lägger till stämplar från ett köpbelopp eller en explicit räkning. Den accepterar User Card ID eller External ID och kan behålla den externa orderreferensen.
- Identitet
- Använd external_id och valfritt external_source; user_card_id vinner om båda medföljer.
- Köp
- Använd belopp för beloppsbaserade kort eller stamps_count för ett explicit nummer; stamps_count har prioritet.
- Spårbarhet
- Karta external_order_id från den betalda beställningen/receipt så att 7stamp händelser kan matchas tillbaka.
HTTP åtgärd
GET /templates List Templates
Listar de kortmallar som är tillgängliga för nyckeln API. Använd den för att testa anslutningen eller för att välja en mall dynamiskt.
- Första testet
- Detta är den säkraste första begäran: den har ingen kropp och ändrar inte kunddata.
- Karta senare
- Använd en aktiv malls id som template_id endast när profilen har mer än en aktiv mall.
HTTP åtgärd
GET /templates/{template_id}/design Get Template Design
Returnerar de visuella designinställningarna för en känd mall, användbart när ett annat system behöver visa ett konsekvent kortval.
HTTP åtgärd
POST /vouchers/issue Utfärda en kupong
Utfärdar en kupong till en kortägare identifierad av External ID eller User Card ID.
- Obligatorisk
- -kupong.short_description. Rikta in kortet med external_id eller en känd user_card_id.
- Giltighet
- Använd validity_type med validity_value, eller läs referensen OpenAPI för ett fast utgångsdatum.
HTTP åtgärd
POST /messages/send Skicka ett meddelande
Skickar innehåll till kortägaren via plånbok-kort-push och /or e-post, med förbehåll för de konfigurerade kanalerna och samtyckesreglerna.
- Kort push
- card_push_text är begränsad till 20 tecken och kräver ett installerat plånbokspass.
- E-post
- Skicka ämne plus brödtext; basic HTML stöds i kroppen.
Make modul
Full 7stamp endpoint URL HTTP → Make a request
Detta är Make-modulen som anropar varje 7stamp rutt ovan. Använd en komplett URL, välj den dokumenterade metoden, lägg till rubriken Bearer och använd JSON endast när rutten behöver en text.
- Bas URL
- https://api.7loc.com/cards-api
- Header
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json för POST förfrågningar.
Tre Make scenarier du kan bygga exakt som skrivna
Namnen nedan är de riktiga Make modulerna. Börja med det första scenariot, kör det mot en engångskontakt och lägg först sedan till routrar, filter eller produktionsschemaläggning.
1. Ny CRM kontakt → skicka en 7stamp kortlänk
Förväntat resultat: Kunden får install_url returnerad av 7stamp; din CRM kan behålla den URL i samma kontaktpost.
- 1 Skapa ett scenario och lägg till din CRMs Nya/Created kontaktutlösare. För Kommo, välj utlösaren för att skapa kontakt och kör den en gång för att ladda en provkontakt.
- 2 Lägg till HTTP → Make a request. Ställ in metod till POST och URL till https://api.7loc.com/cards-api/cards/invite.
- 3 Lägg till Authorization: Bearer YOUR_7STAMP_17⟧ och Content-Type: application/json. I JSON-kroppen, mappa CRM-kontakten ID till external_id och ställ in external_source till en fast etikett som kommo.
- 4 Kör modulen HTTP en gång. Bekräfta att utgången har install_url, delivery_insert_code, external_id och template_id.
- 5 Lägg till din e-post/SMS/CRM uppdateringsmodul efter HTTP och kartan install_url från HTTP-utgången. Spara URL på CRM-kontakten om laget måste skicka det igen senare.
Kontrollera: POST /cards/invite skapar alltid en ny inbjudan. Använd Find Cards först om din affärsregel är att undvika en ny inbjudan till en befintlig kontakt.
2. Betald beställning → lägg till lojalitetsstämplar
Förväntat resultat: Ett lyckat skanningssvar inkluderar framgång, scan_id, stamps_added och statusen efter skanningskortet för ditt nästa steg.
- 1 Börja från utlösaren POS/ecommerce Betald order. Make säker på att dess prov innehåller en stabil kund ID och ordern/receipt ID.
- 2 Lägg till HTTP → Make a request med POST https://api.7loc.com/cards-api/cards/scan och samma Bearer rubrik.
- 3 Karta external_id från kunden, external_source från systemnamnet och external_order_id från beställningen ID. Lägg till belopp för beloppsbaserade kort, eller stamps_count för ett uttryckligt antal stämplar.
- 4 Run once med en testorder. Kontrollera den returnerade framgångsflaggan och stamps_added innan du aktiverar scenarioschemat.
- 5 Lägg till ett filter efter steget HTTP: fortsätt endast när framgången är sann, skriv sedan scan_id eller stamps_added tillbaka till order/CRM-posten.
Kontrollera: Använd samma external_order_id vid återförsök så att ordern kan spåras i senare webhook-händelser; ge inte ut frimärken två gånger efter en otydlig misslyckad körning.
3. 7stamp-händelsen → uppdatera CRM
Förväntat resultat: Make tar emot 7stamp-händelsen omedelbart och kan hitta matchningen via ⟦6 external_id och external_source.
- 1 Skapa ett separat Make-scenario. Lägg till Webhooks → Custom webhook, välj Lägg till, namnge det 7stamp-korthändelser och kopiera den genererade URL.
- 2 I 7stamp Admin, öppet API & Integrations → Webhooks. Lägg till URL och välj en liten uppsättning händelser, till exempel SCAN och REWARD_EARNED.
- 3 Skapa en engångstestskanning eller korthändelse i 7stamp. Återgå till Make och använd Run once för att låta Make bestämma händelsedatastrukturen.
- 4 Lägg till ett CRM söksteg med external_id. Lägg till ett filter eller en router på event_type så att SCAN, REWARD_EARNED och VOUCHER_ISSUED kan vidta olika åtgärder.
- 5 Lägg till åtgärden CRM update/note. Karta scanned_at, stamps_after, external_order_id och issued_vouchers endast när dessa fält finns för den valda händelsetypen.
Kontrollera: Håll webbhooken URL privat. Testa en riktig händelse innan du slår på oåterkalleliga meddelanden, kuponger eller CRM ändringar.
Hämta 7stamp API-nyckeln innan du öppnar Make
Det här är de exakta 7stamp Admin-skärmarna. Skapa nyckeln en gång, kopiera den till Makes säkra HTTP anslutning/keychain och ta sedan omedelbart bort den från ditt urklipp.
Förbered anslutningen innan du bygger
Skapa en API nyckel per miljö
I 7stamp Admin, gå till API & Integrations → API Keys → Add API Key. Lagra värdet i Makes HTTP API-nyckelanslutning/keychain när det alternativet är tillgängligt. Mappa aldrig nyckeln från ett textfält, placera den i en anteckning eller använd den i ett arbetsflöde som vänder sig till webbläsaren. En nyckel tillhör en 7stamp arbetsplats/profile.
Använd ett stall External ID
Kartlägga den oföränderliga ID från din ⟦19,6 POS, eller handelsplattform – till exempel en CRM kontakt ID eller kund UUID. Lägg till External Source som hubspot, shopify eller poster när samma identifierare kan förekomma i mer än ett system.
Bestäm vilken mall som gäller
När den anslutna 7stamp-profilen har en aktiv kortmall, kan mallen lämnas tom. Med flera mallar, kartlägg eller välj template_id medvetet så att varje inbjudan och skanning når det avsedda lojalitetsprogrammet.
Exakt Make HTTP-inställning: skapa en kortinbjudan
Kopiera detta till ditt automatiseringssteg
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 och testa ditt första Make-scenario
I 7stamp Admin9, skapa en nyckel på 79. Använd en separat testprofil/key när ditt kontoinställningar tillåter det.
I Make, skapa ett scenario och lägg till källutlösaren. Kör det en gång innan kartläggning så att du kan se en riktig provkontakt eller betald order.
Klicka på nästa plus, sök efter HTTP och välj Make en begäran. Ställ in metoden, fullständig URL, och rubriker från operationskortet på den här sidan.
Använd GET https://api.7loc.com/cards-api/templates som första begäran. Dess framgångsrika svar bevisar att nyckeln fungerar utan att ändra kunddata.
För POST rutter, välj application/json och klistra in kroppsformen från den här guiden. Kartlägga ett stall External ID; lägg till template_id endast om profilen har flera aktiva mallar.
Kör med en engångskontakt, inspektera HTTP-utgången och mappa först därefter dess exakta svarsfält till nästa CRM-, e-post- eller meddelandemodul.
När ska du använda Make HTTP?
Använd HTTP för 7stamp nu: det är den dokumenterade, produktionsklara vägen, inte en reducerad reserv. Välj det när du behöver en 7stamp-operation, en ny API-rutt eller en anpassad POS/ERP-anslutning. Referensen OpenAPI är källan till sanning för metoden, hela vägen, kroppen och svarsschemat; bärnyckeln och basen URL förblir desamma.
Ta emot 7stamp händelser i Make
För ett händelsedrivet scenario, lägg till Webhooks → Custom webhook och skapa en webhook. Kopiera dess URL, öppna API & Integrations → Webhooks i profilen 7stamp, klistra in URL, välj händelsetyper, spara och skicka en riktig testhändelse. Profilen 7stamp äger den prenumerationen; den nuvarande API exponerar inte automatiska webhook-prenumerationer/unsubscribe slutpunkter.
Ingen offentlig Make-anslutning krävs
Instruktionerna på den här sidan använder Make-moduler som är tillgängliga för alla Make-konton. Om du vill ha en framtida inbyggd 7stamp-modul snarare än HTTP, skicka oss det arbetsflöde du behöver; tills dess täcker HTTP och Custom webhooks varje dokumenterad 7stamp operation.
Vanliga frågor
Jag kan inte hitta 7stamp i Make. Kan jag fortfarande automatisera 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.
Var får jag token för Make-anslutningen?
I 7stamp Admin, öppna API integrationer, sedan API Keys, sedan Add API Key. Nyckeln är anpassad till arbetsplatsen/profile som skapade den, så använd en testprofil för testscenarier när det är möjligt.
Vilken identifierare ska jag mappa som External ID?
Använd den stabila identifieraren från källsystemet, helst en CRM kontakt ID eller kund UUID. Använd inte ett visningsnamn. Ett telefonnummer eller e-post kan fungera, men kan ändras och bör hanteras konsekvent.
Hur får jag in 7stamp händelser till Make?
Skapa en Webhooks > Custom webhook i Make, klistra sedan in dess genererade URL i webhook-inställningarna för profilen 7stamp. Använd ett Make-filter eller en router efter leverans för att hantera inkommande event_type.
Nästa steg
Är du redo att automatisera den första lojalitetsåtgärden?
Skapa API-nyckeln, testa List Templates och bygg ett inbjudnings- eller skanningsscenario med en engångskontakt. Lägg till routrar och meddelanden först efter att det enkla flödet är tillförlitligt.