Skip to main content

پشکی سەرەتایی لە Webhooks (v2)

توخانە: ئاماژە بەوە بکە کە ئەم تایبەتمەندی یان ئەم بابەتە بۆ بەکارهێنەرانی پێشکەوتووە.

Webhook شێوازێکە بۆ ئەوەی بەرنامەیەکی وەک Ultimate Multisite بێت، باشتر دەتوانێت زانیارییە ڕاستەوخۆکان بدات بە بەرنامەکانی دیکە. Webhook داتا یان پەیامەکان لە کاتی ڕووداوەکەدا (as it happens) بۆ بەرنامە دیاریکراوەکان دەبینێت، واتە تۆ هەموو خێراتر دەبیت.

ئەمە بەسوودە ئەگەر پێویستت بێت کە داتای دیاریکراو لە Ultimate Multisite بۆ سیستەم یان CRMێکی دیکە ڕێپێبدەیت هەمواری کاتێک ڕووداوێک چالاک دەبێت. بۆ نموونە، پێویستت بەوەیە ناوت و ئیمەیڵەکەت بۆ لیستێکی پەیامکردن (mailing list) بنێری هەر جارێک کە یوزر نوێیەکی دروست دەکرێت.

چۆنیەتی دروستکردنی Webhook

بۆ دروستکردنی webhook، بچۆ بۆ داش보ار ADMINISTRATORی تۆی تۆڕ (network admin dashboard). لەسەر Ultimate Multisite > Webhooks > Add New Webhook کلیک بکە.

پەڕەی لیستێکی Webhooks کە پەیامی Add New Webhook دەبینراوە

ئەو کات دەتوانیت پێکهاتەی webhookەکە بگۆڕیت:

فۆرمی دروستکردنی Webhook لەگەڵ فیلدا ناونیشان (Name)، ڕووداو (Event) و لۆکە (URL)

کاتێک Webhookێکی نوێ دەدات، پێشکەش دەکات زانیارییەکان وەک ناونیشان (Name)، URL و ڕووداو (Event). دەتوانیت هەر ناونیشانێک بەکاری بهێنیت بۆ webhookەکە. گرنگترین فیلدەکان URL و Eventن.

پێکهاتەی چاککردنی Webhook کە فیلدی URL و پیشمی داتای پەیامەکە نیشان دەدات

URL بریتییە لە خاڵێکی کۆتایی یان گەشت کە Ultimate Multisite بۆی دەست دەکات بەپێی ئەو داتایە یان پەیامەکە (payload or data). ئەمە بەرنامەیە کە داتا وەردەگرێت.

Zapier بە سوودترین چارەسەرە کە بەکارهێنەران لە دروستکردنی پەیوەندی لەگەڵ بەرنامەکانی تری ئاسایی دەکەن ئاسانتر بکەن. بەبێ پلاتفۆرمێکی وەک Zapier، پێویستت دەبێت خۆت فانکشنێکی تایبەت بە شێوەیەکی دەستکرد دروست بکەیت کە داتایەکە دەگرێتەوە و پرۆسێس دەکاتەوە. بۆ زیاتر بخوێنەرەوە لەم بابەتە: چۆنیەتی بەکارهێنانی Ultimate Multisite webhook لەگەڵ Zapier.

بۆ ئەم بابەتە، دەبینین کە چۆن کار دەکات بیرۆکەی webhook و ئەو ڕووداوە (events) چیان هەن لە Ultimate Multisite دا. ئێمە گۆڕیەک بەناوی requestbin.com بەکاری دەهێنین. ئەم سایتە دەبێت بێت بۆ ئەوەی بتوانین endpointێک دروست بکەین و payload (داتای نێردراو) وەربگرین بەبێ ئەوەی هیچ کۆدی بنووسین. تێبینی: هەموو کارەکەی بریتییە لە نیشاندانی ئەوەی داتاکە لەسەرێت. هیچ پرۆسێسێک یان هیچ جۆرە کارێک لەسەر payloadەکە ناکرێت.

بڕۆ بۆ requestbin.com و پەڕە بکە سەر دڵنیایی (Create Request Bin).

پاش ئەوەی ئەو بٹنە دەچۆشیت، پێشت دەدات کە Login بکەیت ئەگەر یەکەم جار بەکارخستنی ئەکاونت نییە یان تۆمار بکە. ئەگەر لەبەر ئەوەی ئەکاونتت هەیە، ڕاستەوخۆ دەباتە داشبۆردەکەی. لە داشبۆردەکەی، دەتوانیت بە خێرایی endpoint یان URLەکە ببینیت کە دەتوانیت بۆ دروستکردنی webhookی Ultimate Multisite ی خۆت بەکاربهێنیت.

ئێستا URLەکە کۆپی بکە و بگەڕە سەر Ultimate Multisite. Endpointەکە لە فیلدی URLەکەدا دابنێ و یەکێک لە ڕووداوەکان (event) لە دراپ다운ەکەدا هەڵبژێرە. لەم نموونەدا، ئێمە Payment Received (پایلامان وەربراوە) دەبینینەوە.

ئەم ڕووداوە هەر کاتێک یەکێک لە بەکارهێنەران پارە دابنێت. هەموو ئەو ڕووداوانەی هەن، وەسفیان، و payloadیەکانیان لە خاڵی کۆتاییی لاپەڕەکەدا لیست کراون. بۆ شۆڕکردنی webhookەکە، پەڕە بکە سەر دڵنیایی Add New Webhook (بۆ زیادکردنی webhook نوێ) یان Save بکە.

Webhook event dropdown with Payment Received selected

ئێستا دەتوانین ڕووداوێکی تاقیکردنەوە بۆ endpointەکە بڵێینەوە بۆ ئەوەی ببینین کە webhookی دروست کردووین کار دەکات یان نا. دەتوانیت ئەمە بکەیت بە پەڕەکردنی Send Test Event (نێرستنی ڕووداوێکی تاقیکردنەوە) لە خواردا webhookەکە کە دروست کردووە.

Webhooks list showing one configured webhook and Send Test action

ئەمە دەربڕینی پاشکارێ دەکات کە تاقیکردنەوەکە سەرکەوتوو بووە.

Webhook test event result after sending a test payload

ئەگەر بگەڕێین بۆ سایتەکەی Requestbin دەبینیت کە پەیامەکە بەدەستخستووە و لە ناویدا داتای تاقیکردنەوەی هەبووە.

ئەمە بنەڕەتی کارکردنێکی webhook و endpointsە. ئەگەر دەتەوێت endpoint تایبەت دروست بکەیت، پێویستە فانکشنێکی تایبەت دروست بکەیت بۆ پرۆسێسی داتایەک کە لە Ultimate Multisite دەبینیت.