वेबहुक से किसी भी सिस्टम से WhatsApp मैसेज भेजें
आपका स्टोर, CRM या बुकिंग टूल पहले से जानता है कि कब ऑर्डर आया, कब पेमेंट फ़ेल हुआ या कब अपॉइंटमेंट बुक हुआ। एक वेबहुक इनमें से हर इवेंट को WhatsApp मैसेज में बदल सकता है, आपकी तरफ़ से बिना किसी कोड के। यहाँ जानिए इसकी प्लानिंग, सुरक्षा और टेस्टिंग कैसे करें।
MonoChat टीम अपडेट किया गया: 8 मिनट में पढ़ें
इस पेज पर
किसी दूसरे सिस्टम में कुछ होने पर WhatsApp मैसेज भेजने के लिए, उस सिस्टम का वेबहुक ऐसे रिसीवर पर पॉइंट करें जो फ़ोन नंबर से ग्राहक को ढूँढे और उसे एक मंज़ूर किया गया WhatsApp टेम्पलेट मैसेज भेजे। आपका स्टोर, CRM या बुकिंग टूल ऑर्डर, पेमेंट और अपॉइंटमेंट के लिए पहले से वेबहुक भेजता है; असली काम यह चुनना है कि किन इवेंट पर मैसेज जाना चाहिए, टेम्पलेट लिखना, URL को सुरक्षित करना और ग्राहकों के कुछ भी देखने से पहले असली रिक्वेस्ट से टेस्ट करना।
इस गाइड में प्लानिंग, उसे तय करने वाले WhatsApp नियम, और MonoChat में अपने ख़ुद के वेबहुक URL से शुरू होने वाले फ़्लो से इसे बनाने का तरीक़ा शामिल है।
वेबहुक क्या है, और क्या नहीं
वेबहुक एक HTTP रिक्वेस्ट है, जो कोई इवेंट होने पर एक सिस्टम आपके दिए URL पर भेजता है। ऑर्डर बनने पर Shopify एक भेज सकता है, ऑर्डर अपडेट होने पर WooCommerce, डील के अगले स्टेज में जाने पर CRM, और अपॉइंटमेंट बुक होने पर बुकिंग टूल। रिक्वेस्ट में इवेंट की जानकारी होती है, आम तौर पर JSON में: ऑर्डर नंबर, रक़म, ग्राहक का नाम और WhatsApp के लिए सबसे ज़रूरी, एक फ़ोन नंबर।
वेबहुक अपने आप ग्राहक को कुछ नहीं भेजता। किसी चीज़ को रिक्वेस्ट रिसीव करनी होगी, तय करना होगा कि उसका क्या करना है, और WhatsApp Business API को कॉल करना होगा। वह “चीज़” या तो आपका ख़ुद लिखा और होस्ट किया हुआ कोड है, या एक ऑटोमेशन प्लैटफ़ॉर्म जो आपको वेबहुक URL देता है और बाकी सब बिना कोड के बनाने देता है।
किन इवेंट पर WhatsApp मैसेज भेजना चाहिए
हर इवेंट मैसेज के लायक़ नहीं होता। एक ही ऑर्डर पर पाँच नोटिफ़िकेशन पाने वाला ग्राहक सबको नज़रअंदाज़ करने लगता है। वही पल चुनें जिनका ग्राहक सच में इंतज़ार करते हैं:
| इवेंट | मैसेज | टेम्पलेट श्रेणी |
|---|---|---|
| ऑर्डर बना या पेमेंट हुआ | ऑर्डर नंबर और आगे क्या होगा, इसके साथ कन्फ़र्मेशन | यूटिलिटी |
| पेमेंट फ़ेल या पेंडिंग | छोटा-सा नोट और दोबारा पेमेंट करने का तरीक़ा | यूटिलिटी |
| ऑर्डर शिप हुआ | कूरियर और ट्रैकिंग लिंक | यूटिलिटी |
| कैश ऑन डिलीवरी ऑर्डर बना | एक सवाल: ऑर्डर कन्फ़र्म करें, पता बदलें या कैंसल करें | यूटिलिटी |
| अपॉइंटमेंट बुक हुआ, बदला या कल है | तारीख़, समय, जगह और रीशेड्यूल करने का तरीक़ा | यूटिलिटी |
| CRM में डील जीती या हारी | अकाउंट मैनेजर को हैंडओवर, या फ़ीडबैक का सवाल | टेक्स्ट के हिसाब से यूटिलिटी या मार्केटिंग |
| अबैंडन्ड कार्ट | एक रिमाइंडर, शायद किसी ऑफ़र के साथ | मार्केटिंग |
Meta श्रेणी इस आधार पर तय करता है कि टेम्पलेट में क्या लिखा है, न कि आपने कौन-सा लेबल चुना। किसी ख़ास ऑर्डर, पेमेंट या बुकिंग से जुड़ा मैसेज यूटिलिटी है; जो कुछ भी प्रमोट करता है, ऑफ़र देता है या मनाने की कोशिश करता है वह मार्केटिंग है, और उसके लिए ऐसी सहमति (ऑप्ट-इन) चाहिए जिसमें मार्केटिंग शामिल हो। ऊपर के यूटिलिटी केस के लिए शब्दों के नमूने हमारे WhatsApp टेम्पलेट मैसेज के उदाहरण में हैं।
कौन-से WhatsApp नियम लागू होते हैं
ज़्यादातर वेबहुक मैसेज के लिए टेम्पलेट चाहिए
जब ग्राहक आपको मैसेज या कॉल करता है तो कस्टमर सर्विस विंडो खुलती है, और उसके आख़िरी मैसेज से 24 घंटे तक रहती है। इसके अंदर आप खुलकर जवाब दे सकते हैं; इसके बाहर सिर्फ़ पहले से मंज़ूर टेम्पलेट मैसेज भेजे जा सकते हैं। स्टोर और CRM इवेंट शायद ही कभी इस विंडो के अंदर होते हैं, इसलिए हर वेबहुक मैसेज को टेम्पलेट के रूप में प्लान करें, और कुछ भी चालू करने से पहले टेम्पलेट रिव्यू के लिए सबमिट करें।
फ़ोन नंबर काम का होना चाहिए
वेबहुक में ऐसा फ़ोन नंबर होना चाहिए जिस तक WhatsApp पहुँच सके: इंटरनेशनल फ़ॉर्मैट में, कंट्री कोड के साथ। कई स्टोर ग्राहकों को अपनी मर्ज़ी से नंबर लिखने देते हैं, इसलिए कुछ असली ऑर्डर जाँच लें। बिना कंट्री कोड वाला नंबर सबसे आम वजह है कि टेस्ट में सब चलता है और लाइव में नहीं।
1 अक्टूबर 2026 को प्राइसिंग बदली
Meta 1 जुलाई 2025 से हर डिलीवर हुए मैसेज पर चार्ज करता है। 1 अक्टूबर 2026 से खुली कस्टमर सर्विस विंडो के अंदर भेजे गए यूटिलिटी टेम्पलेट पर, कुछ समय मुफ़्त रहने के बाद, फिर से चार्ज लगता है, और हर बिज़नेस फ़ोन नंबर को हर महीने 1,000 मुफ़्त सर्विस मैसेज मिलते हैं। दरें श्रेणी और ग्राहक के देश पर निर्भर करती हैं। असल में, ऑर्डर कन्फ़र्मेशन का ख़र्च आता है, चाहे ग्राहक ने हाल में आपको लिखा हो या नहीं, इसलिए वही मैसेज भेजें जो मायने रखते हैं और बाकी छोड़ दें। रेट कार्ड को WhatsApp API प्राइसिंग गाइड में समझाया गया है।
वेबहुक URL को सुरक्षित करें
जिसे भी वेबहुक URL पता है, वह उसे कॉल कर सकता है। अगर वह URL WhatsApp मैसेज भेजता है, तो URL लीक होने का मतलब है कि कोई और आपके नाम से आपके ग्राहकों को मैसेज भेज सकता है, या आपका बिल बढ़ा सकता है। तीन आदतें इसे रोकती हैं:
- सीक्रेट ज़रूरी करें। भेजने वाला सिस्टम सीक्रेट को एक हेडर में जोड़ता है, या उससे रिक्वेस्ट बॉडी को साइन करता है (HMAC-SHA256), ताकि रिसीवर जाँच सके कि रास्ते में रिक्वेस्ट बदली नहीं गई। सही सीक्रेट या सिग्नेचर के बिना आई रिक्वेस्ट रिजेक्ट हो जाती हैं।
- हर काम के लिए एक URL। ऑर्डर फ़्लो और बुकिंग फ़्लो के URL और सीक्रेट अलग होने चाहिए, ताकि आप एक को बदल सकें और दूसरे को छूना न पड़े।
- भेजने वाली तरफ़ की विफलताओं पर नज़र रखें। लगातार पाँच से ज़्यादा डिलीवरी फ़ेल होने पर WooCommerce वेबहुक को बंद कर देता है, और Shopify उस वेबहुक सब्सक्रिप्शन को हटा देता है जिसका डेस्टिनेशन बार-बार 200 के अलावा कोई और रिस्पॉन्स देता है। बंद या ग़लत कॉन्फ़िगर किया गया रिसीवर चुपचाप आपके नोटिफ़िकेशन रोक सकता है।
Shopify और WooCommerce में वेबहुक कहाँ बनाएँ
- Shopify: Settings › Notifications › Webhooks, फिर Create webhook। एक इवेंट चुनें (Order creation, Order payment, Fulfillment creation और कई दूसरे), फ़ॉर्मैट में JSON और एक
https://URL। वेबहुक बनने के बाद इवेंट बदला नहीं जा सकता, इसलिए हर इवेंट के लिए एक वेबहुक बनाएँ। Send test से जाँचें कि वह URL तक पहुँचता है। - WooCommerce: WooCommerce › Settings › Advanced › Webhooks, फिर Add webhook। एक टॉपिक चुनें (ऑर्डर, कस्टमर, कूपन या प्रोडक्ट इवेंट), डिलीवरी URL और एक सीक्रेट डालें; WooCommerce उस सीक्रेट से बना पेलोड का हैश रिक्वेस्ट हेडर में जोड़ता है।
- कोई CRM या बुकिंग टूल: “webhooks”, “automations” या “outgoing integrations” खोजें। अगर वह सिर्फ़ एक तय फ़ॉर्मैट देता है, तो कुछ भी बनाने से पहले देख लें कि ग्राहक का फ़ोन नंबर किस फ़ील्ड में है।
लाइव करने से पहले असली रिक्वेस्ट से टेस्ट करें
वेबहुक पेलोड लंबे होते हैं और हर प्लैटफ़ॉर्म अपने फ़ील्ड का नाम अलग रखता है: फ़ोन नंबर phone, billing.phone या customer.default_address.phone हो सकता है। अंदाज़ा न लगाएँ। एक असली टेस्ट रिक्वेस्ट भेजें, देखें क्या आया, और उसी से फ़ील्ड मैप करें। फिर एज केस टेस्ट करें:
- बिना फ़ोन नंबर वाला ऑर्डर, या बिना कंट्री कोड वाले नंबर का ऑर्डर;
- एक ही इवेंट का दो बार डिलीवर होना, जो प्लैटफ़ॉर्म रीट्राई करते समय करते हैं;
- रात 3 बजे दिया गया ऑर्डर, अगर आप चाहते हैं कि मैसेज सुबह तक रुके;
- नोटिफ़िकेशन का जवाब देने वाला ग्राहक, ताकि कोई इंसान या AI असिस्टेंट जवाब देने के लिए तैयार हो।
MonoChat में यह कैसे करें
MonoChat एक आधिकारिक Meta Business Partner है। वर्ज़न 3.8.37 (अक्टूबर 2026) से एक फ़्लो वेबहुक से शुरू हो सकता है, इसलिए आपका स्टोर या CRM आपकी तरफ़ से बिना किसी कोड के WhatsApp मैसेज ट्रिगर कर सकता है।
1. फ़्लो को वेबहुक प्राप्त हुआ नोड से शुरू करें। इसे इवेंट नोड में से जोड़ें। इसे अपना ख़ुद का वेबहुक URL और सीक्रेट मिलता है। चैनल चुनें, जैसे आपका WhatsApp नंबर, और पहचान का पाथ, यानी रिक्वेस्ट में ग्राहक का फ़ोन नंबर कहाँ है (डिफ़ॉल्ट रूप से request.body.phone)। MonoChat उस चैनल पर ग्राहक को ढूँढता है, या नया बनाता है, और उसके लिए फ़्लो चलाता है। फ़्लो क्यू में जाते ही नोड भेजने वाले को 202 से जवाब देता है, और चैनल या फ़ोन नंबर न मिलने पर एक साफ़ एरर देता है।
2. सीक्रेट ज़रूरी करें चालू करें। भेजने वाला सीक्रेट को टोकन हेडर में रख सकता है (डिफ़ॉल्ट Authorization, अकेले या Bearer <secret> के रूप में), या रॉ बॉडी का HMAC-SHA256 सिग्नेचर सिग्नेचर हेडर में भेज सकता है (डिफ़ॉल्ट X-Signature)। दोनों हेडर के नाम भेजने वाले सिस्टम के हिसाब से बदले जा सकते हैं।
3. एक असली रिक्वेस्ट कैप्चर करें। वेबहुक URL के आख़िर में /test जोड़ें और अपने स्टोर का टेस्ट वेबहुक उस पर पॉइंट करें। जब तक नोड की सेटिंग्स खुली हैं, रिक्वेस्ट अपनी बॉडी, क्वेरी और हेडर के साथ प्राप्त अनुरोध के नीचे दिखती है, फ़्लो शुरू किए बिना। इससे ज़रूरी पाथ ढूँढें, फिर उन्हें फ़्लो वेरिएबल के रूप में सेव करें, जैसे request.body.orderId को orderId नाम से।
4. मैसेज भेजें। अपने मंज़ूर किए गए टेम्पलेट के साथ एक टेम्पलेट संदेश भेजें नोड जोड़ें, और उसके वेरिएबल फ़्लो वेरिएबल से भरें: ऑर्डर नंबर, रक़म, ट्रैकिंग लिंक। अलग-अलग स्टेटस के लिए अलग टेम्पलेट भेजने के लिए कंडीशन इस्तेमाल करें।
5. ज़रूरत हो तो वापस जानकारी भेजें। एक HTTP अनुरोध नोड आपके अपने सिस्टम से और डेटा ला सकता है, या ग्राहक का जवाब वहाँ लिख सकता है, जैसे कैश ऑन डिलीवरी ऑर्डर पर “कन्फ़र्म्ड”। कॉल सफल होने पर यह आउटपुट से आगे बढ़ता है और सफल न होने पर विफल होने पर से, ताकि आप एक वैकल्पिक मैसेज भेज सकें या बातचीत किसी इंसान को असाइन कर सकें।
जब ग्राहक जवाब देता है, तो बातचीत आपके बाकी WhatsApp, Instagram और Messenger चैट के साथ उसी MonoChat टीम इनबॉक्स में आती है, जहाँ आपकी टीम या कोई AI असिस्टेंट उसे संभाल सकता है। फ़्लो बनाने के लिए वर्कफ़्लो ऑटोमेशन देखें।
काम कौन करेगा, इसके हिसाब से दो और रास्ते:
- आपके डेवलपर पहले से API कॉल करते हैं। WhatsApp Template API ऐप एक ही API कॉल में मंज़ूर टेम्पलेट भेजता है, और जवाब इनबॉक्स में आते हैं।
- आप Shopify चलाते हैं और चैट में ऑर्डर का डेटा चाहते हैं। Shopify चैट ऑटोमेशन प्रोडक्ट और ऑर्डर सिंक करता है, ताकि टीम और AI असिस्टेंट ऑर्डर से जुड़े सवालों का जवाब दे सकें।
शुरू करने के लिए app.monochat.ai पर मुफ़्त अकाउंट बनाएँ, अपना WhatsApp नंबर कनेक्ट करें और प्राइसिंग पेज पर प्लान की तुलना करें।
स्रोत
इसे MonoChat के साथ अमल में लाएँ