# वेबहुक क्या है और इसका क्या उपयोग है?

> वेबहुक किसी सॉफ़्टवेयर में घटना होते ही अपने-आप सूचना भेजता है। जानें वेबहुक क्या है, यह कैसे काम करता है, छोटे व्यवसाय (PME) के लिए आंकड़ों वाला उदाहरण और सुरक्षा की आम गलतियाँ व उनसे बचाव के आसान तरीके।

अपडेट किया गया 15 अक्टूबर 2026 · https://app.pilotiko.com/hi/glossary/webhook

वेबहुक एक ऐसी व्यवस्था है जिसमें कोई सॉफ़्टवेयर, किसी खास घटना के होते ही (जैसे भुगतान मिलना या बुकिंग बनना), चुने हुए वेब पते पर डेटा वाला HTTP अनुरोध अपने-आप भेज देता है। इसलिए सूचना पाने वाले सिस्टम को स्रोत सॉफ़्टवेयर से बार-बार पूछना नहीं पड़ता।

## संक्षेप में
- किसी घटना के लिए एक बार सदस्यता लेनी होती है; उसके बाद सूचनाएँ अपने-आप आती रहती हैं।
- वेबहुक API का पूरक है: यह जानकारी मांगे जाने का इंतज़ार करने के बजाय खुद भेज देता है।
- मिलने वाले हर संदेश का सिग्नेचर जाँचना ज़रूरी है।
- अच्छा रिसीवर जल्दी जवाब देता है और एक ही सूचना दो बार आने पर उसे संभाल लेता है।

## वेबहुक कैसे काम करता है?

