WhatsApp इंटरैक्टिव रिप्लाई प्राप्त करना
रिप्लाई बटन, लिस्ट रो, या टेम्पलेट के क्विक-रिप्लाई बटन पर टैप एक अलग इनबाउंड मैसेज के रूप में आता है जिसमें interactive_reply होता है। यह आर्म आपको वही हैंडल लौटाती है जो आपने भेजते समय सेट किया था, इसलिए फ़्लो कॉन्टैक्ट को दिखे लेबल की बजाय आपके अपने आइडेंटिफ़ायर पर ब्रांच करता है।
इनबाउंड इंटरैक्टिव रिप्लाई में क्या होता है
type टैप का प्रकार बताता है, और उसी नाम का फ़ील्ड उसे ले कर आता है:
कोड उदाहरण
{
"id": "wam_01kyb2m4xq7whs0d8n3prv6tez",
"direction": "inbound",
"from": { "phone_number": "+14155550100" },
"to": { "phone_number": "+13124495569" },
"status": "received",
"in_reply_to_message_id": "wam_01kya19eknftrs2s6p82asmvnh",
"interactive_reply": {
"type": "button",
"button": { "slug": "cancel-booking", "text": "Cancel" }
},
"created_at": "2026-08-25T09:04:11Z"
}| type | फ़ील्ड | यह क्या ले कर आता है |
|---|---|---|
| button | button | रिप्लाई बटन या टेम्पलेट के क्विक-रिप्लाई बटन का slug और text |
| list | list | कॉन्टैक्ट द्वारा चुनी गई रो का slug और text, साथ ही उसका description जब वह मौजूद हो |
लिस्ट रो button को list से बदल देती है और रो में दिखी दूसरी लाइन जोड़ती है:
कोड उदाहरण
{
"interactive_reply": {
"type": "list",
"list": {
"slug": "priority_express",
"text": "Priority Mail Express",
"description": "Next day to 2 days"
}
}
}slug वह हैंडल है जो आपने घोषित किया और कॉन्टैक्ट ने कभी नहीं देखा; text वह लेबल है जो उन्होंने पढ़ा। slug पर ब्रांच करें। लेबल को दोबारा लिखा और अनुवादित किया जा सकता है, और टेम्पलेट के क्विक-रिप्लाई बटन पर टैप करने पर slug वह पेलोड होता है जो उस टेम्पलेट ने घोषित किया था, जिसे WhatsApp बटन के अपने लेबल पर सेट करता है।
काइंड लिस्ट खुली है: WhatsApp समय-समय पर नए इंटरैक्टिव काइंड जोड़ता है, इसलिए जो type आप नहीं पहचानते उसे त्रुटि मानने की बजाय भविष्य का काइंड मानें, और रीड फ़ेल करने की बजाय मैसेज को लॉग करें।
टैप को आपके भेजे मैसेज से जोड़ना
in_reply_to_message_id उस मैसेज को इंगित करता है जिसमें बटन या मेन्यू था, इसी से आपको पता चलता है कि यह उत्तर किस प्रश्न का है। WhatsApp हर टैप पर इसे रिपोर्ट नहीं करता, और रिज़ॉल्यूशन भी चूक सकता है; उस स्थिति में फ़ील्ड खाली रिपोर्ट होने की बजाय छोड़ दिया जाता है। हब की कोटेड रिप्लाइज़ बताती है कि चूक का क्या मतलब है और कोटेड मैसेज कितने समय तक रिज़ॉल्व हो सकता है।
जहाँ सहसंबंध विश्वसनीय होना ज़रूरी है, वहाँ अपना रेफ़रेंस slug में या भेजते समय metadata में डालें, फ़ील्ड पर निर्भर न रहें। भेजने की तरफ़ के लिए मैसेज कोट करना देखें।
वे दो टैप जो कहीं और पहुँचते हैं
दो इंटरैक्टिव प्रकार बिना interactive_reply के उत्तर देते हैं:
- लोकेशन रिक्वेस्ट एक सामान्य इनबाउंड लोकेशन के रूप में वापस आती है।
- कॉन्टैक्ट इन्फ़ो रिक्वेस्ट कॉन्टैक्ट कार्ड्स के रूप में वापस आती है, जिसमें origin को contact_request पर सेट किया गया होता है।
लिंक बटन कुछ वापस नहीं भेजता: कॉन्टैक्ट URL पर चला जाता है, और कोई इनबाउंड मैसेज टैप रिकॉर्ड नहीं करता। केवल interactive_reply देखने वाला इंटिग्रेशन तीनों से चूक जाता है।
वेबहुक पेलोड
whatsapp.received इवेंट एन्वेलप पर interactive_reply आर्म ले कर आता है, ताकि बॉट मैसेज को वापस पढ़े बिना टैप का उत्तर दे सके:
कोड उदाहरण
{
"type": "whatsapp.received",
"timestamp": "2026-08-25T09:04:11.118Z",
"data": {
"whatsapp_id": "wam_01kyb2m4xq7whs0d8n3prv6tez",
"workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
"direction": "inbound",
"from": { "phone_number": "+14155550100", "display_name": "Alex Rivera" },
"to": { "phone_number": "+13124495569" },
"in_reply_to_message_id": "wam_01kya19eknftrs2s6p82asmvnh",
"interactive_reply": {
"type": "button",
"button": { "slug": "cancel-booking", "text": "Cancel" }
},
"tags": null,
"metadata": null
}
}ध्यान देने योग्य बातें
- interactive और interactive_reply विपरीत दिशाएँ हैं। interactive वह है जो आपने भेजा और कभी इनबाउंड नहीं आता; interactive_reply वह है जो कॉन्टैक्ट ने टैप किया और कभी आउटबाउंड मैसेज पर नहीं दिखता।
- टैप सर्विस विंडो रीसेट करता है। यह एक इनबाउंड मैसेज है, इसलिए यह टेक्स्ट की तरह ही 24 घंटे के फ़्री-फ़ॉर्म रिप्लाई फिर से खोल देता है।
- कॉन्टैक्ट एक ही बटन को दो बार टैप कर सकता है। टैप डीडुप्लिकेट नहीं होते, इसलिए हर टैप अपने ID के साथ एक अलग मैसेज है। slug पर जो एक्शन आप लें उसे idempotent बनाएँ।
- पुराने मेन्यू पर टैप अभी भी आता है। पीछे स्क्रॉल करने वाला कॉन्टैक्ट कई दिन पुराने बटन को टैप कर सकता है, इसलिए यह मान लेने की बजाय कि टैप आपके नवीनतम मैसेज का उत्तर है, सत्यापित करें कि फ़्लो अभी भी खुला है।
अगले कदम
- रिसीविंग कैसे काम करती है: इनबाउंड एन्वेलप, मीडिया फ़ेचिंग, और whatsapp.received वेबहुक
- WhatsApp इंटरैक्टिव मैसेज: छह प्रकार जिन्हें प्राप्तकर्ता टैप कर सकता है
- WhatsApp रिप्लाई बटन: बटन टैप का भेजने वाला पक्ष
- WhatsApp लिस्ट मेन्यू: रो चयन का भेजने वाला पक्ष
संबंधित संसाधन
इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।
गाइड देखेंConnecting WhatsApp to Bird: from buying a number to a live channelकॉन्सेप्ट समझेंWhat is the 24-hour customer service window on WhatsApp?टूल का उपयोग करेंWhatsApp message builderक्षमता जानेंWhatsApp
अभ्यास करें और इम्प्लीमेंटेशन ब्रीफ़ पाएँ