ምንም ኮድ አውቶማቲክ መመሪያ

7stamp ወደ Zapier ያገናኙ - ደረጃ በደረጃ

የአተገባበር መመሪያ

የስራ ሂደትህ ግልጽ የሆነ ቅደም ተከተል ሲሆን Zapier ተጠቀም፡ እውቂያ ወይም ትዕዛዝ ከመጣ፣ 7stamp አንድን ድርጊት ሲፈጽም ሌላ የንግድ መሳሪያ ተዘምኗል። ደህንነቱ የተጠበቀ መንገድ ዛሬ API በZapier ለወጪ 7stamp API ጥሪዎች እና Webhooks by Zapier → Catch Hook ለገቢ 7stamp ዝግጅቶች።

በZapier የገበያ ቦታ ላይ ምንም አይነት የህዝብ 7stamp መተግበሪያ የለም። በሚገኝበት ቦታ API by Zapier → API Request ይጠቀሙ፡ በ Zap ደረጃ ከማጋለጥ ይልቅ የማይንቀሳቀስ API ቁልፍ በመተግበሪያው ግንኙነት ውስጥ ያከማቻል። ለመጪ Catch Hook ዝግጅቶች Webhooks by Zapier ብቻ ይጠቀሙ። በሚታይ የድር መንጠቆዎች የድርጊት መስክ ውስጥ 7stamp Bearer ቁልፍ አታስቀምጡ።

ክፍት ⟦31 ክፍት ⟦32 ማጣቀሻ

በመስመር ፣ ሊሞከር በሚችል Zap ጀምር

የመጀመሪያውን Zap ትንሽ ያድርጉት. አስተማማኝ የእውቂያ-ወደ-ካርድ ወይም የተከፈለ-ትዕዛዝ-ወደ-ቴምብር ፍሰት ከሰፊ ባለ ሁለት መንገድ CRM ማመሳሰል የተሻለ መነሻ ነጥብ ነው።

ከCRM እውቂያ ግብዣ ይፍጠሩ

አዲስ ወይም ብቁ በሆነ ግንኙነት ላይ ቀስቅሰው፣ CRM ID ወደ External ID ካርታውን ካርታ ያውጡ፣ የካርድ ግብዣ ይፍጠሩ እና የተመለሰውን ጭነት URL ወደ ኢሜል ወይም SMS ደረጃ ያስተላልፉ።

ተመዝግበው ከወጡ በኋላ ማህተሞችን ያክሉ

ከተከፈለበት ማዘዣ ወይም ከተዘጋው ደረሰኝ ቀስቅሰው የደንበኛውን ማንነት ካርታ እና ID ይዘዙ ከዚያም Scan Card በትዕዛዙ መጠን ወይም የቴምብር ቁጥር ይጠቀሙ።

የአንድ ጊዜ መልሶ ማግኛ ቫውቸር ይስጡ

ደንበኛን ለመለየት፣ ካርዳቸው ላይ ቫውቸር ለመስጠት እና ከትክክለኛው ቻናል ተከታይ መልእክት ለመላክ CRM ደንብ፣ የድጋፍ ዝግጅት ወይም ክፍል ወደ ውጭ መላክ ይጠቀሙ።

የካርድ ክስተቶችን ወደ የእርስዎ ⟦43 ⟧ ይፃፉ

የካርድ ዝግጅቶችን ለመቀበል Webhooks by Zapier > Catch Hook ይጠቀሙ። የተመለሰውን External ID ከCRM መዝገብ ጋር አዛምድ እና ተገቢውን ማስታወሻ፣ ታግ ወይም ተግባር ጨምር።

7stamp ኦፕሬሽን ከAPI ለመደወል በZapier

ከማነቃቂያዎ በኋላ ⟦101 ጨምር። አንድ 7stamp API-ቁልፍ ግንኙነት ይፍጠሩ፣ በመቀጠል ትክክለኛውን ዘዴ ይምረጡ እና ሙሉ URL ከታች ይምረጡ። እያንዳንዱ ክዋኔ ወደ ቀጣዩ የ Zap ደረጃ ካርታ የሚወስዷቸውን መስኮች ይመልሳል።

API በZapier ድርጊት POST /cards/invite

ፍጠር Card Invite

