ዌብሁክ ምንድን ነው? መተግበሪያዎች እርስ በርስ እንዴት እንደሚያሳውቁ

ዌብሁክ አንድ አገልግሎት አንድ ነገር በተፈጠረ ቅጽበት ወደ መተግበሪያዎ የሚልከው አውቶማቲክ መልዕክት ነው። ደንበኛ ክፍያ ሲሳካ Stripe በመተግበሪያዎ ውስጥ ወዳለ አድራሻ «ክፍያ ተሳካ፣ ዝርዝሩ ይኸውና» የሚል ዌብሁክ ይልካል፤ መተግበሪያዎም ምላሽ ይሰጣል — ትዕዛዙን እንደተከፈለ ምልክት ያደርጋል፣ ደረሰኝ ይልካል፣ መለያውን ይከፍታል። በአጭሩ፦ API መተግበሪያዎ ሌላ አገልግሎትን ጥያቄ የሚጠይቅበት ነው፤ ዌብሁክ ደግሞ ሌላው አገልግሎት መተግበሪያዎን ነገር ለመንገር የሚጠራበት ነው።

በAI ሲገነቡ ለምን ይጠቅማል

መተግበሪያዎ ክፍያ መቀበል፣ ከሌላ መሣሪያ የቅጽ ማስገባቶችን መቀበል ወይም እንደ GitHub፣ Shopify ወይም ካላንደር ካሉ አገልግሎቶች ጋር መገናኘት እንደጀመረ፣ ዌብሁኮችን ያጋጥማሉ። ብዙ ጊዜ አንድ ነገር መፈጠሩን ለማወቅ ትክክለኛው መንገድ ናቸው፤ ግን በAI የተገነቡ መተግበሪያዎች በስውር ብዙ ጊዜ ስህተት የሚሆኑባቸውም እዚህ ነው፦

• የመጨረሻ ነጥቡ ማንኛውንም ጥያቄ ይቀበላል፤ ስለዚህ ማንም «ክፍያ ተሳካ» የሚል የውሸት ክስተት ሊልክ ይችላል።
• መተግበሪያው መዳረሻን የሚሰጠው በዌብሁኩ ፋንታ በክፍያ ማረጋገጫ ገጹ ላይ ነው፤ ስለዚህ ገጹን ቀድመው የዘጉ ሰዎች የከፈሉትን አያገኙም፤ የስኬት URLውን ያገኙ ሰዎች ግን ያለ ክፍያ ያገኙታል።
• አንድ ክስተት ሁለት ጊዜ ይደርሳል፤ ደንበኛው ሁለት ትዕዛዞችን ወይም ሁለት ኢሜይሎችን ያገኛል።

ዌብሁኮች እንዴት እንደሚሰሩ ማወቅ ጥበቃዎቹን ከመጀመሪያው እንዲጠይቁ ይረዳዎታል።

የዕለት ተዕለት ምሳሌ፦ የጥቅል መልዕክት

ጥቅልዎ መድረሱን ሁለት መንገድ ማወቅ ይችላሉ። በየአሥር ደቂቃው ወደ የፊት በር ሄደው ማየት ይችላሉ (ይህ polling ነው — መተግበሪያዎ ደጋግሞ API ጠርቶ «አዲስ ነገር አለ?» ብሎ መጠየቅ)። ወይም አስተላላፊው ሲደርስ ጽሑፍ ሊልክልዎ ይችላል (ይህ ዌብሁክ ነው)።

ጽሑፉ በእርግጥ የተሻለ ነው — ማመን ከቻሉ። ማንም «ጥቅሉ ደርሷል» የሚል መልዕክት ሊልክልዎ ቢችል፣ ከአስተላላፊው መምጣቱን የሚያረጋግጡበት መንገድ ይፈልጋሉ። ስልክዎ ጠፍቶ መልዕክቱ ቢመጣ ደግሞ አስተላላፊው ቆይቶ እንደገና እንዲሞክር ይፈልጋሉ። እነዚህ ሁለት ጉዳዮች — ማረጋገጥ እና ድጋሚ ሙከራ — ዌብሁኮችን ከባድ የሚያደርጓቸው አብዛኛዎቹ ናቸው።

