Guia d'automatització sense codi
Utilitzeu Make per connectar 7stamp amb un CRM, POS, botiga en línia, full de càlcul, eina de missatgeria o qualsevol sistema que pugui enviar dades a un escenari. La ruta preparada per a la producció d'avui és l'aplicació HTTP de Make per a les trucades 7stamp API i la Custom webhook de Make per als esdeveniments 7stamp entrants.
Encara no hi ha cap aplicació pública 7stamp al selector d'aplicacions de Make. No esperis cap: afegiu HTTP → Make a request, utilitzeu el mètode exacte URL, la capçalera Bearer i JSON a continuació i, a continuació, assigneu els camps del vostre mòdul font. Això és el mateix 7stamp Integration API que faria servir un connector futur.
Comenceu amb un esdeveniment i un resultat. Un cop les dades de prova siguin correctes, afegiu filtres, encaminadors, actualitzacions CRM i missatges de seguiment al seu voltant.
Utilitzeu el contacte CRM ID com a External ID, creeu una invitació a la targeta 7stamp i, a continuació, envieu la instal·lació retornada URL a través del vostre correu electrònic habitual, SMS o el pas de missatgeria.
Activa l'escenari des d'una comanda pagada POS o de comerç electrònic. Assenyaleu el seu client estable ID i demaneu ID a Scan a Card i, a continuació, utilitzeu una quantitat o un recompte de segell explícit.
Quan un esdeveniment de targeta informa d'una recompensa o un val, ramifica l'escenari: actualitza el CRM, notifica'l a l'equip i envia una targeta de cartera o un correu electrònic només quan sigui necessari.
Utilitzeu el mòdul HTTP de Make per trucar directament al 7stamp. Aquesta és l'opció universal per a un motor de reserves personalitzat POS, ERP o qualsevol primer servei API.
Per a cada targeta següent, afegiu HTTP → Make a request i, a continuació, configureu el mètode i URL exactament com es mostra. Utilitzeu la mateixa clau Bearer per a cada sol·licitud. El mapeig requerit us indica què heu de subministrar des del vostre activador CRM, POS o de comerç electrònic.
Webhooks → Custom webhook Creeu un Custom webhook a Make, copieu-ne URL i, a continuació, enganxeu aquest URL al webhook de configuració del perfil 7stamp. Això comença un escenari quan 7stamp envia un esdeveniment com ara SCAN, REWARD_EARNED o VOUCHER_ISSUED.
POST /cards/invite Crea una instal·lació personal nova URL i un codi d'entrega per a un contacte extern.
POST /cards/invite/bulk Crea fins a 100 enllaços d'invitació en una sol·licitud. Utilitzeu-lo per a una migració o campanya controlada, no per a una exportació de contactes il·limitada.
GET /cards Cerca els registres de la targeta per External ID, amb plantilles opcionals i filtres font.
GET /cards/{user_card_id} Llegeix l'estat complet d'una targeta quan un pas anterior ha retornat el seu User Card ID intern.
POST /cards/scan Afegeix segells d'un import de compra o un recompte explícit. Accepta User Card ID o External ID i pot conservar la referència de la comanda externa.
GET /templates Llista les plantilles de targetes disponibles per a la clau API. Utilitzeu-lo per provar la connexió o per seleccionar una plantilla de forma dinàmica.
GET /templates/{template_id}/design Retorna la configuració del disseny visual d'una plantilla coneguda, útil quan un altre sistema necessita mostrar una elecció de targeta coherent.
POST /vouchers/issue Emet un val al propietari d'una targeta identificat per External ID o User Card ID.
POST /messages/send Envia contingut al propietari de la targeta mitjançant push-card wallet i /or correu electrònic, subjecte al canal configurat i a les regles de consentiment.
Full 7stamp endpoint URL Aquest és el mòdul Make que truca a totes les rutes 7stamp anteriors. Utilitzeu un URL complet, seleccioneu el mètode documentat, afegiu la capçalera Bearer i utilitzeu JSON només quan la ruta necessiti un cos.
Els noms següents són els mòduls Make reals. Comenceu amb el primer escenari, executeu-lo amb un contacte d'un sol ús i només després afegiu encaminadors, filtres o programació de producció.
Resultat esperat: El client rep el install_url retornat per 7stamp; el vostre CRM pot conservar aquest URL al mateix registre de contacte.
Comproveu: POST /cards/invite sempre crea una nova invitació. Feu servir primer Find Cards si la vostra regla empresarial és evitar una altra invitació per a un contacte existent.
Resultat esperat: Una resposta d'escaneig correcta inclou l'èxit, scan_id, stamps_added i l'estat de la targeta posterior a l'escaneig per al següent pas.
Comproveu: Utilitzeu el mateix external_order_id en els reintents perquè l'ordre es pugui rastrejar en esdeveniments de webhook posteriors; no concediu segells dues vegades després d'una carrera fallida poc clara.
Resultat esperat: Make rep l'esdeveniment 7stamp immediatament i pot trobar el registre coincident ⟦6382⟦6382CRM external_source.
Comproveu: Manteniu el webhook URL privat. Prova un esdeveniment real abans d'activar missatges irreversibles, vals o canvis CRM.
Aquestes són les pantalles exactes de 7stamp Admin. Creeu la clau una vegada, copieu-la a la connexió segura de MakeHTTP/keychain i, a continuació, traieu-la immediatament del porta-retalls.
A 7stamp Admin, aneu a API & Integrations → API Keys → Add API Key. Emmagatzemeu el valor a la connexió de clau HTTP de Make API/keychain quan aquesta opció estigui disponible. No assigneu mai la clau d'un camp de text, no la col·loqueu en una nota ni l'utilitzeu en un flux de treball orientat al navegador. Una clau pertany a un 7stamp lloc de treball/profile.
Assigna l'immutable ID des del vostre ⟦6208⟦2, 6208⟦ plataforma, per exemple, un contacte CRM ID o un client UUID. Afegiu External Source com ara hubspot, shopify o pòster quan el mateix identificador pugui aparèixer en més d'un sistema.
Quan el perfil 7stamp connectat té una plantilla de targeta activa, la plantilla es pot deixar buida. Amb diverses plantilles, mapeu o trieu template_id deliberadament perquè cada invitació i escaneig arribi al programa de fidelització previst.
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
}A 7stamp Admin, creeu una clau en ⟦641. Utilitzeu un perfil de prova independent/key quan la configuració del vostre compte ho permeti.
A Make, creeu un escenari i afegiu l'activador d'origen. Executeu-lo una vegada abans de fer el mapa perquè pugueu veure un contacte de mostra real o una comanda de pagament.
Feu clic al següent plus, cerqueu HTTP i trieu Make una sol·licitud. Estableix el mètode, URL complet i les capçaleres de la targeta d'operacions d'aquesta pàgina.
Utilitzeu GET https://api.7loc.com/cards-api/templates com a primera sol·licitud. La seva resposta satisfactòria demostra que la clau funciona sense canviar cap dada del client.
Per a les rutes POST, seleccioneu application/json i enganxeu la forma del cos d'aquesta guia. Mapa un estable External ID; afegiu template_id només si el perfil té diverses plantilles actives.
Executeu amb un contacte d'un sol ús, inspeccioneu la sortida HTTP i només aleshores assigneu els seus camps de resposta exactes al següent CRM, correu electrònic o mòdul de missatgeria.
Utilitzeu ara HTTP per a 7stamp: és la ruta documentada i preparada per a la producció, no una alternativa reduïda. Trieu-lo sempre que necessiteu una operació 7stamp, una nova ruta API o una connexió personalitzada POS/ERP. La referència OpenAPI és la font de veritat per al mètode, el camí complet, el cos i l'esquema de resposta; la clau del portador i la base URL es mantenen iguals.
Per a un escenari basat en esdeveniments, afegiu Webhooks → Custom webhook i creeu un webhook. Copieu el seu URL, obriu API & Integrations → Webhooks al perfil 7stamp, enganxeu el URL, seleccioneu els tipus d'esdeveniment, deseu i envieu un esdeveniment de prova real. El perfil 7stamp és propietari d'aquesta subscripció; l'actual API no exposa els punts finals de subscripció automàtica del webhook/unsubscribe.
Les instruccions d'aquesta pàgina utilitzen mòduls Make que estan disponibles per a tots els comptes Make. Si voleu un futur mòdul 7stamp natiu en comptes de HTTP, envieu-nos el flux de treball que necessiteu; fins aleshores, HTTP i Custom webhook cobreixen totes les operacions 7stamp documentades.
Sí. Avui no hi ha cap aplicació pública 7stamp a Make. Afegiu HTTP > Make una sol·licitud, utilitzeu el punt final complet 7stamp URL i envieu Authorization: Bearer seguit de la vostra clau 7stamp API. HTTP pot trucar a tots els punts finals documentats.
A 7stamp Admin, obriu API Integracions, després API Keys i després Add API Key. La clau s'aplica al lloc de treball/profile que la va crear, així que utilitzeu un perfil de prova per als escenaris de prova sempre que sigui possible.
Utilitzeu l'identificador estable del sistema d'origen, preferiblement un contacte CRM ID o un client UUID. No utilitzeu un nom de visualització. Un número de telèfon o un correu electrònic poden funcionar, però poden canviar i s'han de gestionar de manera coherent.
Creeu un webhook > Custom webhook a Make i, a continuació, enganxeu el URL generat a la configuració del webhook del perfil 7stamp. Utilitzeu un filtre o encaminador Make després del lliurament per gestionar el event_type entrant.
Següent pas
Creeu la clau API, proveu List Templates i creeu un escenari d'invitació o d'escaneig amb un contacte d'un sol ús. Afegiu encaminadors i missatgeria només després que aquest flux senzill sigui fiable.