Sign inGet started

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" }
    },
    "tags": null,
    "metadata": null
  }
}

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

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

अगले कदम