ዌብሁክ ደረጃ በደረጃ እንዴት ይሰራል

1. የመጨረሻ ነጥብ ይፈጥራሉ በመተግበሪያዎ ባክኤንድ ውስጥ፦ POST ጥያቄዎችን የሚቀበል እንደ https://yourapp.com/webhooks/stripe ያለ አድራሻ።
2. አድራሻውን ከአቅራቢው ጋር ያስመዘግባሉ እና የሚፈልጓቸውን ክስተቶች ይመርጣሉ (ለምሳሌ «checkout completed» እና «subscription cancelled»)።
3. አቅራቢው የመፈረሚያ ሚስጥር ይሰጥዎታል። በሰርቨርዎ ላይ እንደ ሚስጥር ያስቀምጡታል — ኤንቫይሮንመንት ተለዋዋጮችና ሚስጥሮች ይመልከቱ።
4. ክስተት ይፈጠራል። አቅራቢው ወደ አድራሻዎ የHTTP ጥያቄ በJSON አካል ውስጥ ክስተቱን የሚገልጽ እና የፊርማ ራስጌ ይዞ ይልካል።
5. መተግበሪያዎ ፊርማውን ያረጋግጣል፣ የክስተቱን ID ይመዘግባል፣ በፍጥነት የስኬት ኮድ (200) ይመልሳል፣ ከዚያም ሥራውን ያከናውናል።
6. መተግበሪያዎ የስኬት ምላሽ ካልመለሰ፣ ብዙ አቅራቢዎች ቆይተው እንደገና ይሞክራሉ።

ፊርማዎች

ፊርማ ጥያቄው ከአቅራቢው መምጣቱንና ያልተለወጠ መሆኑን ያረጋግጣል። ለምሳሌ Stripe በመፈረሚያ ሚስጥሩ በመጠቀም በጥያቄው አካልና በጊዜ ማህተም ላይ HMAC (በቁልፍ የተሠራ የጣት አሻራ ዓይነት) በSHA-256 ያሰላል፤ በStripe-Signature ራስጌ ውስጥ ይልካል። መተግበሪያዎም በራሱ የሚሰጠው ቅጂ ተመሳሳይ ስሌት ያደርጋል፤ ውጤቶቹ ከተዛመዱ ጥያቄው እውነተኛ ነው። ጊዜ ማህተሙም የተፈረመ ስለሆነ አንድ ሰው ቀድሞ ቀርጾ በኋላ የሚያጫውተውን የቆየ ጥያቄ መቀበል ይችላሉ — የStripe ቤተ-መጻሕፍት በሰነዱ መሠረት እስከ መስከረም 2026 ድረስ ነባሪው የአምስት ደቂቃ ይቅርታ ነበር።

አንድ ተግባራዊ ዝርዝር፦ ፊርማው የሚሰላው በጥሬ የጥያቄ አካል ላይ ነው። ማዕቀፍዎ ከማረጋገጡ በፊት JSONውን ቢተነትንና እንደገና ቢቀርጸው ፍተሻው ይወድቃል። ይህ በጣም የተለመደ ስህተት ነው።

ድጋሚ ሙከራዎች፣ ብዜቶችና ቅደም ተከተል

አቅራቢዎች ይለያያሉ፤ ስለዚህ የእያንዳንዱን ሰነድ ያረጋግጡ። እንደ መስከረም 2026፦

የStripe ሰነድ ክስተቶች የተከሰቱበትን ቅደም ተከተል እንደማይጠብቁ፣ እና ተመሳሳይ ክስተት አልፎ አልፎ ከአንድ ጊዜ በላይ ሊመጣ እንደሚችል ይናገራል፤ ስለዚህ የክስተት IDዎችን እንዲከታተሉ ይመክራል።

