आउटगोइंग वेबहुक: कैसे काम करता है
वेबहुक वह संदेश है जो सिस्टम कुछ होते ही आपके किसी पते पर भेजता है, जैसे नई लीड, इनवॉइस भेजा जाना, भुगतान मिलना या ऑर्डर आना। इससे दूसरा सिस्टम बार-बार पूछने के बजाय तुरंत प्रतिक्रिया दे सकता है।
पाठ 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» के बाद अगली ही पोस्ट नए सीक्रेट से साइन होती है, इसलिए पाने वाले सिस्टम को उसी समय अपडेट करें।
- दोबारा कोशिशें बैकग्राउंड वर्कर भेजता है। उसके रुके रहने तक असफल पोस्ट दोबारा नहीं भेजी जातीं।