ትኩስ የኪስ ቦርሳ ካርድ ጭነት URL እና ለአንድ የውጭ ግንኙነት የመላኪያ-ማስገቢያ ኮድ ይፈጥራል።

ያስፈልጋል: external_id ከCRM/contact ቀስቅሴ።
ቀጣዩ ደረጃ: ካርታ install_url ወደ ኢሜል፣ SMS ወይም CRM መስክ።

API በZapier ድርጊት POST /cards/invite/bulk

የጅምላ ፍጠር Card Invites

ከቁጥጥር JSON ባች እስከ 100 የግብዣ አገናኞችን ይፈጥራል።

ያስፈልጋል: ከ1-100 የሚጋበዙ ዕቃዎችን ያደራጁ።
ይፈትሹ: ከማቅረቡ በፊት success_count፣ error_count እና እያንዳንዱን ውጤት ያንብቡ።

API በZapier ድርጊት POST /cards/scan

⟦120

ማህተሞችን በUser Card ID ወይም External ID ያክላል፣ መጠን፣ የቴምብር ብዛት፣ የትዕዛዝ ID እና አማራጭ ደረሰኝ ውሂብ።

ማንነት: external_id በተጨማሪም አማራጭ external_source; user_card_id ያሸንፋል ሁለቱም ካሉ።
የቴምብር ደንብ: stamps_count ከዋጋ በላይ ቅድሚያ ይሰጣል።

API በZapier ድርጊት POST /vouchers/issue

⟦130

ቫውቸር በቀጥታ ለካርድ ባለቤት ይሰጣል።

ያስፈልጋል: ቫውቸር.short_description እና ኢላማ external_id ወይም የታወቀ user_card_id
ውጤት: ካርታ unique_code፣ ደረጃ ወይም expires_at ወደ CRM ማስታወሻ ወይም መልእክት።

API በZapier ድርጊት POST /messages/send

⟦139

የኪስ ካርድ መግፋት እና /or የኢሜል ይዘትን ለካርድ ባለቤት ይልካል።

የካርድ ግፊት: card_push_text በ20 ቁምፊዎች የተገደበ ነው።
ኢሜይል: ርዕሰ ጉዳይ እና አካል; ውጤቱ መላክ ወረፋ መያዙን ያሳያል።

API በZapier ድርጊት GET /cards

⟦144

ከአማራጭ ምንጭ እና አብነት ማጣሪያዎች ጋር የካርድ መዝገቦችን በExternal ID ያገኛል።

ያስፈልጋል: external_id እንደ መጠይቅ መለኪያ።
መጀመሪያ ተጠቀም: ደንብዎ የተባዙ ግብዣዎችን በሚያስወግድበት ጊዜ ግብዣ ከመፍጠርዎ በፊት ይጠቀሙ።

API በZapier ድርጊት GET /cards/{user_card_id}

የካርድ ዝርዝሮችን ያግኙ

የአንድ ካርድ ሁኔታ በ 7stamp በውስጥ ID ያነባል።

ያስፈልጋል: {user_card_id} በID በ7stamp የተመለሰውን ይተኩ።
ጠቃሚ ውጤት: stamps_count፣ የኪስ ቦርሳ ሁኔታ እና active_vouchers_count

API በZapier ድርጊት GET /templates

⟦158

ለተገናኘው ፕሮፋይል የሚገኙትን አብነቶች ይዘረዝራል እና የAPI ግንኙነቱን ያረጋግጣል።

የመጀመሪያ ሙከራ: ከማንኛውም የመጻፍ እርምጃ በፊት ይደውሉ: ምንም የደንበኛ ውሂብ አይለውጥም.
በኋላ ይጠቀሙ: ብዙ አብነቶች ሲኖሩ ንቁ መታወቂያ template_id ይሆናል።

API በZapier ድርጊት GET /templates/{template_id}/design

⟦163

ለሚታወቅ አብነት ID የአብነት ንድፍ መቼቶችን ያወጣል።

Zapier ቀስቅሴ Webhooks by Zapier → Catch Hook

የካርድ ዝግጅቶችን ይቀበሉ

Catch Hook ልዩ የሆነ Zapier ልዩ የሆነ ⟦171 ይሰጣል። በ7stamp Admin's webhook settings ውስጥ ይለጥፉት እና በእውነተኛ የካርድ ክስተት ይሞክሩት።