አጠቃላይ ትምህርቱ ለማንኛውም አቅራቢ ይሠራል፦ ክስተቶች ዘግይተው፣ ከአንድ ጊዜ በላይ እና ከቅደም ተከተል ውጭ ሊደርሱ ይችላሉ። ተቆጣጣሪዎ idempotent መሆን አለበት — ተመሳሳዩን ክስተት ሁለት ጊዜ ማስኬድ አንድ ጊዜ ከማስኬድ ጋር ተመሳሳይ ውጤት ይኖረዋል።

የተግባር ምሳሌ፦ የተከፈለ ኮርስ መክፈት

የኦንላይን ኮርስ ይሸጣሉ። ተማሪ Buy ይጫናል፣ በStripe የተስተናገደ የክፍያ ገጽ ላይ ይከፍላል፣ ወደ ድረ-ገጽዎ ይመለሳል።

ደካማው መንገድ፦ የ«አመሰግናለሁ» ገጽ ኮርሱን ይከፍታል። ተማሪው በመመለሻው ወቅት አሳሹን ቢዘጋ ከፍሎ መዳረሻ የለውም። የአመሰግናለሁ URLውን ማንም ቢገምት ያለ ክፍያ መዳረሻ ያገኛል።

የዌብሁክ መንገድ፦

1. Stripe ክፍያውን ሲያረጋግጥ ለ/webhooks/stripe የcheckout.session.completed ክስተት ይልካል።
2. ባክኤንድዎ ፊርማውን በመፈረሚያ ሚስጥሩ ያረጋግጣል። ካልተሳካ 400 ይመልሳል እና ምንም አያደርግም።
3. ያ የክስተት ID ቀድሞ ተስተናግዶ እንደሆነ ይፈትሻል። አዎ ከሆነ 200 ይመልሳል እና ያቆማል።
4. የክስተት IDውን ያስቀምጣል፣ 200 ይመልሳል፣ ከዚያም ለተማሪው መዳረሻ ይሰጣል እና የእንኳን ደህና መጡ ኢሜይል ይልካል።
5. የአመሰግናለሁ ገጹ «ክፍያ ተቀብለናል — ኮርስዎ በቅጽበት ይታያል» ብቻ ይላል እና የተማሪውን የመዳረሻ ሁኔታ ይፈትሻል።

በኋላ፣ የደንበኝነት ምዝገባ ቢሰረዝ ወይም ካርድ ቢወድቅ፣ ሌሎች የዌብሁክ ክስተቶች መተግበሪያዎ መዳረሻውን እንዲያነሳ ወይም እንዲያቆም ይነግሩታል። የደንበኝነት ምርቶች ከክፍያ ጋር እንዴት እንደሚጣጣሙ ይህ ነው — SaaS ምንድን ነው እና ክፍያዎችን ወደ መተግበሪያዎ እንዴት እንደሚጨምሩ ይመልከቱ።

ቁልፍ ቃላት

• Endpoint (የመጨረሻ ነጥብ): ዌብሁኮችን የሚቀበለው በመተግበሪያዎ ውስጥ ያለ አድራሻ።
• Event / payload (ክስተት / ይዘት): ምን እንደተፈጠረና የሚገልጸው ዳታ (ብዙ ጊዜ JSON)።
• Signing secret (የመፈረሚያ ሚስጥር): ፊርማዎችን ለማረጋገጥ የሚያገለግል የጋራ ሚስጥር።
• Idempotent: በተመሳሳይ ውጤት ከአንድ ጊዜ በላይ ለማስኬድ ደህንነቱ የተጠበቀ።
• Polling: ዌብሁክን ከመጠበቅ ይልቅ ለለውጦች ደጋግሞ API መጠየቅ።
• Tunnel: በልማት ጊዜ ዌብሁኮች እንዲደርሱ ለላፕቶፕ ጊዜያዊ የህዝብ URL የሚሰጥ መሣሪያ።

የተለመዱ ስህተቶችና ግንዛቤ ጉድለቶች

