ከአዲስ ⟦377 እውቂያ በኋላ ካርድ ይፍጠሩ
CRM ዕውቂያ ID እንደ External ID ይጠቀሙ፣ የ7stamp የካርድ ግብዣ ይፍጠሩ እና የተመለሰውን ጭነት URL በተለመደው ኢሜልዎ SMS ወይም የመልእክት ደረጃ ይላኩ።
ምንም ኮድ አውቶማቲክ መመሪያ
7stampን በCRM፣ POS፣ የመስመር ላይ ሱቅ፣ የተመን ሉህ፣ የመልእክት መላላኪያ መሳሪያን ወይም ማንኛውንም መረጃ ወደ ሁኔታ መላክ የሚችል ስርዓትን ለማገናኘት Make ይጠቀሙ። ለምርት ዝግጁ የሆነው መንገድ ዛሬ የMake''s HTTP መተግበሪያ ለ⟦355 ጥሪዎች እና Make's Custom webhook ለገቢ 7stamp ዝግጅቶች ነው።
እስካሁን ምንም ይፋዊ 7stamp መተግበሪያ በMake መተግበሪያ መራጭ ውስጥ የለም። ለአንድ አይጠብቁ፡ HTTP → Make a request ጨምሩ፣ ትክክለኛውን URL፣ ዘዴ፣ Bearer አርዕስት እና JSON ከታች ተጠቀም፣ከዚያም መስኮቹን ከምንጭ ሞጁል ላይ ካርታ አድርግ። ይህ የወደፊት ማገናኛ የሚጠቀመው 7stamp Integration API ተመሳሳይ ነው።
በአንድ ክስተት እና በአንድ ውጤት ይጀምሩ. አንዴ የሙከራው መረጃ ትክክል ከሆነ ማጣሪያዎችን፣ ራውተሮችን፣ CRM ማሻሻያዎችን እና በዙሪያው ያሉ ተከታይ መልዕክቶችን ያክሉ።
CRM ዕውቂያ ID እንደ External ID ይጠቀሙ፣ የ7stamp የካርድ ግብዣ ይፍጠሩ እና የተመለሰውን ጭነት URL በተለመደው ኢሜልዎ SMS ወይም የመልእክት ደረጃ ይላኩ።
ከተከፈለ POS ወይም የኢኮሜርስ ትእዛዝ ሁኔታውን ቀስቅሰው። የተረጋጋ ደንበኛውን ID ካርታ እና ID ወደ Scan a Card ይዘዙ ከዚያም መጠን ወይም ግልጽ የቴምብር ቆጠራ ይጠቀሙ።
አንድ የካርድ ክስተት ሽልማት ወይም ቫውቸር ሲዘግብ፣ ሁኔታውን ቅርንጫፍ ያድርጉ፡ CRMን ያዘምኑ፣ ቡድኑን ያሳውቁ እና ሲያስፈልግ ብቻ የኪስ ካርድ ፑሽ ወይም ኢሜል ይላኩ።
በቀጥታ ወደ 7stamp ለመደወል የMake's HTTP ሞጁሉን ይጠቀሙ። ይህ የብጁ POS፣ ERP፣ የቦታ ማስያዣ ሞተር ወይም ለማንኛውም API-የመጀመሪያ አገልግሎት ሁለንተናዊ ምርጫ ነው።
ከታች ላለው እያንዳንዱ ካርድ HTTP → Make a request ጨምር ከዛ ዘዴውን አዘጋጅ እና URL ልክ እንደሚታየው። ለእያንዳንዱ ጥያቄ ተመሳሳይ Bearer ቁልፍ ይጠቀሙ። የሚፈለገው የካርታ ስራ ከእርስዎ CRM፣ POS ወይም የኢኮሜርስ ማስነሻ ምን እንደሚያቀርቡ ይነግርዎታል።
Webhooks → Custom webhook በMake ውስጥ Custom webhook ይፍጠሩ፣ URLን ይቅዱ እና ያንን URL ወደ 7stamp ፕሮፋይል webhook መቼቶች ይለጥፉ። ይህ ሁኔታ የሚጀምረው 7stamp እንደ SCAN፣ REWARD_EARNED፣ ወይም VOUCHER_ISSUED ያለ ክስተት ሲልክ ነው።
POST /cards/invite ለአንድ የውጭ ግንኙነት አዲስ የግል ጭነት URL እና የማድረስ-ማስገቢያ ኮድ ይፈጥራል።
POST /cards/invite/bulk በአንድ ጥያቄ እስከ 100 የግብዣ አገናኞችን ይፈጥራል። ቁጥጥር የሚደረግበት ፍልሰት ወይም ዘመቻ ይጠቀሙበት እንጂ ወሰን ለሌለው ግንኙነት ወደ ውጭ መላክ አይደለም።
GET /cards የካርድ መዝገቦችን በ ⟦485 ⟧ ከአማራጭ አብነት እና የምንጭ ማጣሪያዎች ጋር ያገኛል።
GET /cards/{user_card_id} አንድ ቀዳሚ እርምጃ የውስጥ User Card ID ሲመለስ የአንድ ካርድ ሙሉ ሁኔታ ያነባል።
POST /cards/scan ማህተሞችን ከግዢ መጠን ወይም ግልጽ ቆጠራ ያክላል። User Card ID ወይም External ID ይቀበላል እና የውጫዊ የትዕዛዝ ማመሳከሪያውን ማቆየት ይችላል።
GET /templates ለ API ቁልፍ የሚገኙትን የካርድ አብነቶች ይዘረዝራል። ግንኙነቱን ለመሞከር ወይም አብነት በተለዋዋጭነት ለመምረጥ ይጠቀሙበት።
GET /templates/{template_id}/design ሌላ ስርዓት ወጥ የሆነ የካርድ ምርጫን ለማሳየት ሲፈልግ ለሚታወቅ አብነት የእይታ ንድፍ ቅንብሮችን ይመልሳል።
POST /vouchers/issue በExternal ID ወይም User Card ID የተገለጸውን ቫውቸር ለአንድ ካርድ ባለቤት ይሰጣል።
POST /messages/send በተዋቀረው ቻናል እና በስምምነት ደንቦች መሰረት ይዘትን ለካርዱ ባለቤት በኪስ-ካርድ መግፋት እና /or ኢሜይል ይልካል።
Full 7stamp endpoint URL ይህ ከላይ ያለውን እያንዳንዱን 7stamp መንገድ የሚጠራው Make ሞጁል ነው። ሙሉ URL ተጠቀም፣ በሰነድ የተደገፈ ዘዴን ምረጥ፣ Bearer አርዕስት ጨምር እና JSON መንገዱ አካል ሲፈልግ ብቻ ተጠቀም።
ከታች ያሉት ስሞች ትክክለኛዎቹ Make ሞጁሎች ናቸው። ከመጀመሪያው ሁኔታ ይጀምሩ፣ ሊጣል በሚችል እውቂያ ላይ ያሂዱት እና ከዚያ ብቻ ራውተሮችን፣ ማጣሪያዎችን ወይም የምርት መርሐግብርን ያክሉ።
የሚጠበቀው ውጤት: ደንበኛው የተመለሰውን install_url በ7stamp; የእርስዎ CRM ያንን URL በተመሳሳይ የእውቂያ መዝገብ ውስጥ ማስቀመጥ ይችላል።
ይፈትሹ: POST /cards/invite ሁልጊዜ ትኩስ ግብዣ ይፈጥራል። የንግድዎ ህግ ለነባር ግንኙነት ሌላ ግብዣን ለማስቀረት ከሆነ መጀመሪያ Find Cards ይጠቀሙ።
የሚጠበቀው ውጤት: የተሳካ ቅኝት ምላሽ ስኬትን፣ scan_id፣ stamps_added እና የድህረ-ስካን ካርድ ሁኔታን ለቀጣይ እርምጃዎ ያካትታል።
ይፈትሹ: በድጋሚ ሙከራዎች ላይ ተመሳሳይ external_order_id ተጠቀም ትዕዛዙ በኋለኞቹ የዌብ መንጠቆ ክስተቶች ላይ ሊገኝ ይችላል፤ ግልጽ ካልሆኑ ያልተሳካ ሩጫ በኋላ ቴምብሮችን ሁለት ጊዜ አይስጡ።
የሚጠበቀው ውጤት: Make የ7stamp ዝግጅት ወዲያውኑ ይቀበላል እና ተዛማጅ CRM ሪከርዱን በexternal_id እና external_source ማግኘት ይችላል።
ይፈትሹ: የዌብ መንጠቆውን URL የግል ያድርጉት። የማይመለሱ መልዕክቶችን፣ ቫውቸሮችን ወይም CRM ለውጦችን ከማብራትዎ በፊት እውነተኛ ክስተት ይሞክሩ።
ትክክለኛዎቹ 7stamp Admin ስክሪኖች ናቸው። ቁልፉን አንድ ጊዜ ይፍጠሩ፣ ወደ Make ደህንነቱ የተጠበቀ HTTP ግንኙነት/keychain ይቅዱት፣ ከዚያ ወዲያውኑ ከቅንጥብ ሰሌዳዎ ያስወግዱት።
በ 7stamp Admin፣ ወደ API & Integrations → API Keys → Add API Key ይሂዱ። አማራጩ ሲገኝ እሴቱን በMake's HTTP API-ቁልፍ ግንኙነት/keychain ያከማቹ። ቁልፉን ከጽሑፍ መስክ በጭራሽ አታስቀምጡ፣ በማስታወሻ ውስጥ አያስቀምጡት ወይም በአሳሽ ፊት ለፊት ባለው የስራ ፍሰት ውስጥ አይጠቀሙበት። ቁልፍ የአንድ ነው 7stamp የስራ ቦታ/profile.
ከእርስዎ CRM፣ POS ወይም የንግድ መድረክ - ለምሳሌ CRM እውቂያ ID ወይም ደንበኛ UUID ያለውን የማይለዋወጥ ID ካርታ አድርግ። ተመሳሳዩ መለያ ከአንድ በላይ በሚታይበት ጊዜ እንደ hubspot፣ Shopify ወይም ፖስተር ያሉ ⟦550 ያክሉ።
የተገናኘው 7stamp መገለጫ አንድ የነቃ ካርድ አብነት ሲኖረው አብነት ባዶ ሊተው ይችላል። በበርካታ አብነቶች፣ እያንዳንዱ ግብዣ እና ቅኝት የታሰበው የታማኝነት ፕሮግራም ላይ እንዲደርስ ሆን ብለህ template_id ካርታ ወይም ምረጥ።
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
} በ7stamp Admin ውስጥ በAPI & Integrations → API Keys → Add API Key ውስጥ ቁልፍ ይፍጠሩ። መለያዎ ማዋቀር ሲፈቅድ የተለየ የሙከራ ፕሮፋይል /key ይጠቀሙ።
በMake ውስጥ፣ ሁኔታን ይፍጠሩ እና የምንጭ ቀስቅሴን ያክሉ። እውነተኛ የናሙና እውቂያ ወይም የሚከፈልበት ትዕዛዝ ለማየት እንዲችሉ ካርታ ከመስራቱ በፊት አንድ ጊዜ ያሂዱት።
የሚቀጥለውን ፕላስ ጠቅ ያድርጉ፣ HTTP ይፈልጉ እና Make ጥያቄን ይምረጡ። በዚህ ገጽ ላይ ዘዴውን፣ ሙሉ URL እና ራስጌዎችን ከኦፕሬሽን ካርዱ ያዘጋጁ።
እንደ መጀመሪያው ጥያቄ GET https://api.7loc.com/cards-api/templates ይጠቀሙ። የእሱ የተሳካ ምላሽ ምንም አይነት የደንበኛ ውሂብ ሳይቀይር ቁልፍ እንደሚሰራ ያረጋግጣል.
ለ POST መንገዶች፣ application/json ን ይምረጡ እና የሰውነት ቅርፅን ከዚህ መመሪያ ይለጥፉ። ቋሚ ካርታ External ID; አክል template_id መገለጫው በርካታ ንቁ አብነቶች ካለው ብቻ።
ሊጣል ከሚችል እውቂያ ጋር ያሂዱ፣ የHTTP ውጤቱን ይመርምሩ እና ከዚያ ብቻ ትክክለኛ የምላሽ መስኮቹን ወደ ቀጣዩ CRM፣ ኢሜል ወይም የመልእክት መላላኪያ ሞጁል ላይ ካርታ ያድርጉ።
HTTP ለ7stamp አሁን ተጠቀም፡ በሰነድ የተደገፈ፣ ለምርት ዝግጁ የሆነ መንገድ እንጂ የተቀነሰ ውድቀት አይደለም። 7stamp ኦፕሬሽን፣ አዲስ API መንገድ፣ ወይም ብጁ POS/ERP ግንኙነት በሚፈልጉበት ጊዜ ሁሉ ይምረጡት። OpenAPI ዋቢው ለዘዴ፣ ለሙሉ መንገድ፣ ለአካል እና ለምላሽ እቅድ የእውነት ምንጭ ነው። የተሸካሚው ቁልፍ እና መሠረት URL በተመሳሳይ ይቆዩ።
በክስተት ላይ ለተነሳ ሁኔታ፣ Webhooks → Custom webhook ያክሉ እና የድር መንጠቆ ይፍጠሩ። የእሱን URL ይቅዱ፣ API & Integrations → Webhooksን በ7stamp መገለጫ ይክፈቱ፣ URLን ይለጥፉ፣ የክስተት አይነቶችን ይምረጡ፣ ያስቀምጡ እና እውነተኛ የሙከራ ክስተት ይላኩ። 7stamp መገለጫው የደንበኝነት ምዝገባው ባለቤት ነው; የአሁኑ API አውቶማቲክ የድር መንጠቆን ሰብስክራይብ አያጋልጥም/unsubscribe የመጨረሻ ነጥብ።
በዚህ ገጽ ላይ ያሉት መመሪያዎች ለእያንዳንዱ Make መለያ የሚገኙ Make ሞጁሎችን ይጠቀማሉ። የወደፊት ተወላጅ 7stamp ሞጁል ከHTTP ይልቅ ከፈለጉ የሚፈልጉትን የስራ ፍሰት ይላኩልን። እስከዚያ ድረስ፣ HTTP እና Custom webhooks እያንዳንዱን ሰነድ 7stamp ኦፕሬሽን ይሸፍናሉ።
አዎ። ዛሬ በ Make ውስጥ የህዝብ 7stamp መተግበሪያ የለም። ጥያቄ HTTP > Make አክል፣ ሙሉውን 7stamp የመጨረሻ ነጥብ URL ተጠቀም እና Authorization: Bearer በመቀጠል 7stamp API ቁልፍህን ላክ። HTTP እያንዳንዱን የሰነድ የመጨረሻ ነጥብ መደወል ይችላል።
በ 7stamp Admin ውስጥ፣ API ውህደትን ይክፈቱ፣ በመቀጠል API Keys፣ ከዚያ Add API Key። ቁልፉ ለፈጠረው የስራ ቦታ/profile የተዘረጋ ነው፣ ስለዚህ በተቻለ መጠን ለሙከራ ሁኔታዎች የሙከራ ፕሮፋይልን ይጠቀሙ።
የተረጋጋ መለያውን ከምንጩ ሲስተም ይጠቀሙ፣ በተለይም CRM እውቂያ ID ወይም ደንበኛ UUID። የማሳያ ስም አይጠቀሙ. ስልክ ቁጥር ወይም ኢሜል ሊሠራ ይችላል ነገር ግን ሊለወጥ ይችላል እና በቋሚነት መያዝ አለበት.
በMake ውስጥ የድር መንጠቆዎችን > Custom webhook ይፍጠሩ፣ ከዚያ የመነጨውን URL ወደ የ7stamp መገለጫ የድር መንጠቆ ቅንብሮች ይለጥፉ። መጪውን event_type ለማስተናገድ Make ማጣሪያ ወይም ራውተር ይጠቀሙ።
ቀጣዩ ደረጃ
የAPI ቁልፉን ይፍጠሩ፣ List Templatesን ይሞክሩ እና አንድ ግብዣ ይገንቡ ወይም ሊጣሉ በሚችሉ እውቂያዎች ይቃኙ። ቀላል ፍሰት አስተማማኝ ከሆነ በኋላ ብቻ ራውተሮችን እና መልዕክቶችን ያክሉ።