በ 173.: ለተተነተነ የክስተት መረጃ Catch Hook ይጠቀሙ; ጥሬ ጥያቄ ራስጌዎችን ሲፈልጉ ብቻ Catch Raw Hook ይጠቀሙ/body.
ግጥሚያ: ከዝግጅቱ CRM external_id እና አማራጭ external_source በመጠቀም ያግኙ።

ሶስት Zapier የስራ ፍሰት ደረጃ በደረጃ መገንባት ትችላለህ

እያንዳንዱ ሁኔታ እውነተኛ፣ በአሁኑ ጊዜ የሚገኝ Zapier ሞጁል ይጠቀማል። መጀመሪያ አንድ ትንሽ መንገድ ይገንቡ እና ዛፕን ከማብራትዎ በፊት በሚጣል ግንኙነት ይሞክሩት።

1. ብቃት ያለው ⟦217 አድራሻ → ካርድ መስጠት

የሚጠበቀው ውጤት: የሚቀጥለው የ Zap ደረጃ install_url ይቀበላል እና ለደንበኛው መላክ ወይም ወደ CRM መዝገብ መልሶ መፃፍ ይችላል።

1 Zap ይፍጠሩ እና CRM ክስተቱን ይምረጡ ይህም ማለት አንድ እውቂያ ለታማኝነት ብቁ ነው። ቀስቅሴውን ይሞክሩ እና የእውቂያው የማይለወጥ ID እንዳለ ያረጋግጡ።
2 ⟦222 ጨምር። የ7stamp API-ቁልፍ ግንኙነት ይፍጠሩ ወይም ይምረጡ፣ POST ይምረጡ እና URL ወደ https://api.7loc.com/cards-api/cards/invite. ያቀናብሩ።
3 ገላውን ወደ ⟦228 ያዋቅሩት። CRM ID ወደ external_id ካርታ ያውጡ፣ ቋሚ external_source እንደ kommo ያሉ ያስቀምጡ እና template_id ከአንድ በላይ 7stamp አብነት ሲሰራ ብቻ template_id ይጨምሩ።
4 እርምጃውን ይፈትሹ. ለተመሳሳይ external_id install_url እና delivery_insert_code መያዙን ያረጋግጡ።
5 የእርስዎን CRM ዝማኔ፣ ኢሜይል ወይም SMS እርምጃ ያክሉ። ካርታ install_url ከAPI ምላሽ; ሃርድ-ኮድ አታድርጉ ወይም ፈተናን አትቅዱ URL.

ይፈትሹ: ይፍጠሩ Card Invite ሁልጊዜ አዲስ ግብዣ ይመልሳል። መመሪያዎ በእውቂያ አንድ ግብዣ ከሆነ መጀመሪያ Find Cards ጥያቄ ወይም Zapier አጣራ።

2. የተከፈለበት ትዕዛዝ → የሽልማት ማህተሞች

የሚጠበቀው ውጤት: ትዕዛዙ ሊፈለግ የሚችል 7stamp ስካን ይፈጥራል እና Zap stamps_added ወይም scan_id በምንጭ ሲስተም ውስጥ መመዝገብ ይችላል።

1 የተከፈለ ትእዛዝ/Closed የደረሰኝ ማስፈንጠሪያ ይጠቀሙ እና ይሞክሩት። ደንበኛውን ያረጋግጡ ID እና ልዩ ትዕዛዝ ID ከመቀጠልዎ በፊት ሁለቱም ይገኛሉ።
2 API by Zapier → API Request ከPOST https://api.7loc.com/cards-api/cards/scan ጋር ጨምሩ እና ተመሳሳዩን 7stamp ግንኙነት ይምረጡ።
3 JSON በexternal_id፣ external_source፣ external_order_id፣ እና ወይ መጠን ላይ ለተመሰረቱ አብነቶች ወይም stamps_count ለግልጽ የቴምብር ሽልማት ይላኩ።
4 በሚጣል ትዕዛዝ ይሞክሩ። ስኬትን መርምር፣ scan_id፣ እና stamps_added በምላሹ።
5 ከተሳካ ምላሽ በኋላ ብቻ የሚቀጥል ማጣሪያ ያክሉ፣ ከዚያ ትዕዛዙን/CRM ከተረጋገጠው ውጤት ጋር ያዘምኑ።

