Hozzon létre egy kártyát egy új CRM névjegy után
Használja a CRM kapcsolattartót ID mint External ID, hozzon létre egy 7stamp kártyameghívót, majd küldje el a visszaküldött telepítést URL a szokásos e-mail-címen, SMS lépésben vagy üzenetben.
Kód nélküli automatizálási útmutató
Csatlakoztassa 7stamp a Make számhoz – lépésről lépésre
Megvalósítási útmutatóA Make segítségével csatlakoztassa a 7stamp számot egy CRM, POS számhoz, online bolthoz, táblázatkezelőhöz, üzenetküldő eszközhöz vagy bármely olyan rendszerhez, amely adatokat küldhet egy forgatókönyvbe. A gyártásra kész útvonal ma a Make HTTP alkalmazása a 7stamp API hívásokhoz és a Make Custom webhook a bejövő 7stamp eseményekhez.
Még nincs nyilvános 7stamp alkalmazás a Make alkalmazásválasztójában. Ne várjon egyet: adja hozzá a HTTP → Make a request értéket, használja a pontos URL metódust, az Bearer fejlécet és az JSON alábbit, majd képezze le a mezőket a forrásmodulból. Ez ugyanaz a 7stamp Integration API, amelyet egy jövőbeni csatlakozó is használna.
Válassza ki az első forgatókönyvet, amely megfelel a munkafolyamatának
Kezdje egy eseménnyel és egy eredménnyel. Ha a tesztadatok helyesek, adjon hozzá szűrőket, útválasztókat, CRM frissítéseket és nyomon követési üzeneteket.
Bélyegző hozzáadása a kifizetett megrendelés után
Indítsa el a forgatókönyvet fizetett POS vagy e-kereskedelmi megrendelésből. Állítsa be stabil ügyfelét (ID), rendelje meg a ID számot a Kártya szkennelése alatt, majd használjon összeget vagy kifejezett bélyegszámot.
Jutalomkövetés küldése
Ha egy kártyaesemény jutalomról vagy utalványról számol be, ágazza fel a forgatókönyvet: frissítse a CRM számot, értesítse a csapatot, és csak szükség esetén küldjön pénztárcakártya-leküldést vagy e-mailt.
Natív Make alkalmazás nélküli rendszer kezelése
Használja a Make HTTP modulját a 7stamp közvetlen hívásához. Ez az univerzális választás egyéni POS, ERP, foglalási motorhoz vagy bármely API-első szolgáltatáshoz.
7stamp műveletek a Make HTTP számról hívható
Minden alábbi kártyához adja hozzá a HTTP → Make a request értéket, majd állítsa be a módszert és az URL értéket pontosan az ábrán látható módon. Minden kéréshez ugyanazt a Bearer kulcsot használja. A szükséges leképezés megmondja, hogy mit kell megadnia a CRM, POS vagy e-kereskedelmi aktiválási szabályból.
Make trigger
Webhooks → Custom webhook Kártyaesemény fogadása
Hozzon létre egy Custom webhook-t a Make mappában, másolja ki a URL-t, majd illessze be a URL értéket a ⟦15750 webprofil beállításaiba. Ez elindít egy forgatókönyvet, amikor a 7stamp eseményt küld, például SCAN, REWARD_EARNED vagy VOUCHER_ISSUED.
- In Make
- Webhooks → Custom webhook → Hozzáadás; adj neki egyértelmű nevet, és másold ki a generált URL-t.
- Itt: 7stamp
- Admin → API & Integrations → Webhooks; illessze be a URL-t, válassza ki az eseménytípusokat, mentse el, majd hozzon létre egy teszteseményt.
HTTP műveletet
POST /cards/invite Hozzon létre egy Card Invite
Új személyes telepítést URL és kézbesítési beszúrási kódot hoz létre egy külső kapcsolathoz.
- Kötelező
- external_id — térképezze fel az istállóját CRM/contact ID, ne egy nevet.
- Ezután használja a
- Térképet install_url az e-mailben kapott válaszból, SMS vagy CRM frissítési lépést.
HTTP művelet
POST /cards/invite/bulk Tömeges létrehozás Card Invites
Akár 100 meghívó hivatkozást hoz létre egy kérelemben. Ellenőrzött migrációhoz vagy kampányhoz használja, nem pedig korlátlan névjegyexportáláshoz.
- Kötelező
- elem – egy JSON tömb, amely 1–100 egyedi meghívási kérelem objektumot tartalmaz.
- Jelölje be:
- Olvassa el a success_count, error_count és az egyes találatokat, mielőtt bármilyen linket elküldene.
HTTP művelet
GET /cards Find Cards
Megkeresi a External ID szerinti kártyarekordokat, opcionális sablonnal és forrásszűrőkkel.
- Kötelező
- Lekérdezési paraméter external_id.
- Opcionális
- external_source és template_id szűkítik a keresést, ha egy rendszer több programmal rendelkezik.
HTTP művelet
GET /cards/{user_card_id} Kérjen kártyaadatokat
Beolvassa egy kártya teljes állapotát, amikor egy korábbi lépés visszaadta a belső User Card ID-t.
- Kötelező
- Cserélje ki a {user_card_id} értéket a megbízható 7stamp válasz által visszaadott belső ID-re.
- Kerülje el a
- Ne találjon ki és ne tároljon más profilból származó ID kártyát.
HTTP művelet
POST /cards/scan Kártya beolvasása
Bélyegeket ad hozzá a vásárlási összeghez vagy egy kifejezett számhoz. Elfogadja a User Card ID vagy External ID kódot, és megtarthatja a külső rendelési hivatkozást.
- Identitás
- A external_id és opcionális external_source használata; user_card_id nyer, ha mindkettő rendelkezésre áll.
- Vásárlás
- Használjon összeget összegalapú kártyákhoz vagy stamps_count kifejezett számhoz; A stamps_count elsőbbséget élvez.
- Nyomon követhetőség
- Térkép external_order_id a kifizetett rendelésből/receipt, így a 7stamp eseményeket vissza lehet párosítani.
HTTP művelet
GET /templates List Templates
Felsorolja a API gombhoz elérhető kártyasablonokat. Használja a kapcsolat tesztelésére vagy egy sablon dinamikus kiválasztására.
- Első teszt
- Ez a legbiztonságosabb első kérés: nincs törzse, és nem módosítja az ügyféladatokat.
- Térkép később
- Csak akkor használja az aktív sablon azonosítóját, mint template_id, ha a profilnak egynél több aktív sablonja van.
HTTP művelet
GET /templates/{template_id}/design Get Template Design
Egy ismert sablon vizuális tervezési beállításait adja vissza, ami akkor hasznos, ha egy másik rendszernek konzisztens kártyaválasztást kell megjelenítenie.
HTTP művelet
POST /vouchers/issue Utalvány kiállítása
Utalványt állít ki a External ID vagy ⟦15809 kártyatulajdonosnak.
- Required
- értékű utalvány szükséges.short_description. Célozza meg a kártyát a következővel: external_id vagy egy ismert user_card_id.
- Érvényesség
- Használja a validity_type-t a validity_value-vel, vagy olvassa el az OpenAPI hivatkozást a rögzített lejárati dátumhoz.
HTTP művelet
POST /messages/send Üzenet küldése
Tartalmat küld a kártyatulajdonosnak Wallet-Card push és /or e-mail útján, a beállított csatorna és a beleegyezési szabályok betartásával.
- Card push
- card_push_text legfeljebb 20 karakterből állhat, és telepített pénztárcabérlet szükséges.
- Tárgy és törzs küldése; alap HTML támogatott a testben.
Make modul
Full 7stamp endpoint URL HTTP → Make a request
Ez a Make modul, amely minden ⟦15823⟟ feletti útvonalat hív. Használjon teljes URL-t, válassza ki a dokumentált módszert, adja hozzá a Bearer fejlécet, és csak akkor használja a JSON kódot, ha az útvonalnak testre van szüksége.
- Alap URL
- https://api.7loc.com/cards-api
- Fejléc
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json POST kérések esetén.
Három Make forgatókönyvet készíthet pontosan úgy, ahogy írva van
Az alábbi nevek a valódi Make modulok. Kezdje az első forgatókönyvvel, futtassa egy eldobható érintkezőn, és csak ezután adjon hozzá útválasztókat, szűrőket vagy gyártásütemezést.
1. Új CRM kapcsolat → 7stamp kártyahivatkozás küldése
Várt eredmény: Az ügyfél megkapja a install_url számot, amelyet 7stamp küld vissza; az Ön CRM megőrizheti a URL számot ugyanabban a kapcsolatfelvételi nyilvántartásban.
- 1 Hozzon létre egy forgatókönyvet, és adja hozzá a CRM új/Created kapcsolatfelvételi aktiválóját. A Kommo esetén válassza ki a kapcsolatlétrehozási eseményindítót, és futtassa egyszer a mintanévjegy betöltéséhez.
- 2 HTTP → Make a request hozzáadása. A metódus beállítása POST és URL értéke https://api.7loc.com/cards-api/cards/invite.
- 3 Authorization hozzáadása: Bearer YOUR_7STAMP_15_K893 és Content-Type: application/json. A JSON törzsben rendelje hozzá a CRM névjegyet ID a external_id címkéhez, és állítsa be az external_source fix címkét, például a kommot.
- 4 Futtassa egyszer a HTTP modult. Győződjön meg arról, hogy a kimeneten install_url, delivery_insert_code, external_id és template_id szerepel.
- 5 Adja hozzá az e-mail/SMS/CRM frissítési modult az HTTP után, és térképezze fel a install_url számot a HTTP kimenetről. Mentse el a URL számot a CRM névjegyen, ha a csapatnak később újra el kell küldenie.
Jelölje be:: POST /cards/invite mindig új meghívót hoz létre. Először használja a Find Cards kódot, ha üzleti szabálya az, hogy elkerülje egy meglévő kapcsolattartó újabb meghívását.
2. Fizetett megrendelés → hűségbélyegek hozzáadása
Várt eredmény: A sikeres szkennelési válasz magában foglalja a sikert, a scan_id, stamps_added és a kártya szkennelés utáni állapotát a következő lépéshez.
- 1 Kezdje a POS/ecommerce Fizetett rendelés eseményindítóval. Make győződjön meg arról, hogy a minta stabil ügyfelet tartalmaz ID és a rendelést/receipt ID.
- 2 Adja hozzá a HTTP → Make a request POST https://api.7loc.com/cards-api/cards/scan és ugyanazt a Bearer fejlécet.
- 3 Térkép external_id az ügyféltől, external_source a rendszernévből és external_order_id a rendelésből ID. Adjon hozzá összeget összegalapú kártyák esetén, vagy stamps_count számot meghatározott számú bélyeg esetén.
- 4 Run once tesztrendeléssel. A forgatókönyv ütemezésének engedélyezése előtt ellenőrizze a visszaadott sikerjelzőt és az stamps_added-t.
- 5 Opcionálisan adjon hozzá szűrőt az HTTP lépés után: csak akkor folytassa, ha a siker igaz, majd írja vissza a scan_id vagy stamps_added parancsot a rendelés/CRM rekordba.
Jelölje be:: Használja ugyanazt az external_order_id kódot az újrapróbálkozásoknál, hogy a sorrend nyomon követhető legyen a későbbi webhook eseményekben; ne adjon bélyeget kétszer egy tisztázatlan sikertelen futás után.
3. 7stamp esemény → frissítse a CRM
Várt eredmény: Make azonnal megkapja a 7stamp eseményt a következőn keresztül, és megtalálja a megfelelő ⟦159 rekordot external_id és external_source.
- 1 Hozzon létre egy külön Make forgatókönyvet. Adja hozzá a Webhooks → Custom webhook elemet, válassza a Hozzáadás lehetőséget, nevezze el 7stamp-card-events néven, és másolja a generált URL-t.
- 2 A 7stamp Admin mappában nyissa meg a API & Integrations → Webhooks számot. Adja hozzá a URL számot, és válasszon egy kis eseményhalmazt, például SCAN és REWARD_EARNED.
- 3 Hozzon létre egy eldobható tesztszkennelést vagy kártyaeseményt a 7stamp címen. Térjen vissza a Make-hoz, és használja az Run once-t, hogy az Make határozza meg az esemény adatszerkezetét.
- 4 Adjon hozzá egy CRM keresési lépést a external_id használatával. Adjon hozzá egy szűrőt vagy útválasztót a event_type telefonszámon, így az SCAN, REWARD_EARNED és VOUCHER_ISSUED különböző műveleteket hajthat végre.
- 5 Adja hozzá a CRM frissítés/note műveletet. A scanned_at, stamps_after, external_order_id és issued_vouchers térkép csak akkor, ha ezek a mezők jelen vannak a kiválasztott eseménytípushoz.
Jelölje be:: Tartsa privátként a URL webhookot. Teszteljen egy valós eseményt, mielőtt bekapcsolná a visszafordíthatatlan üzeneteket, utalványokat vagy CRM módosításokat.
Szerezze meg a 7stamp API gombot a Make
megnyitása előtt. Ezek a pontos 7stamp Admin képernyők. Hozza létre egyszer a kulcsot, másolja be a Make biztonságos HTTP kapcsolatába/keychain, majd azonnal távolítsa el a vágólapról.
Készítse elő a kapcsolatot a kiépítés előtt
Hozzon létre egy API kulcsot környezetenként
Az 7stamp Admin mappában lépjen a API & Integrations → API Keys → Add API Key címre. Tárolja az értéket a Make HTTP API-kulcsos kapcsolatában/keychain, ha ez a lehetőség elérhető. Soha ne rendelje hozzá a kulcsot szövegmezőből, ne helyezze jegyzetbe, és ne használja a böngésző felé néző munkafolyamatban. Egy kulcs egy 7stamp munkahelyhez tartozik/profile.
Használjon stabil External ID
Térképezze fel a változhatatlan ID⟧ a 48 ⟦15 POS vagy kereskedelmi platform – például CRM kapcsolattartó ID vagy ügyfél UUID. Adja hozzá a External Source kódot, például hubspotot, shopify-t vagy posztert, ha ugyanaz az azonosító több rendszerben is megjelenhet.
Döntse el, hogy melyik sablon alkalmazandó
Ha a csatlakoztatott 7stamp profilnak egy aktív kártyasablonja van, a Sablon üresen hagyható. Több sablon esetén szándékosan térképezze fel vagy válassza ki a template_id számot, hogy minden meghívó és beolvasás elérje a tervezett hűségprogramot.
Pontos Make HTTP beállítás: hozzon létre egy kártyameghívót
Másolja ezt az automatizálási lépésbe
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
}Az első Make forgatókönyv összeállítása és tesztelése
A 7stamp Admin 5. helyen hozzon létre egy 15 kulcsot. Használjon külön tesztprofilt/key, ha a fiókbeállítások lehetővé teszik.
A Make dokumentumban hozzon létre egy forgatókönyvet, és adja hozzá a forrás triggert. Futtassa le egyszer a feltérképezés előtt, hogy valódi mintakapcsolatot vagy fizetett rendelést láthasson.
Kattintson a következő pluszjelre, keressen rá a HTTP kifejezésre, és válassza ki az Make kérést. Állítsa be a metódust, a teljes URL-t és a fejléceket a műveleti kártyáról ezen az oldalon.
Első kérésként használja a GET https://api.7loc.com/cards-api/templates számot. Sikeres válasza bizonyítja, hogy a kulcs az ügyféladatok megváltoztatása nélkül működik.
Az POST útvonalak esetén válassza a application/json lehetőséget, és illessze be a test alakját ebből az útmutatóból. Térképezzen fel egy istállót External ID; csak akkor adja hozzá a template_id számot, ha a profilhoz több aktív sablon tartozik.
Futtassa egy eldobható érintkezővel, ellenőrizze a HTTP kimenetet, és csak ezután rendelje hozzá a pontos válaszmezőket a következő CRM, e-mail vagy üzenetküldő modulhoz.
Mikor érdemes használni a Make HTTP kódot?
Használja a HTTP-t a 7stamp-hez most: ez a dokumentált, gyártásra kész útvonal, nem pedig csökkentett tartalék. Válassza ezt, amikor 7stamp műveletre, új API útvonalra vagy egyéni POS/ERP kapcsolatra van szüksége. A OpenAPI hivatkozás az igazság forrása a módszer, a teljes útvonal, a törzs és a válaszséma tekintetében; a hordozókulcs és az alap URL változatlan marad.
7stamp események fogadása itt: Make
Eseményvezérelt forgatókönyv esetén adja hozzá a Webhooks → Custom webhook számot, és hozzon létre egy webhookot. Másolja ki a URL-t, nyissa meg a API & Integrations → Webhooks-t a 7stamp profilban, illessze be a URL-t, válassza ki az eseménytípusokat, mentse el, és küldjön egy valós teszteseményt. Az előfizetés a 7stamp profil tulajdonosa; a jelenlegi API nem teszi közzé az automatikus webhook előfizetés/unsubscribe végpontokat.
Nincs szükség nyilvános Make csatlakozóra
Az ezen az oldalon található utasítások Make modulokat használnak, amelyek minden Make fiókhoz elérhetők. Ha egy jövőbeni natív 7stamp modult szeretne HTTP helyett, küldje el nekünk a szükséges munkafolyamatot; addig a HTTP és az Custom webhooks minden dokumentált 7stamp műveletet lefed.
Gyakran ismételt kérdések
Nem találom a 7stamp-t a Make-ben. Még mindig automatizálhatom?
Igen. Ma nincs nyilvános 7stamp alkalmazás a Make címen. Adjon hozzá HTTP > Make kérést, használja a teljes 7stamp végpontot URL, és küldje el a Authorization: Bearer kódot, majd a ⟦1570 kulcsot. Az HTTP minden dokumentált végpontot meghívhat.
Hol szerezhetem be a tokent a Make kapcsolathoz?
A 7stamp Admin mappában nyissa meg az API Integrations, majd a API Keys, majd a Add API Key elemet. A kulcs az azt létrehozó munkahelyre/profile vonatkozik, ezért lehetőség szerint használjon tesztprofilt a tesztforgatókönyvekhez.
Melyik azonosítót kell leképeznem a következővel: External ID?
Használja a forrásrendszer stabil azonosítóját, lehetőleg CRM kapcsolattartót ID vagy ügyfelet UUID. Ne használjon megjelenített nevet. Egy telefonszám vagy e-mail működhet, de változhat, és következetesen kell kezelni.
Hogyan helyezhetem el a 7stamp eseményeket a Make-be?
Hozzon létre egy Webhooks > Custom webhook elemet a Make mappában, majd illessze be a generált URL jelet a 7stamp profil webhook-beállításaiba. Szállítás után használjon Make szűrőt vagy útválasztót a bejövő event_type kezelésére.
Következő lépés
Készen áll az első hűségakció automatizálására?
Hozza létre a API kulcsot, tesztelje a List Templates kódot, és készítsen egy meghívó vagy szkennelési forgatókönyvet egy eldobható kapcsolattartóval. Csak azután adjon hozzá útválasztókat és üzenetküldést, hogy az egyszerű áramlás megbízható legyen.