Sign inGet Started
शुरू करें
गाइड
API Reference
SDKs
CLI
Knowledge Base
Changelog

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फ़ील्डइसमें क्या होता है
buttonbuttonजवाब बटन का, या टेम्पलेट के क्विक-रिप्लाई बटन का slug और text
listlistसंपर्क ने जो पंक्ति चुनी, उसका 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 के जवाब देते हैं:

लिंक बटन कुछ भी वापस नहीं भेजता: संपर्क 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" }
    }
  }
}

ध्यान देने योग्य बातें

  • interactive और interactive_reply विपरीत दिशाओं के हैं। interactive वह है जो आपने भेजा, और यह कभी इनबाउंड नहीं आता; interactive_reply वह है जिस पर संपर्क ने टैप किया, और यह कभी आउटबाउंड संदेश पर नहीं दिखता।
  • टैप से सर्विस विंडो रीसेट हो जाती है। टैप एक इनबाउंड संदेश है, इसलिए यह टेक्स्ट संदेश की तरह ही मुक्त-रूप जवाबों के 24 घंटे फिर से खोल देता है।
  • संपर्क एक ही बटन पर दो बार टैप कर सकता है। टैप की डुप्लिकेट हटाई नहीं जाती, इसलिए हर टैप अपनी ID वाला अलग संदेश होता है। slug पर आप जो कार्रवाई करते हैं, उसे आइडेम्पोटेंट बनाएँ, ताकि उसे दोबारा करने पर परिणाम न बदले।
  • पुराने मेनू पर किया गया टैप भी पहुँचता है। पीछे स्क्रॉल करने वाला संपर्क कई दिन पुराने बटन पर टैप कर सकता है, इसलिए यह मानकर न चलें कि टैप आपके नवीनतम संदेश का जवाब है, बल्कि जाँचें कि फ़्लो अब भी खुला है।

अगले कदम

संबंधित संसाधन

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।

अभ्यास करें और इम्प्लीमेंटेशन ब्रीफ़ पाएँ