ይፈትሹ: Zap እንደገና ከተጫወተ ሌላ ቅኝት ከመላክዎ በፊት ዋናውን ቅደም ተከተል ያረጋግጡ። ዝግጅቱ በኋላ እንዲታረቅ external_order_id ተረጋጋ።

3. 7stamp ዝግጅት → CRM ማስታወሻ ወይም ተግባር ይፍጠሩ

የሚጠበቀው ውጤት: Zapier የተተነተነ 7stamp ዝግጅት ተቀብሎ ደንበኛውን በexternal_id ፈልጎ ተገቢውን ክትትል ያደርጋል።

1 እንደ ቀስቅሴ Webhooks by Zapier አዲስ Zap ይፍጠሩ። በሙከራ ደረጃ ላይ የሚታየውን Catch Hook፣ ይቀጥሉ እና ልዩ የሆነውን URL ይቅዱ።
2 በ 7stamp Admin ውስጥ፣ API & Integrations → Webhooksን ይክፈቱ፣ Catch Hook URLን ይጨምሩ፣ የሚያስፈልጉትን የዝግጅት አይነቶችን ብቻ ይምረጡ እና ያስቀምጡ።
3 እውነተኛ የፍተሻ ቅኝት ወይም የካርድ ክስተት መንስኤ። ወደ Zapier ተመለስ፣ Test trigger ን ተጫን እና event_type፣ external_id፣ እና external_source እንደ ናሙና መስክ መድረሱን አረጋግጥ።
4 CRM የእውቂያ እርምጃን external_id በመጠቀም ጨምር። ለ event_type የማጣሪያ ወይም የመንገዶች ህግ ያክሉ፣ ለምሳሌ SCAN ከREWARD_EARNED ይለዩ።
5 CRM ማስታወሻ/task እና ለዚያ ክስተት ያሉትን እንደ scanned_at፣ stamps_after፣ external_order_id፣ ወይም issued_vouchers ያሉ ካርታዎችን ብቻ ይፍጠሩ።

ይፈትሹ: A Catch Hook URL ሚስጥር ነው። Zap ወደ ሌላ ባለቤት ከተላለፈ፣ በእሱ ላይ ከመታመንዎ በፊት URL በ7stamp Admin ያዘምኑት።

Zapን ከመገንባቱ በፊት 7stamp API ቁልፍ ይፍጠሩ

እነዚህ 7stamp-የጎን ደረጃዎች ናቸው። ይህንን አንድ ጊዜ ያድርጉ፣ ከዚያ ቁልፉን በAPI በZapier ግንኙነት ውስጥ ብቻ ይጠቀሙ—በ Webhooks by Zapier የድርጊት መስክ ወይም ማስታወሻ ላይ አይደለም።

7stamp Admin API እና ውህደት ስክሪን ከAdd API Key እርምጃ ጋር — API እና ውህደትን ይክፈቱ፣ **API Keys**ን ይምረጡ እና ከዚያ ለ Zap መለያዎ ማዋቀር የሚፈቅድበትን የተለየ ቁልፍ ይፍጠሩ።

አዲስ የተፈጠረ 7stamp API ቁልፍ ለመቅዳት ዝግጁ ነው። — ቁልፉን ወደ ደህንነቱ የተጠበቀ API በZapier ግንኙነት ይቅዱ እንጂ ወደ ግልጽ የዌብሆክስ ደረጃ ወይም የተጋራ ሰነድ አይደለም።

የውሂብ አለመዛመድን የሚከለክሉ የግንኙነት ህጎች

API ቁልፉን በAPI በZapier ግንኙነት ውስጥ አቆይ

በ 7stamp Admin ውስጥ API & Integrations → API Keys → Add API Key ን ይምረጡ። በ ⟦189 ⟧ በ Zapier፣ API-ቁልፍ ግንኙነት ከማይንቀሳቀስ Authorization Bearer Bearer ከያዘው እና ከዛ ቁልፍ ጋር ፍጠር። API በZapier ከሚታየው የ Zap ደረጃ ይልቅ በግንኙነት ውስጥ ያለውን ምስክርነት ያስቀምጣል። የግንኙነቱን መዳረሻ ይገድቡ እና ከተጋለጡ ቁልፉን ያሽከርክሩት።

