የገንቢ ውህደት

7Stamp Webhooks

ይገኛል።

እያንዳንዱን የታማኝነት ክስተት ከ7stamp ወደ የራስዎ ስርዓቶች በቅጽበት ይግፉት። ምንም ምርጫ የለም እና ምንም የታቀደ ⟦726 ጥሪዎች የሉም። ክስተቶች በተከሰቱ በሰከንዶች ውስጥ እንደ HTTPS POST ጥያቄዎች ይደርሳሉ።

የእርስዎን CRM፣ ERP፣ ወይም ብጁ የመጠባበቂያ ቅጂ በታማኝነት በኩል እየሆነ ካለው ነገር ጋር እንዲመሳሰል የዌብ መንጠቆዎችን ይጠቀሙ፡ ማን ተቀላቅሏል፣ ማን ማህተም አግኝቷል፣ ቫውቸር ማን የወሰደ፣ የልደት ስጦታ የቀሰቀሰው እና ማን የቦዘነ። ከዚያ የእርስዎ ስርዓቶች በዚያ ውሂብ ምን እንደሚሰሩ ይወስናሉ።

ክፈት API ዋቢ ክፍት 7Stamp Admin

በድር መንጠቆዎች ምን ማድረግ ይችላሉ።

የድር መንጠቆዎች የውህደት ቁልል ውጫዊ ጎን ናቸው። ደንበኛን ያንፀባርቃሉ እና ለሽያጭ፣ ለአገልግሎት፣ ለመተንተን እና ለመልእክት አስቀድመው በሚያምኗቸው ስርዓቶች ውስጥ እንቅስቃሴን ይሸልማሉ።

የታማኝነት ታሪክን ወደ እርስዎ ⟦735 ያንጸባርቁ

እያንዳንዱ ማህተም፣ ቫውቸር፣ የልደት ቀን እና የእንቅስቃሴ-አልባነት ቀስቅሴ በደንበኛ መዝገብ ላይ በእርስዎ CRM ውስጥ ይገኛል። ወደ 7Stamp ሳትገቡ ከሽያጮች፣ ጥሪዎች እና ትኬቶች ቀጥሎ ያለውን ሙሉ የታማኝነት ጊዜ ያያሉ።

የእራስዎን የመልእክት ቁልል ቀስቅሰው

አንድ ደንበኛ ቫውቸሩን ሲወስድ፣ ካለህበት SMS መግቢያ በር የምስጋና SMS ይላኩ። አንድ ደንበኛ ግቡን ሲመታ በSlack ላይ ክብረ በዓል ይለጥፉ። አንድ ሰው ሲቦዝን ጉዳዩን ወደ መለያዎ አስተዳዳሪ ያዙሩት።

የኃይል ትንተና እና እርቅ

ክስተቶችን ወደ የእርስዎ BI መሳሪያ፣ መጋዘን ወይም የማስታረቅ ቧንቧ መስመር ይልቀቁ። የቫውቸር ቤዛዎችን ከPOS ደረሰኞች ጋር ያመሳስሉ እና ታማኝነትን ROI በራስዎ መለኪያዎች ያሰሉ።

የካርድ ክስተት ዓይነቶች

SCAN — አንድ ካርድ ስካን/stamp እርምጃ ተቀብሏል።

REWARD_EARNED - በካርዱ ላይ ሽልማት ተገኝቷል።

VOUCHER_ISSUED - ቫውቸር ወጣ።

VOUCHER_REDEEMED — ቫውቸር ተመልሰዋል።

LOTTERY_WIN - ሎተሪ አሸናፊ ሆነ።

DELIVERY_INSERT - የመላኪያ-ማስገቢያ ፍሰት ተመዝግቧል።

CARD_JOINED - ደንበኛ አንድ ካርድ ተቀላቅሏል።

CARD_CAMPAIGN — የካርድ ዘመቻ ክስተት ተከስቷል።

BIRTHDAY_GREETING - የልደት ሰላምታ ዝግጅት ተከሰተ።

ADMIN_VOUCHER_ISSUE - አስተዳዳሪ ቫውቸር አወጡ።

CARD_ADDED_TO_WALLET — አንድ ደንበኛ ካርዱን ወደ ቦርሳቸው ጨመረ።

CARD_REMOVED_FROM_WALLET - አንድ ደንበኛ ካርዱን ከኪስ ቦርሳቸው አውጥተውታል።

ደህንነቱ የተጠበቀ የድር መንጠቆ መቀበያ ይገንቡ

ከረጅም ጊዜ አያያዝ በኋላ እውቅና ይስጡ

የመጨረሻ ነጥብዎ HTTPS POST መቀበል፣ የጥያቄውን ቅርፅ ማረጋገጥ፣ ዝግጅቱን መቀጠል ወይም ሰልፍ ማድረግ እና ከዚያ የተሳካ 2xx ምላሽ መስጠት አለበት። ደህንነቱ በተጠበቀ ሁኔታ ሊሰለፍ የሚችል ከሆነ ከእውቅናው በፊት የዘገየ CRM ወይም የመልእክት ጥሪ አታድርጉ።