• ፊርማዎችን አለማረጋገጥ። የመጨረሻ ነጥቡ URL ሚስጥር አይደለም። ማረጋገጡ ጥያቄውን ታማኝ የሚያደርገው ነው።
• ከመመለሳችን በፊት ቀርፋፋ ሥራ መሥራት። ከመመለስ በፊት ኢሜይል መላክ ወይም PDF ማመንጨት ጊዜ ማብቂያ ሊያስከትል ይችላል፤ ይህም ድጋሚ ሙከራ ያስነሳል፣ ይህም ብዜቶችን ያመጣል።
• በትክክል አንድ ጊዜ፣ በቅደም ተከተል ነው ብሎ መገመት። የክስተት IDዎችን ይመዝግቡ፤ በመድረሻ ቅደም ተከተል አይታመኑ።
• የቅድመ-እይታ URL መጠቀም። ዌብሁኮች ቋሚ የህዝብ አድራሻ ያስፈልጋቸዋል። የግል ቅድመ-እይታዎችና localhost ከበይነመረብ አይደረሱም፤ የተለቀቀውን URLዎን ይጠቀሙ (ወይም በሙከራ ጊዜ tunnel)።
• የሙከራና የቀጥታ ሚስጥሮችን መቀላቀል። አቅራቢዎች ለሙከራና ለቀጥታ ሁነታዎች ብዙ ጊዜ የተለያዩ የመፈረሚያ ሚስጥሮችን ይሰጣሉ። ሁለቱንም ያስቀምጡ፤ ትክክለኛውን ይጠቀሙ።
• ለጠቃሚ ውሳኔዎች ክስተቱን ሳያረጋግጡ መተማመን። ለከፍተኛ ውጤት እርምጃዎች ክስተቱን ከተቀበሉ በኋላ የቅርብ ጊዜውን ሁኔታ ከአቅራቢው API ማምጣት ምክንያታዊ ነው።

ከAI ገንቢዎ ምን እንደሚጠየቅ

በሰርቨሩ ላይ POST /webhooks/stripe የመጨረሻ ነጥብ ጨምር። የStripe ፊርማውን በጥሬ የጥያቄ አካልና STRIPE_WEBHOOK_SECRET ሚስጥር አረጋግጥ። ልክ ያልሆኑ ፊርማዎችን በ400 ውድቅ አድርግ። እያንዳንዱን የክስተት ID አስቀምጥ፤ ቀድሞ የተስተናገዱ ክስተቶችን ዝለል። በፍጥነት 200 መልስ፣ ከዚያም checkout.session.completedን ትዕዛዙን የተከፈለ ምልክት በማድረግና ደረሰኙን በመላክ ተቆጣጠር። የክስተት ዓይነቱን መዝግብ። መዳረሻን ከክፍያ ስኬት ገጹ ላይ አትስጥ።

ከዚያም ይሞክሩት፦ ከአቅራቢው ዳሽቦርድ የሙከራ ክስተት ይላኩ፣ ያንኑ እንደገና ይላኩ፣ እና የተሳሳተ ፊርማ ያለው ጥያቄ ይላኩ። የመጀመሪያው ብቻ ነገር መቀየር አለበት።

ዌብሁኮች በMythex

Mythex የተለየ የዌብሁክ አገልግሎት አያሄድም፤ ወኪሉን በመተግበሪያዎ የራሱ ባክኤንድ ውስጥ የዌብሁክ መጨረሻ ነጥብ እንዲጨምር ይጠይቃሉ፤ አቅራቢውንም ወደ የተለቀቀው URLዎ ይጠቁማሉ፤ ዌብሁኮች የህዝብ አድራሻ ስለሚያስፈልጋቸው። የመፈረሚያ ሚስጥሩ ወደ የፕሮጀክት ሚስጥሮችዎ ይገባል፤ በቀጥታ መተግበሪያ ላይ ከቀየሩት ደግሞ እንደገና ያትሙ። ዌብሁኮችን ማስተናገድ የሚለው የሰነድ አሰራር መነሻ ጥያቄ አለው፤ ክፍያ ለሚቀበሉ መተግበሪያዎች የመደብር አብነቶች ጥሩ መነሻ ናቸው።

ጥያቄዎች