ካርታ External ID እና External Source ያለማቋረጥ

External ID የራስህ የተረጋጋ ደንበኛ መለያ ነው; External Source ከየት እንደመጣ መለያዎች ለምሳሌ hubspot፣ bitrix24፣ Shopify ወይም ፖስተር። ለመፍጠር፣ ለማግኘት፣ ለመቃኘት፣ ቫውቸር እና የድር መንጠቆ ፍሰቶችን ለመፍጠር ተመሳሳይ ጥንድ ይጠቀሙ።

የትኛው ካርድ መለያ እንደሚያሸንፍ ይወቁ

የካርድ ማነጣጠር ድርጊቶች User Card ID ወይም External ID ይቀበላሉ። ሁለቱም ሲገኙ User Card ID ቅድሚያ ይሰጣል። የውስጥ ID በታመነ 7stamp እርምጃ ከተመለሰ በኋላ ብቻ ይጠቀሙ። ያለበለዚያ የምንጩን ስርዓት ይምረጡ External ID።

ትክክለኛ API በZapier ጥያቄ፡ አንድ ማህተም ይሸልሙ

ይህንን ወደ ራስ-ሰር እርምጃዎ ይቅዱ http

Method: POST
URL: https://api.7loc.com/cards-api/cards/scan
Headers:
  Authorization: Bearer YOUR_7STAMP_API_KEY
  Content-Type: application/json
Data:

{
  "external_id": "crm_contact_8821",
  "external_source": "hubspot",
  "stamps_count": 1,
  "external_order_id": "order_2048"
}

የመጀመሪያዎን Zap ይገንቡ

በአስተዳዳሪው ውስጥ 7stamp API ቁልፍ ይፍጠሩ፡ API & Integrations → API Keys → Add API Key። ሲገኝ የተለየ የሙከራ ቁልፍ /profile ይጠቀሙ።

በZapier፣ Zap ይፍጠሩ እና የምንጭ ቀስቅሴን ይሞክሩ። እውነተኛውን ናሙና ተጠቀም እውቂያው ID፣ ደንበኛ ID፣ ID ለማዘዝ እና መጠኑ ለካርታ ስራ ይገኛል።

⟦305 ጨምሩ። ምስጢሩን በ Webhooks by Zapier የድርጊት መስክ ውስጥ ከማስቀመጥ ይልቅ ለስታቲክ Bearer Authorization አርዕስት 7stamp ግንኙነት ይፍጠሩ።

መጀመሪያ GET https://api.7loc.com/cards-api/templates ይደውሉ። ይህ የቁልፍ ስራዎችን ያረጋግጣል እና የደንበኛ ውሂብን ሳይቀይሩ የትኞቹ ንቁ የአብነት መታወቂያዎች እንደሚገኙ ያሳያል።

POST /cards/invite ወይም POST /cards/scan /cards/scan JSON እንደ አካል አይነት ምረጥ እና የረጋውን External ID እና ተዛማጅ አብነት/order መስኮችን ከመቀስቀሻው ላይ ካርታ አድርግ።

እርምጃውን ከሚጣል እውቂያ ጋር ያሂዱ፣ ትክክለኛ የምላሽ መስኮቹን ይመርምሩ፣ ከዛም ዛፕን ከማተምዎ በፊት እነዚያን መስኮች ወደ ቀጣዩ CRM፣ ኢሜይል ወይም የመልእክት ደረጃ ያቅርቡ።

ሁለንተናዊ ጥያቄውን ለተመዘገቡ መንገዶች ብቻ ይጠቀሙ

ለ 7stamp ጥያቄ ከBearer API ቁልፍ ጋር API በZapier ይጠቀሙ፡ በመተግበሪያ ግንኙነት ውስጥ የማይለዋወጡ አርዕስት ቁልፎችን ያስቀምጣል። ለ Catch Hook ዝግጅት ማድረስ Webhooks by Zapier ይጠቀሙ እንጂ ለ7stamp ሚስጥር እንደ ተመራጭ ቦታ አይደለም። መሰረቱን URL በhttps://api.7loc.com/cards-api, የህዝብን OpenAPI ማጣቀሻን ለትክክለኛ መርሃ ግብሮች ይጠቀሙ እና የምስክር ወረቀቶችን ወይም የደንበኛ መረጃዎችን ላልተረጋገጠ URL በጭራሽ አይላኩ።