ከ ⟦801 ጋር ይዛመዳል

እያንዳንዱ ተዛማጅ ክስተት ካርዱን ሲፈጥሩ ወይም ሲቃኙ የተጠቀሙባቸውን External ID እና አማራጭ External Source መያዝ ይችላሉ። የራስዎን CRM፣ POS ለማዘመን፣ ወይም ከስም እና ኢሜል ሳትገምቱ መዝገብ ለማዘዝ ይህንን ጥንድ ይጠቀሙ።

⟦806

የጎንዮሽ ጉዳቶችን ከማስነሳትዎ በፊት ዘላቂ የማስኬጃ ቁልፍ ወይም የክስተት አሻራ ያከማቹ። ተቀባይዎ እንደገና ተመሳሳይ ማድረስ ካየ፣ የተባዛ CRM ማስታወሻ፣ ቫውቸር ወይም መልእክት መጨመር የለበትም። የመጨረሻውን ነጥብ ⟦807 እንደ ምስጢር አድርገው ይያዙት።

የዝግጅት ጭነት ቅርፅ ምሳሌ

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

{
  "entity": "card_event",
  "action": "created",
  "entity_id": 707,
  "event_id": "8f05e58decec48e09d328f0edebbacf6",
  "profile_id": 2,
  "profile_name": "Your Business",
  "profile_lang": "en",
  "data": {
    "event_type": "SCAN",
    "scanned_at": "2026-10-01T09:19:24.179424",
    "user_card_id": 10,
    "card_template_id": 14,
    "card_template_name": "Collect your stamps!",
    "stamps_added": 3,
    "stamps_before": 1,
    "stamps_after": 4,
    "amount": null,
    "external_order_id": "ORDER-1001",
    "workplace": { "id": 4, "name": "Bar Counter" },
    "device_type": null,
    "external_id": "odoo_contact_8821",
    "external_source": "odoo",
    "issued_vouchers": [
      {
        "id": 174,
        "unique_code": "100425813507",
        "stamp_number": 4,
        "issued_at": "2026-10-01T09:19:24.191836",
        "expires_at": "2027-01-01T23:59:59",
        "status": "ACTIVE",
        "voucher_template_id": 58,
        "voucher_description": "Free coffee",
        "voucher_image_url": "https://..."
      }
    ],
    "achieved_goals": [],
    "user": {
      "id": 2,
      "name": "Anna",
      "full_name": "Anna Smith",
      "email": "anna@example.com",
      "telegram_chat_id": null,
      "telegram_username": null,
      "whatsapp_phone": null,
      "birth_date": null
    }
  }
}

የድር መንጠቆን ያዋቅሩ እና ይሞክሩት።

በጀርባዎ ውስጥ HTTPS የመጨረሻ ነጥብ፣ CRM ውህደት ንብርብር፣ Make የድር መንጠቆ ወይም Zapier Catch Hook ይፍጠሩ። Make መድረሻውን URL ከመቅዳትዎ በፊት መቆጣጠሩን እርግጠኛ ይሁኑ።

በ 7Stamp Admin ውስጥ፣ Stamp Cards → API & Integrations → Webhooks ክፈት።

የመጨረሻ ነጥቡን URL ያክሉ። ዌብሁኩ የመገለጫውን እያንዳንዱን የካርድ ክስተት ይቀበላል፤ ስለዚህ በተቀባይዎ ውስጥ በ data.event_type ያጣሩ።

የመገለጫ ቅንብሮችን ያስቀምጡ፣ ከዚያ አንድ ክስተት ለመስራት ሊጣል የሚችል የፍተሻ ቅኝት ወይም የካርድ እርምጃ ያስነሱ።

የተቀበለውን ጭነት ይፈትሹ. ከተጠበቀው መዝገብ ጋር External ID እና External Source በማዛመድ ተቀባዩ የተሳካ ምላሽ እንደሰጠ ያረጋግጡ።

CRM፣ ቫውቸር ወይም የመልእክት መላላኪያ የጎንዮሽ ጉዳቶችን ያንቁ ድጋሚ አጫውት ደህንነቱ የተጠበቀ አያያዝ እና ውድቀቶችን መከታተል ከጀመሩ በኋላ ነው።

ኮድ የለሽ አማራጮች፡ Make እና Zapier

በ Make ውስጥ ተቀባይ URL ለማመንጨት Webhooks → Custom webhook ይጠቀሙ እና ወደ 7Stamp ፕሮፋይል ይለጥፉ። በZapier ለተመሳሳይ ዓላማ Webhooks by Zapier → Catch Hook ይጠቀሙ። የአሁኑ API አውቶማቲክ የዌብ መንጠቆ መመዝገቢያ የመጨረሻ ነጥቦችን ስለማያጋልጥ የ7stamp ፕሮፋይሉ የደንበኝነት ምዝገባው ባለቤት ነው።

