Glossary
Webhook kya hai? WhatsApp webhook आसान भाषा में, उदाहरण के साथ
वह callback URL जिस पर Meta ग्राहक के मैसेज, sent, delivered, read और failed स्टेटस और टेम्पलेट अपडेट भेजता है, एक ऑर्डर मैसेज के उदाहरण और आम गड़बड़ियों के साथ।
लेखक Broadchat teamप्रकाशित 5 मिनट
Definition
वेबहुक (Webhook): Webhook एक HTTPS पता (URL) है जिसे Meta हर बार कॉल करता है जब किसी WhatsApp Business account पर कुछ होता है। ग्राहक के हर आने वाले मैसेज पर, और आपके भेजे हर मैसेज का स्टेटस बदलने पर (sent, delivered, read या failed), Meta इस URL पर एक JSON इवेंट भेजता है। टेम्पलेट की मंज़ूरी और कैटेगरी बदलने की ख़बर भी ऐसे ही आती है। चालू webhook के बिना बिज़नेस न जवाब देख सकता है, न डिलीवरी रिपोर्ट।
Also called: Callback URL, Webhook endpoint, WhatsApp webhook
Webhook kya hai: आसान भाषा में
सोचिए कि आप कूरियर वाले को हर दस मिनट फ़ोन करके पूछें "पार्सल पहुँचा क्या?"। Webhook इसका उल्टा है: पार्सल पहुँचते ही कूरियर वाला ख़ुद आपको ख़बर दे देता है। सॉफ़्टवेयर की भाषा में, webhook आपके सर्वर का एक पता है, और जब भी दूसरे सिस्टम में कोई घटना होती है, वह सिस्टम उसी पते पर जानकारी भेज देता है। WhatsApp में यह "दूसरा सिस्टम" Meta है।
WhatsApp webhook कैसे काम करता है
Cloud API आपके पूछने का इंतज़ार नहीं करता कि ग्राहक ने जवाब दिया या नहीं। आपका नंबर जोड़ने वाला ऐप Meta के पास एक callback URL रजिस्टर करता है और ज़रूरी WhatsApp fields को subscribe करता है। Meta पहले एक verification request से URL जाँचता है (एक verify token और एक challenge value, जो सर्वर को वापस लौटानी होती है)। उसके बाद हर इवेंट JSON बॉडी के साथ HTTPS POST बनकर आता है।
दो तरह के इवेंट सबसे ज़रूरी हैं:
- Messages: ग्राहक का भेजा टेक्स्ट, मीडिया, बटन टैप, लिस्ट से चुना विकल्प, लोकेशन वगैरह। हर एक के साथ भेजने वाले का नंबर, message ID और समय होता है।
- Statuses: आपके भेजे मैसेज के अपडेट, उसी message ID से पहचाने जाते हैं:
sent,delivered,readयाfailed(साथ में error code, जैसे 24 घंटे की विंडो बंद होने पर 131047)।
अकाउंट से जुड़े इवेंट भी webhook पर आते हैं, जैसे किसी मैसेज टेम्पलेट का Pending से Approved होना या उसकी कैटेगरी बदलना।
उदाहरण: एक ऑर्डर मैसेज का पूरा सफ़र
मीरा रंगोली होम चलाती हैं और 10:02 पर अर्जुन को ऑर्डर अपडेट भेजती हैं। अगले कुछ मिनटों में उनके सर्वर पर उसी message ID के तीन स्टेटस इवेंट आते हैं: sent, फिर फ़ोन तक पहुँचने पर delivered, फिर 10:15 पर read। 10:16 पर चौथा इवेंट आता है, इस बार एक मैसेज: अर्जुन ने Track order बटन टैप किया। हर इवेंट कुछ सेकंड में webhook पर पहुँचता है; मीरा का सिस्टम इन्हें message ID से मिलाकर एक ही बातचीत में दिखाता है।
अगर 10:15 पर मीरा का सर्वर बंद होता, तो ये इवेंट समय पर उनके सिस्टम तक नहीं पहुँचते। बार-बार फ़ेल होने वाला endpoint असली बिज़नेस जोखिम है: जवाब दिखते नहीं और रिपोर्ट "sent" पर अटकी रहती है।
आम दिक्कतें
| क्या दिख रहा है | संभावित कारण |
|---|---|
| कहीं कोई जवाब नहीं दिखता | ऐप WhatsApp Business account से subscribe नहीं है, या verification फ़ेल हुआ |
| स्टेटस sent पर रुक जाता है | endpoint error दे रहा है या टाइम-आउट हो रहा है |
| सिस्टम में एक ही मैसेज दो बार | दोबारा आए इवेंट (retry) message ID से अलग नहीं किए गए |
| किसी और नंबर के इवेंट | कई नंबर एक ही URL पर हैं और phone number ID अनदेखा हो रहा है |
Broadchat में webhook
Broadchat हर जुड़े नंबर के लिए Meta का webhook ख़ुद लेता है, इसलिए जवाब CRM → Live Chat में दिखते हैं और campaign रिपोर्ट स्टेटस से अपडेट होती है। अगर आपको ये इवेंट अपने सिस्टम (CRM, ERP या डेटा वेयरहाउस) में भी चाहिए, तो Channels → All Channels में हर चैनल आने वाले मैसेज और स्टेटस आपके URL पर forward कर सकता है। आपको Meta के पास ख़ुद कुछ रजिस्टर नहीं करना पड़ता। पूरा प्लेटफ़ॉर्म कैसे जुड़ता है, यह WhatsApp Business API क्या है और WhatsApp CRM पेज पर देखें।
Related terms
स्रोत
- Webhooks for the WhatsApp Cloud API — Meta for Developers, checked 12 October 2026
- Cloud API error codes — Meta for Developers, checked 12 October 2026
Broadchat team · Product and partner success team
The people who build and support Broadchat, the white-label WhatsApp Business API platform. We write from what we see while onboarding partners and their clients on the official WhatsApp Cloud API, and we check every article against Meta's current documentation.
आख़िरी अपडेट:
अक्सर पूछे जाने वाले सवाल
क्या एक नंबर के लिए एक से ज़्यादा webhook URL रख सकते हैं?
Meta इवेंट उसी ऐप को भेजता है जो WhatsApp Business account से subscribe है। वही इवेंट किसी दूसरे सिस्टम में चाहिए तो पहले सिस्टम से forward करें। Broadchat में चैनल का webhook forwarding यही काम करता है।
क्या read स्टेटस हमेशा आता है?
नहीं। read स्टेटस तभी आता है जब ग्राहक ने read receipts चालू रखी हों। delivered को भरोसेमंद संकेत मानें और read को बोनस।
मुझे 131047 कोड के साथ failed स्टेटस क्यों मिला?
इसका मतलब है कि आपने 24 घंटे की कस्टमर सर्विस विंडो बंद होने के बाद बिना टेम्पलेट वाला मैसेज भेजने की कोशिश की। इसकी जगह मंज़ूर मैसेज टेम्पलेट भेजें।