7stamp ዝግጅቶችን በCatch Hook ይቀበሉ

Webhooks by Zapier → Catch Hook ይፍጠሩ፣ በሙከራ ዝግጅት ላይ የሚታየውን ልዩ URL ገልብጠው፣ ወደ 7stamp ፕሮፋይል ዌብ መንጠቆ ቅንብሮች ውስጥ ይለጥፉ፣ የክስተት አይነቶችን ይምረጡ እና ከዚያ እውነተኛ የሙከራ ስካን ወይም የካርድ ክስተት ይላኩ። ትክክለኛውን CRM አድራሻ ለማግኘት የክስተቱን ክፍያ External ID እና External Source ይጠቀሙ። ያልተተነተነ አካል ሲፈልጉ ብቻ Catch Raw Hook ይምረጡ እና ራስጌዎችን ይጠይቁ።

ደህንነቱ የተጠበቀ Zapier መንገድ አሁን ይጠቀሙ

API በZapier እና Catch Hook ለእያንዳንዱ የህዝብ 7stamp API ኦፕሬሽን እና የካርድ ዝግጅት በቂ ነው። የወደፊት ተወላጅ 7stamp Zapier መተግበሪያ ከፈለጉ፣ ቡድንዎ በብዛት የሚጠቀመውን ትክክለኛውን እርምጃ ይላኩልን።

ስለ ቤተኛ አያያዥ ይጠይቁ

በተደጋጋሚ የሚጠየቁ ጥያቄዎች

7stamp መተግበሪያን በZapier ውስጥ የት ማግኘት እችላለሁ?

ዛሬ ምንም ይፋዊ 7stamp የገበያ ቦታ መተግበሪያ የለም። ለ 7stamp API ጥሪዎች እና Webhooks by Zapier → Catch Hook ለገቢ 7stamp ዝግጅቶች API by Zapier → API Request ይጠቀሙ።

Zapier ማስመሰያ የት ነው የምፈጥረው?

በአስተዳዳሪው ውስጥ በAPI & Integrations → API Keys → Add API Key ስር 7stamp API ቁልፍ ይፍጠሩ። በማይታይ Bearer Authorization ራስጌ በAPI በZapier ግንኙነት ያከማቹ እንጂ በሚታይ Webhooks by Zapier የድርጊት መስክ አይደለም።

Zapier የቴምብር ወይም የቫውቸር ዝግጅት እንዴት መቀበል ይቻላል?

በ Webhooks by Zapier ውስጥ Catch Hook ይፍጠሩ፣ የፈጠረውን URL ወደ 7stamp መገለጫ የድር መንጠቆ መቼት ይለጥፉ፣ ክስተቶቹን ይምረጡ እና የ⟦77 ዝማኔዎችን ከማንቃትዎ በፊት የሙከራ ክስተት ይላኩ።

Zapier ወይም Make ልመርጥ?

ለአብዛኛው የመስመር ቀስቅሴ-እርምጃ የስራ ፍሰት Zapier ን ይምረጡ። ራውተሮች፣ ውስብስብ ትራንስፎርሜሽን ወይም ረጅም ባለብዙ ቅርንጫፍ ሁኔታዎች ሲፈልጉ ⟦82 ን ይምረጡ። ሁለቱም አንድ አይነት 7stamp API ቁልፍ እና የመጨረሻ ነጥብ ይጠቀማሉ።

ተዛማጅ ገጾች

ክፍት ⟦83 API በZapier እርዳታ Zapier Catch Hook እገዛ ⟦88 ማጣቀሻ Webhook ማዋቀር ⟦89 መመሪያ

ቀጣዩ ደረጃ

የመጀመሪያውን Zap በሙከራ እውቂያ ይገንቡ

የAPI ቁልፉን ይፍጠሩ፣ GET /templates እስከ API በZapier ሞክሩ፣ ከዚያ አንድ እውቂያ-ወደ-ካርድ ወይም ለማዘዝ-የቴምብር እርምጃ ይገንቡ። ወደ ውጪ የሚወጣው ፍሰት የተረጋገጠ የምርመራ ውጤት ካገኘ በኋላ Catch Hook ጨምር።

ክፍት ⟦96 ⟦97 ማጣቀሻውን ያንብቡ