የደህንነት እና የመላኪያ ውል

ለአሁኑ የ payload መዋቅር ምንጭ አድርገው የሕዝባዊውን OpenAPI ማጣቀሻ የ Webhooks ክፍል ይጠቀሙ። አካሉ ኤንቨሎፕ ነው፦ profile_id እና profile_name የ 7Stamp መገለጫውን ይሰይማሉ፣ event_id ክስተቱን ይለያል፣ የካርዱ ክስተት ራሱ ደግሞ በ data ውስጥ ነው (ለ Make ወይም Zapier URL ቁልፉ card_event ነው)። እያንዳንዱ መላኪያ በአንድ ራስጌ ይፈረማል፣ X-Webhook-Signature: t=…,s=…። በዌብሁክ ሚስጥርዎ በ t እና በጥሬው የጥያቄ አካል ጥምረት ላይ HMAC-SHA256 ያስሉ፣ በ hex ኢንኮድ ያድርጉት እና ከ s ጋር ያነጻጽሩት፤ ሚስጥሩ በ 7Stamp Admin ውስጥ በዌብሁኩ ገጽ ላይ ይገኛል። ተደጋጋሚ መላኪያዎችን ለማስወገድ X-Webhook-Event-Id ይጠቀሙ፦ ድጋሚ ሙከራ በአዲስ t እንደገና ይፈረማል። የመጨረሻ ነጥቡን በ Basic Auth መጠበቅም ይችላሉ። HTTPS ግዴታ ያድርጉ፣ የተቀባዩን URL ከሕዝባዊ ምዝግብ ማስታወሻዎች ያርቁ።

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

የተወሰኑ የድር መንጠቆ ክስተቶችን ብቻ መምረጥ እችላለሁ?

አይቻልም። የ 7Stamp ዌብሁክ የመገለጫውን እያንዳንዱን የካርድ ክስተት ይቀበላል። በተቀባይዎ ውስጥ በ data.event_type ያጣሩ፤ በ Make እና Zapier ውስጥ ክስተቱ በ card_event ስር ይመጣል፣ ስለዚህ በ card_event.event_type ያጣሩ።

የድር መንጠቆዎችን ከMake ወይም Zapier ጋር እንዴት ማገናኘት እችላለሁ?

የሚቀበለውን የድር መንጠቆ በMake ወይም Catch Hook በZapier ይፍጠሩ፣ የፈጠረውን URL ገልብጠው ከዚያ ወደ 7Stamp ፕሮፋይል ዌብ መንጠቆ ቅንብሮች ውስጥ ይለጥፉ እና የሙከራ ክስተት ይላኩ።

አንድን ክስተት ከእኔ CRM አድራሻ ጋር እንዴት ማዛመድ አለብኝ?

data.external_id እና፣ ሲኖር፣ data.external_source ይጠቀሙ፦ በራስዎ ID በ API በኩል ላወጧቸው ካርዶች በእያንዳንዱ ዌብሁክ ውስጥ ይመለሳሉ። ካርዱን ራሱ የወሰደ ደንበኛ External ID የለውም፤ ስለዚህ በ data.user.email ያዛምዱት። የ Apple «Hide My Email» አድራሻ የማስተላለፊያ አድራሻ ነው እንጂ በእርስዎ CRM ውስጥ ያለው አይደለም።

ዌብሁክ ከ 7Stamp መምጣቱን እንዴት ማረጋገጥ እችላለሁ?

የ X-Webhook-Signature ራስጌን ወደ t እና s ይክፈሉ፣ ከ 7Stamp Admin በተገኘው የዌብሁክ ሚስጥር በ t እና በጥሬው የጥያቄ አካል ጥምረት ላይ HMAC-SHA256 ያስሉ፣ በ hex ኢንኮድ ያድርጉት እና ከ s ጋር ያነጻጽሩት። t ን ልክ እንደተላከው፣ አካሉን ደግሞ እንደተቀበሉት ጥሬ ባይቶች፣ ከማንኛውም የ JSON ትንተና በፊት ይውሰዱ። ቀደም ብለው ያስኬዱት X-Webhook-Event-Id ያለው መላኪያ ካለ ያስወግዱት፦ ድጋሚ ሙከራ በአዲስ t እንደገና ይፈረማል።

ተዛማጅ ገጾች

ክፍት ⟦788 ማጣቀሻ ⟦789 መመሪያ ⟦790 መመሪያ REST API መመሪያ

ቀጣዩ ደረጃ

የመጀመሪያውን የካርድ ክስተት ለመላክ ዝግጁ ነዎት?

ሪሲቨር ይፍጠሩ፣ HTTPS URL ወደ ፕሮፋይሉ ይለጥፉ፣ ሊጣል የሚችል ስካን ያሂዱ እና የታችኛው ዥረት አውቶማቲክን ከማንቃትዎ በፊት ተዛማጅ External ID ያረጋግጡ።

ክፍት 7Stamp Admin ⟦797 ማጣቀሻውን ያንብቡ