Maak een kaart na een nieuw CRM contact
Gebruik het CRM contact ID als External ID, maak een 7stamp kaartuitnodiging en stuur vervolgens de geretourneerde installatie URL via uw gebruikelijke e-mail, SMS of berichtstap.
Automatiseringsgids zonder code
Verbind 7stamp met Make — stap voor stap
ImplementatiegidsGebruik Make om 7stamp te verbinden met een CRM, POS, online winkel, spreadsheet, berichtentool of een ander systeem dat gegevens naar een scenario kan sturen. De productieklare route van vandaag is de app Make HTTP voor 7stamp API oproepen en de Custom webhook van Make voor inkomende 7stamp gebeurtenissen.
Er is nog geen openbare app 7stamp in de appkiezer van Make. Wacht niet op één: voeg HTTP → Make a request toe, gebruik de exacte URL, methode, Bearer header en JSON hieronder, en breng vervolgens de velden uit uw bronmodule in kaart. Dit is dezelfde 7stamp Integration API die een toekomstige connector zou gebruiken.
Kies het eerste scenario dat bij uw workflow past
Begin met één gebeurtenis en één resultaat. Zodra de testgegevens correct zijn, voegt u er filters, routers, CRM updates en vervolgberichten omheen toe.
Stempels toevoegen na een betaalde bestelling
Activeer het scenario vanuit een betaalde POS of e-commerce bestelling. Breng de stabiele klant ID in kaart en bestel ID in Scan a Card, en gebruik vervolgens een bedrag of een expliciete postzegeltelling.
Stuur een beloningsopvolging
Wanneer een kaartgebeurtenis een beloning of voucher rapporteert, vertakt u het scenario: update de CRM, breng het team op de hoogte en stuur alleen een portemonnee-kaartpush of e-mail wanneer dat nodig is.
Beheer een systeem zonder een native Make app
Gebruik de HTTP module van Make om 7stamp rechtstreeks aan te roepen. Dit is de universele keuze voor een aangepaste POS, ERP, boekingsmodule of een API-eerste service.
7stamp bewerkingen waaruit u kunt bellen Make HTTP
Voeg voor elke kaart hieronder HTTP → Make a request toe en stel vervolgens de methode en URL precies in zoals weergegeven. Gebruik voor elk verzoek dezelfde sleutel Bearer. De vereiste toewijzing vertelt u wat u moet opgeven via uw CRM, POS of e-commercetrigger.
Make trigger
Webhooks → Custom webhook Ontvang een kaartgebeurtenis
Maak een Custom webhook in Make, kopieer de URL en plak die URL in de 7stamp profielwebhookinstellingen. Hierdoor wordt een scenario gestart waarin 7stamp een gebeurtenis verzendt zoals SCAN, REWARD_EARNED of VOUCHER_ISSUED.
- In Make
- Webhooks → Custom webhook → Toevoegen; geef het een duidelijke naam en kopieer het gegenereerde bestand URL.
- In 7stamp
- Beheerder → API & Integrations → Webhooks; plak URL, selecteer gebeurtenistypen, sla op en maak vervolgens een testgebeurtenis.
HTTP actie
POST /cards/invite Maak een actie Card Invite
Creëert een nieuwe persoonlijke installatie URL en leveringsinsertcode voor één extern contact.
- Vereist
- external_id — breng uw stal in kaart CRM/contact ID, geen naam.
- Gebruik vervolgens
- Kaart install_url uit het antwoord op uw e-mail, SMS of CRM updatestap.
HTTP actie
POST /cards/invite/bulk Bulkcreatie Card Invites
Creëert maximaal 100 uitnodigingslinks in één verzoek. Gebruik het voor een gecontroleerde migratie of campagne, niet voor een onbeperkte export van contacten.
- Vereiste
- items — een JSON array van 1–100 individuele uitnodigingsverzoekobjecten.
- Controleer
- Lees success_count, error_count en elk resultaat voordat u links verzendt.
HTTP actie
GET /cards Find Cards
Zoekt kaartrecords op External ID, met optionele sjabloon- en bronfilters.
- Vereist
- Queryparameter external_id.
- Optioneel
- external_source en template_id beperken de zoekopdracht wanneer één systeem meerdere programma's heeft.
HTTP actie
GET /cards/{user_card_id} Ontvang een kaartdetail
Leest de volledige status van één kaart wanneer een eerdere stap de interne User Card ID heeft geretourneerd.
- Vereist
- Vervang {user_card_id} door het interne ID geretourneerd door een vertrouwd 7stamp antwoord.
- Vermijd
- Raad of bewaar een kaart ID uit een ander profiel niet.
HTTP actie
POST /cards/scan Een kaart scannen
Voegt stempels toe vanaf een aankoopbedrag of een expliciete telling. Het accepteert User Card ID of External ID en kan de externe bestelreferentie behouden.
- Identiteit
- Gebruik external_id en optioneel external_source; user_card_id wint als beide worden geleverd.
- Aankoop
- Gebruik bedrag voor op bedragen gebaseerde kaarten of stamps_count voor een expliciet nummer; stamps_count heeft prioriteit.
- Traceerbaarheid
- Breng external_order_id in kaart van de betaalde bestelling/receipt zodat gebeurtenissen 7stamp terug kunnen worden gematcht.
HTTP actie
GET /templates List Templates
Geeft een overzicht van de kaartsjablonen die beschikbaar zijn voor de toets API. Gebruik het om de verbinding te testen of om dynamisch een sjabloon te selecteren.
- Eerste test
- Dit is het veiligste eerste verzoek: het heeft geen tekst en verandert de klantgegevens niet.
- Later toewijzen
- Gebruik de ID van een actieve sjabloon alleen als template_id als het profiel meer dan één actieve sjabloon heeft.
HTTP actie
GET /templates/{template_id}/design Get Template Design
Retourneert de visuele ontwerpinstellingen voor een bekende sjabloon, handig wanneer een ander systeem een consistente kaartkeuze moet weergeven.
HTTP actie
POST /vouchers/issue Een voucher uitgeven
Geeft een voucher uit aan een kaarteigenaar geïdentificeerd door External ID of User Card ID.
- Vereist voucher
- .short_description. Richt de kaart met external_id of een bekende user_card_id.
- Geldigheid
- Gebruik validity_type met validity_value, of lees de referentie OpenAPI voor een vaste vervaldatum.
HTTP actie
POST /messages/send Een bericht verzenden
Verzendt inhoud naar de kaarteigenaar via portemonnee-kaartpush en/or e-mail, afhankelijk van het geconfigureerde kanaal en de toestemmingsregels.
- Card push
- card_push_text is beperkt tot 20 tekens en vereist een geïnstalleerde portemonneepas.
- Onderwerp plus hoofdtekst verzenden; basic HTML wordt ondersteund in het lichaam.
Make module
Full 7stamp endpoint URL HTTP → Make a request
Dit is de Make module die elke 7stamp bovenstaande route aanroept. Gebruik een volledige URL, selecteer de gedocumenteerde methode, voeg de header Bearer toe en gebruik JSON alleen als de route een hoofdtekst nodig heeft.
- Basis URL
- https://api.7loc.com/cards-api
- Koptekst
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json voor POST-verzoeken.
Drie Make scenario's die u precies kunt bouwen zoals geschreven
De namen hieronder zijn de echte Make modules. Begin met het eerste scenario, voer het uit op een wegwerpcontact en voeg pas daarna routers, filters of productieplanning toe.
1. Nieuw CRM contact → stuur een 7stamp kaartlink
Verwacht resultaat: De klant ontvangt de install_url teruggestuurd door 7stamp; uw CRM kan die URL in hetzelfde contactrecord bewaren.
- 1 Maak een scenario en voeg uw CRM's Nieuw/Created Contacttrigger toe. Kies voor Kommo de trigger voor het maken van contactpersonen en voer deze eenmaal uit om een voorbeeldcontact te laden.
- 2 Voeg HTTP → Make a request toe. Stel de methode in op POST en URL op https://api.7loc.com/cards-api/cards/invite.
- 3 Voeg Authorization toe: Bearer YOUR_7STAMP_API_KEY en Content-Type: application/json. In de hoofdtekst JSON wijst u het contact CRM ID toe aan external_id en stelt u external_source in op een vast label, zoals kommo.
- 4 Voer de module HTTP één keer uit. Bevestig dat de uitvoer install_url, delivery_insert_code, external_id en template_id heeft.
- 5 Voeg uw e-mail/SMS/CRM updatemodule toe na HTTP en wijs install_url toe uit de uitvoer HTTP. Bewaar de URL op de CRM contactpersoon als het team deze later opnieuw moet verzenden.
Controleer: POST /cards/invite creëert altijd een nieuwe uitnodiging. Gebruik eerst Find Cards als het uw bedrijfsregel is om een nieuwe uitnodiging voor een bestaand contact te vermijden.
2. Betaalde bestelling → loyaliteitszegels toevoegen
Verwacht resultaat: Een succesvolle scanreactie omvat succes, scan_id, stamps_added, en de kaartstatus na de scan voor uw volgende stap.
- 1 Begin met de trigger POS/ecommerce Betaalde bestelling. Make Het monster bevat zeker een stabiele klant ID en de bestelling/receipt ID.
- 2 Voeg HTTP → Make a request toe met POST https://api.7loc.com/cards-api/cards/scan en dezelfde kop Bearer.
- 3 Kaart external_id van de klant, external_source van de systeemnaam en external_order_id van de bestelling ID. Voeg een bedrag toe voor op bedragen gebaseerde kaarten, of stamps_count voor een expliciet aantal postzegels.
- 4 Run once met een testbestelling. Controleer de geretourneerde succesvlag en stamps_added voordat u het scenarioschema inschakelt.
- 5 Voeg optioneel een filter toe na de stap HTTP: ga alleen verder als het succes waar is en schrijf vervolgens scan_id of stamps_added terug naar het order/CRM record.
Controleer: Gebruik dezelfde external_order_id bij nieuwe pogingen, zodat de bestelling kan worden getraceerd in latere webhook-gebeurtenissen; geen tweemaal postzegels toekennen na een onduidelijke mislukte run.
3. 7stamp gebeurtenis → update de CRM
Verwacht resultaat: Make ontvangt de 7stamp gebeurtenis onmiddellijk en kan de overeenkomende CRM record vinden via external_id en external_source.
- 1 Maak een afzonderlijk Make scenario. Voeg Webhooks → Custom webhook toe, selecteer Toevoegen, noem deze 7stamp-card-events en kopieer de gegenereerde URL.
- 2 Open in 7stamp Admin API & Integrations → Webhooks. Voeg dat URL toe en selecteer een kleine reeks gebeurtenissen, bijvoorbeeld SCAN en REWARD_EARNED.
- 3 Maak een wegwerptestscan of kaartgebeurtenis in 7stamp. Keer terug naar Make en gebruik Run once om Make de gebeurtenisgegevensstructuur te laten bepalen.
- 4 Voeg een zoekstap CRM toe met behulp van external_id. Voeg een filter of router toe op event_type zodat SCAN, REWARD_EARNED en VOUCHER_ISSUED verschillende acties kunnen ondernemen.
- 5 Voeg de actie CRM bijwerken/note toe. Wijs scanned_at, stamps_after, external_order_id en issued_vouchers alleen toe als deze velden aanwezig zijn voor het geselecteerde gebeurtenistype.
Controleer: Houd de webhook URL privé. Test een echte gebeurtenis voordat u onomkeerbare berichten, vouchers of CRM-wijzigingen inschakelt.
Haal de sleutel 7stamp API op voordat u Make
opent. Dit zijn de exacte 7stamp Admin-schermen. Maak de sleutel één keer aan, kopieer deze naar de beveiligde HTTP verbinding/keychain van Make en verwijder hem vervolgens onmiddellijk van uw klembord.
Bereid de verbinding voor voordat u gaat bouwen
Maak één API sleutel per omgeving
Ga in 7stamp Admin naar API & Integrations → API Keys → Add API Key. Sla de waarde op in de HTTP API-sleutelverbinding/keychain van Make als die optie beschikbaar is. Wijs nooit de sleutel uit een tekstveld toe, plaats deze nooit in een notitie of gebruik hem niet in een browsergerichte workflow. Een sleutel hoort bij een 7stamp werkplek/profile.
Gebruik een stabiele External ID
Breng het onveranderlijke ID in kaart van uw CRM, POS, of handelsplatform, bijvoorbeeld een CRM contactpersoon ID of klant UUID. Voeg External Source toe, zoals hubspot, shopify of poster, wanneer dezelfde ID in meer dan één systeem kan voorkomen.
Bepaal welk sjabloon van toepassing is
Wanneer het verbonden 7stamp profiel één actief kaartsjabloon heeft, kan het sjabloon leeg gelaten worden. Met meerdere sjablonen kunt u template_id bewust in kaart brengen of kiezen, zodat elke uitnodiging en scan het beoogde loyaliteitsprogramma bereikt.
Exacte Make HTTP configuratie: maak één kaartuitnodiging
Kopieer dit naar uw automatiseringsstap
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
}Bouw en test uw eerste Make scenario
Maak in 7stamp Admin een sleutel aan in API & Integrations → API Keys → Add API Key. Gebruik een afzonderlijk testprofiel/key wanneer uw accountconfiguratie dit toestaat.
Maak in Make een scenario en voeg de brontrigger toe. Voer het één keer uit voordat u het in kaart brengt, zodat u een echt voorbeeldcontact of een betaalde bestelling kunt zien.
Klik op het volgende plusje, zoek naar HTTP en kies Make een verzoek. Stel de methode, volledige URL en headers van de bewerkingskaart op deze pagina in.
Gebruik GET https://api.7loc.com/cards-api/templates als eerste verzoek. De succesvolle reactie bewijst dat de sleutel werkt zonder klantgegevens te wijzigen.
Voor routes POST selecteert u application/json en plakt u de lichaamsvorm uit deze handleiding. Breng een stal External ID in kaart; voeg template_id alleen toe als het profiel meerdere actieve sjablonen heeft.
Voer het uit met een wegwerpcontact, inspecteer de uitvoer van HTTP en wijs pas daarna de exacte antwoordvelden toe aan de volgende CRM-, e-mail- of berichtenmodule.
Wanneer moet u Make HTTP gebruiken?
Gebruik nu HTTP voor 7stamp: het is de gedocumenteerde, productieklare route, geen verminderde terugval. Kies deze optie wanneer u een 7stamp-bewerking, een nieuwe API-route of een aangepaste POS/ERP-verbinding nodig hebt. De referentie OpenAPI is de bron van waarheid voor de methode, het volledige pad, de hoofdtekst en het responsschema; de dragersleutel en basis URL blijven hetzelfde.
Ontvang 7stamp gebeurtenissen in Make
Voor een gebeurtenisgestuurd scenario voegt u Webhooks → Custom webhook toe en maakt u een webhook. Kopieer de URL, open API & Integrations → Webhooks in het 7stamp profiel, plak de URL, selecteer de gebeurtenistypen, sla op en verzend een echte testgebeurtenis. Het profiel 7stamp is eigenaar van dat abonnement; de huidige API maakt geen automatische webhook-abonnement/unsubscribe-eindpunten zichtbaar.
Er is geen openbare Make connector vereist
De instructies op deze pagina gebruiken Make modules die beschikbaar zijn voor elk Make account. Als u een toekomstige native 7stamp module wilt in plaats van HTTP, stuur ons dan de workflow die u nodig heeft; tot dan toe dekken HTTP en Custom webhooks elke gedocumenteerde 7stamp operatie.
Veelgestelde vragen
Ik kan 7stamp niet vinden in Make. Kan ik het nog automatiseren?
Ja. Er is vandaag geen openbare 7stamp app in Make. Voeg HTTP > Make een verzoek toe, gebruik het volledige 7stamp eindpunt URL en verzend Authorization: Bearer gevolgd door uw 7stamp API sleutel. HTTP kan elk gedocumenteerd eindpunt aanroepen.
Waar haal ik het token voor de Make-verbinding?
Open in 7stamp Admin API Integraties, vervolgens API Keys en vervolgens Add API Key. De sleutel heeft betrekking op de werkplek/profile waar deze is gemaakt. Gebruik dus waar mogelijk een testprofiel voor testscenario's.
Welke ID moet ik toewijzen als External ID?
Gebruik de stabiele identificatie uit het bronsysteem, bij voorkeur een CRM contactpersoon ID of klant UUID. Gebruik geen weergavenaam. Een telefoonnummer of e-mailadres kan werken, maar kan veranderen en moet consequent worden behandeld.
Hoe krijg ik 7stamp gebeurtenissen in Make?
Maak een Webhooks > Custom webhook in Make en plak de gegenereerde URL in de webhookinstellingen van het 7stamp profiel. Gebruik na levering een Make filter of router om de binnenkomende event_type af te handelen.
Gerelateerde pagina's
Volgende stap
Klaar om de eerste loyaliteitsactie te automatiseren?
Maak de sleutel API, test List Templates en bouw één uitnodigings- of scanscenario met een wegwerpcontact. Voeg routers en berichten pas toe als de eenvoudige stroom betrouwbaar is.