باہر جانے والے ویب ہُکس: یہ کیسے کام کرتا ہے
ویب ہُک وہ پیغام ہے جو سسٹم کچھ ہوتے ہی آپ کے کسی ایڈریس پر بھیجتا ہے، جیسے نئی لیڈ، انوائس بھیجی گئی، ادائیگی موصول ہوئی یا آرڈر دیا گیا۔ یوں دوسرا سسٹم بار بار پوچھنے کے بجائے فوراً ردِعمل دے سکتا ہے۔
سبق 3 از 9 · یہ کیسے کام کرتا ہے
یہ کیسے کام کرتا ہے
«System → Integrations → Integrations & API» پر «Webhook endpoints» کے پینل میں «Add endpoint» دبائیں۔ نام اور ایڈریس درج کریں، پھر «All events» پر نشان لگائیں یا فہرست سے الگ الگ ایونٹس چنیں۔
محفوظ کرنے کے بعد «Webhook signing secret» ایک بار دکھایا جاتا ہے۔ اسے وصول کرنے والے سسٹم میں کاپی کریں، جو اس سے جانچتا ہے کہ پوسٹ واقعی آپ کی سائٹ سے آئی ہے۔
جب کوئی سبسکرائب کیا ہوا ایونٹ ہوتا ہے تو سسٹم اس کی تفصیلات فوراً ایڈریس پر بھیج دیتا ہے۔ وصول کنندہ کو 10 سیکنڈ کے اندر کامیابی کا جواب دینا ہوتا ہے۔
ناکام پوسٹ دوبارہ 1 منٹ، 5 منٹ، 30 منٹ، 2 گھنٹے، 12 گھنٹے اور 24 گھنٹے بعد بھیجی جاتی ہے۔ اس کے بعد اسے ناکام نشان زد کر دیا جاتا ہے۔
جو اینڈ پوائنٹ لگاتار 25 بار ناکام ہو اسے سسٹم بند کر دیتا ہے اور ڈیش بورڈ پر ایک کرنے کا کام نظر آتا ہے۔ وصول کنندہ دوبارہ کام کرنے لگے تو اس کی قطار پر «Enable» دبائیں۔
قطار پر «Test»، یا اینڈ پوائنٹ کے صفحے پر «Send test event»، ایک آزمائشی پیغام بھیجتا ہے۔ اینڈ پوائنٹ کے صفحے پر اس کی حالیہ ڈیلیوریز بھی نظر آتی ہیں اور «Rotate secret» سے آپ سیکرٹ بدل سکتے ہیں۔
«Delivery log» ہر پوسٹ کو اس کے اسٹیٹس، اینڈ پوائنٹ اور ایونٹ، بھیجے گئے مواد اور موصول جواب کے ساتھ دکھاتا ہے۔ «Retry now» ناکام پوسٹ کو دوبارہ بھیجتا ہے۔ قطاریں 30 دن تک رکھی جاتی ہیں۔
یہ کہاں ملے گا
- System → Integrations → Integrations & API
/admin/integrations - Integrations & API → Delivery log
/admin/integrations/deliveries - System → Automations
/admin/automations
سیٹنگز جو اسے بدلتی ہیں
- Apps & modules (Automation & integrations)
/admin/apps
چیک لسٹ
آگے بڑھنے سے پہلے دیکھ لیں کہ آپ یہ کر سکتے ہیں:
- System → Integrations → Integrations & API کھولیں
- System → Integrations → Integrations & API پر Webhook endpoints کے پینل میں Add endpoint دبائیں۔
- محفوظ کرنے کے بعد Webhook signing secret ایک بار دکھایا جاتا ہے۔
- جب کوئی سبسکرائب کیا ہوا ایونٹ ہوتا ہے تو سسٹم اس کی تفصیلات فوراً ایڈریس پر بھیج دیتا ہے۔
- ناکام پوسٹ دوبارہ 1 منٹ، 5 منٹ، 30 منٹ، 2 گھنٹے، 12 گھنٹے اور 24 گھنٹے بعد بھیجی جاتی ہے۔
مشورے اور عام غلطیاں
- کچھ نہیں پہنچ رہا؟ ڈیلیوری لاگ کھولیں اور ناکام قطار پر جواب پڑھیں۔ غلط ایڈریس یا 10 سیکنڈ سے زیادہ لینے والا وصول کنندہ عام وجوہات ہیں۔
- دوبارہ کوشش کے بعد ایک ہی پوسٹ ایک سے زیادہ بار آ سکتی ہے۔ وصول کرنے والا سسٹم ڈیلیوری ID سے دہرائی گئی پوسٹس کو نظر انداز کرے۔
- «Rotate secret» کے بعد اگلی ہی پوسٹ نئے سیکرٹ سے سائن ہوتی ہے، اس لیے وصول کرنے والے سسٹم کو بھی اسی وقت اپڈیٹ کریں۔
- دوبارہ کوششیں بیک گراؤنڈ ورکر بھیجتا ہے۔ جب تک وہ رکا ہو، ناکام پوسٹس دوبارہ نہیں بھیجی جاتیں۔