GitHub का दस्तावेज़ इस सिद्धांत को अच्छी तरह समझाता है: आप किसी सॉफ़्टवेयर सिस्टम में होने वाली घटनाओं की सदस्यता लेते हैं और जब भी वे घटित होती हैं, आपके सर्वर पर डेटा अपने-आप पहुँच जाता है। फ़ायदा यह है कि जानकारी उसी समय मिलती है जब वह बनती है, बजाय इसके कि बीच-बीच में [API](https://app.pilotiko.com/hi/glossary/api) से पूछा जाए कि कुछ नया है या नहीं [1]।

वेबहुक बनाते समय एक पता (URL) और वे घटनाएँ बतानी होती हैं जिनमें आपकी रुचि है। जब उनमें से कोई घटना होती है, तो स्रोत सॉफ़्टवेयर उस पते पर घटना के ब्योरे के साथ HTTP अनुरोध भेजता है। सुनने वाला सर्वर तब कार्रवाई कर सकता है: सूचना भेजना, कोई रिकॉर्ड अपडेट करना, या अगला चरण शुरू करना [1]।

कई [सॉफ़्टवेयर-सेवाएँ](https://app.pilotiko.com/hi/glossary/saas) वेबहुक देती हैं। इनसे अक्सर बुकिंग आते ही [कार्य-आदेश](https://app.pilotiko.com/hi/glossary/work-order) बनाया जाता है, या [कोटेशन](https://app.pilotiko.com/hi/glossary/quote) तैयार करने वाले व्यक्ति को सूचित किया जाता है।

## सेवा देने वाले छोटे व्यवसाय में कौन-सी घटनाएँ वेबहुक को चालू करती हैं?

| स्रोत सॉफ़्टवेयर में घटना | भेजा गया डेटा | संभावित प्रतिक्रिया |
|---|---|---|
| कार्ड से भुगतान स्वीकार हुआ | राशि, ग्राहक, चालान क्रमांक | अकाउंटिंग में चालान को भुगतान किया हुआ चिह्नित करना |
| साइट पर बुकिंग बनी | तारीख, सेवा, संपर्क विवरण | तकनीशियन का कार्य-आदेश बनाना |
| कोटेशन का फ़ॉर्म भरा गया | बताई गई ज़रूरत, पता | कोटेशन तैयार करने वाले व्यक्ति को सूचित करना |
| सदस्यता रद्द हुई | ग्राहक, समाप्ति की तारीख | ग्राहक को निर्धारित दौरों से हटाना |

उपलब्ध घटनाएँ पूरी तरह हर सॉफ़्टवेयर पर निर्भर करती हैं; उसका दस्तावेज़ देखें।

## अगर सूचना पाने वाला सर्वर बंद हो जाए तो क्या होता है?

अच्छे प्रदाता दोबारा कोशिश करते हैं। उदाहरण के लिए, Stripe बताता है कि वास्तविक मोड में वह किसी घटना को अधिकतम तीन दिन तक पहुँचाने की कोशिश करता है, और कोशिशों के बीच का अंतराल बढ़ता जाता है; अपने टेस्ट वातावरण में वह कुछ घंटों में तीन बार दोबारा कोशिश करता है [2]।

व्यावहारिक नतीजा: एक ही सूचना एक से ज़्यादा बार आ सकती है। रिसीवर को पहले से संभाली जा चुकी घटना पहचाननी चाहिए, ताकि, मिसाल के तौर पर, एक ही चालान दो बार न बन जाए।

## वेबहुक कितने बेकार अनुरोधों से बचाता है?

**गणना: रिमूस्की की 3 कमरों वाली फ़िज़ियोथेरेपी क्लिनिक जो अपनी बुकिंग सिंक करती है**

- विकल्प 1: रोज़ 12 घंटे हर 5 मिनट में API से पूछना : प्रतिदिन 144 अनुरोध
- प्रतिदिन असल में नई बुकिंग (अनुमान) : 18
- बिना किसी नई जानकारी वाले अनुरोध (144 − 18) : 126
- विकल्प 2: "बुकिंग बनी" घटना पर वेबहुक : प्रतिदिन 18 सूचनाएँ
- बुकिंग दिखने में अधिकतम देरी, विकल्प 1 : 5 मिनट तक
- **= वेबहुक सिर्फ़ 18 काम की घटनाएँ, उनके होते ही भेजता है, जबकि पुराने तरीके में 144 जाँचें होती हैं जिनमें से 126 में कुछ नहीं मिलता।**

## सुरक्षा और डिज़ाइन की कौन-सी गलतियाँ आम हैं?

- वेबहुक के पते पर आया हर संदेश बिना सिग्नेचर जाँचे स्वीकार कर लेना: कोई भी नकली "भुगतान मिला" भेज सकता है।
- सिग्नेचर जाँचने से पहले संदेश की मूल बॉडी बदल देना: Stripe बताता है कि कोई भी बदलाव जाँच को विफल कर देता है [2]।
- जवाब देने से पहले पूरी प्रोसेसिंग करना: कुछ प्रदाताओं में बहुत धीमे जवाब को विफलता गिना जा सकता है और दोबारा भेजा जा सकता है।
- डुप्लिकेट न संभालना, जबकि दोबारा कोशिशें सामान्य बात हैं।
- ऐसा [ऑटोमेशन](https://app.pilotiko.com/hi/glossary/process-automation) जोड़ देना जो सूचना मिलते ही बिना किसी इंसानी जाँच के ग्राहक को संदेश भेज दे।

## क्या Pilotiko वेबहुक का उपयोग करता है?

Pilotiko की क्षमताओं की सूची में ग्राहकों के लिए कोई वेबहुक नहीं बताया गया है; इसलिए हम उसका दावा नहीं करते। भेजे जाने वाले संदेशों पर हमारा रुख साफ़ है: Pilotiko में जो कुछ ग्राहक, पैसे या किसी भेजे जाने वाले संदेश से जुड़ा है, वह [किसी व्यक्ति की मंज़ूरी](https://app.pilotiko.com/hi/glossary/human-in-the-loop) का इंतज़ार करता है, भले ही जानकारी अपने-आप आई हो।

## अक्सर पूछे जाने वाले सवाल

### वेबहुक और API में क्या अंतर है?

API में आपका प्रोग्राम जब चाहे तब सवाल पूछता है। वेबहुक में स्रोत सॉफ़्टवेयर कोई घटना होने पर खुद आपको खबर देता है। दोनों अक्सर एक-दूसरे के पूरक होते हैं: वेबहुक बदलाव का संकेत देता है, और फिर API से पूरा ब्योरा पढ़ा जाता है।

### क्या वेबहुक पाने के लिए सर्वर चाहिए?

आपको एक ऐसा वेब पता चाहिए जो अनुरोध सुन सके, चाहे वह आपका अपना सर्वर हो, होस्ट किया हुआ कोई फ़ंक्शन हो या कोई ऑटोमेशन टूल। भेजे गए डेटा की सुरक्षा के लिए यह पता HTTPS पर होना चाहिए।

### क्या वेबहुक तुरंत पहुँचता है?

वह घटना के समय ही रवाना हो जाता है, लेकिन असल देरी प्रदाता और नेटवर्क पर निर्भर करती है। रिसीवर बंद होने पर, दोबारा कोशिशों के बाद सूचना काफ़ी देर से पहुँच सकती है।

### कैसे पता चले कि वेबहुक सचमुच सही सॉफ़्टवेयर से आया है?

ज़्यादातर प्रदाता हर संदेश पर एक गुप्त कुंजी से सिग्नेचर लगाते हैं जो सिर्फ़ आपको पता होती है। आपका रिसीवर सिग्नेचर दोबारा निकालता है और जो संदेश मेल न खाए उसे अस्वीकार कर देता है।

### क्या वेबहुक छोटे व्यवसाय के लिए उपयुक्त हैं?

हाँ, खासकर ऑटोमेशन टूल के ज़रिए, जो आपकी जगह प्राप्ति का पता उपलब्ध करा देते हैं। किसी एक काम की घटना से शुरू करें, जैसे नई बुकिंग, और कुछ हफ़्तों तक नतीजा जाँचते रहें।

## स्रोत

1. GitHub Docs, « About webhooks », https://docs.github.com/en/webhooks/about-webhooks (देखा गया 2026-10-15)
2. Stripe Docs, « Receive Stripe events in your webhook endpoint », https://docs.stripe.com/webhooks (देखा गया 2026-10-15)
