WhatsApp interactive message कैसे भेजें: Cloud API पर बटन, लिस्ट, CTA लिंक और लोकेशन रिक्वेस्ट (JSON के साथ)

अगर आप सोच रहे हैं कि whatsapp interactive message kaise bheje, तो छोटा जवाब यह है: Cloud API के messages endpoint पर "type": "interactive" वाला एक JSON भेजिए। सबसे ज़्यादा काम आने वाले चार टाइप हैं: reply बटन, लिस्ट मैसेज, CTA URL बटन और लोकेशन रिक्वेस्ट। ग्राहक को टाइप नहीं करना पड़ता, बस टैप करना होता है, और आपके सिस्टम को एक साफ़ id मिलता है। इस गाइड में Meta के डॉक्यूमेंटेशन से हर टाइप की सही लिमिट, पूरा JSON, webhook में आने वाला जवाब और वह नियम है जिस पर ज़्यादातर टीमें अटकती हैं: interactive मैसेज सिर्फ़ 24 घंटे की कस्टमर सर्विस विंडो के अंदर जाते हैं।

यह गाइड उन डेवलपर्स के लिए है जो सीधे Cloud API से या उसी API वाले किसी प्लेटफ़ॉर्म से जुड़ रहे हैं। बिना कोड के यही काम करना हो तो आख़िरी सेक्शन देखें। अंग्रेज़ी में यही गाइड WhatsApp interactive messages guide पर है।

शुरू करने से पहले: endpoint और 24 घंटे का नियम

नीचे का हर उदाहरण आपके बिज़नेस फ़ोन नंबर के messages endpoint पर एक POST है:

curl -X POST "https://graph.facebook.com/<API_VERSION>/<PHONE_NUMBER_ID>/messages" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d @payload.json

Interactive मैसेज service मैसेज हैं, यानी free-form मैसेज जिनके लिए template approval नहीं चाहिए। Meta service मैसेज तभी भेजने देता है जब 24 घंटे की कस्टमर सर्विस विंडो खुली हो। यह विंडो तब खुलती है जब ग्राहक आपको मैसेज (या कॉल) करता है, और उसके आख़िरी मैसेज से 24 घंटे तक रहती है। विंडो बंद होने के बाद सिर्फ़ approved मैसेज template भेजे जा सकते हैं। Error 131047 का मतलब है कि आपने विंडो के बाहर free-form मैसेज भेजने की कोशिश की।

ख़र्च: विंडो के अंदर भेजा गया interactive जवाब service मैसेज है, template नहीं। 1 अक्टूबर 2026 से Meta हर बिज़नेस फ़ोन नंबर को महीने में 1,000 service मैसेज मुफ़्त देता है, उसके बाद चार्ज लगता है। मौजूदा रेट WhatsApp API pricing पेज पर देखें।

टेस्ट के लिए पहले अपने फ़ोन से बिज़नेस नंबर पर "hi" भेजें। इससे आपके टेस्ट नंबर के लिए विंडो खुल जाती है।

सारी लिमिट एक नज़र में

एक मैसेज में हर बटन का टाइटल अलग होना चाहिए। बटन टाइटल में formatting नहीं चलती, पर emoji चल जाते हैं। लिमिट कैरेक्टर में है, इसलिए हिंदी टाइटल भी 20 कैरेक्टर के अंदर रखें और भेजने से पहले अपने फ़ोन पर टेस्ट करें।

स्टेप 1: reply बटन भेजें

दो या तीन जल्दी वाले विकल्पों के लिए reply बटन सबसे अच्छे हैं। जयपुर का Sunrise Clinic अपॉइंटमेंट रिमाइंडर पर मरीज़ का जवाब आने के बाद ऐसे पूछता है:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "919876543210",
  "type": "interactive",
  "interactive": {
    "type": "button",
    "header": {
      "type": "text",
      "text": "कल की अपॉइंटमेंट"
    },
    "body": {
      "text": "नमस्ते मीरा जी, Dr Rao के साथ आपका चेक-अप कल सुबह 10:30 बजे है। क्या आप आ रही हैं?"
    },
    "footer": {
      "text": "Sunrise Clinic, Jaipur"
    },
    "action": {
      "buttons": [
        {
          "type": "reply",
          "reply": {
            "id": "appt_confirm_8841",
            "title": "Confirm visit"
          }
        },
        {
          "type": "reply",
          "reply": {
            "id": "appt_reschedule_8841",
            "title": "Reschedule"
          }
        },
        {
          "type": "reply",
          "reply": {
            "id": "appt_cancel_8841",
            "title": "Cancel"
          }
        }
      ]
    }
  }
}

id में वह सब है जो आपके कोड को चाहिए (क्या करना है और बुकिंग नंबर), इसलिए जवाब संभालने वाले कोड को टाइटल से कुछ ढूँढना नहीं पड़ता। हर टाइटल 20 कैरेक्टर से छोटा है: "Reschedule my appointment" रिजेक्ट होगा, "Reschedule" चल जाएगा।

टेक्स्ट header की जगह इमेज चाहिए तो "header": { "type": "image", "image": { "link": "https://…" } } लिखें या upload किए media का id दें। वीडियो और डॉक्यूमेंट header भी इसी तरह लगते हैं।

स्टेप 2: लिस्ट मैसेज भेजें

चार से दस बराबर विकल्पों के लिए लिस्ट इस्तेमाल करें: प्रोडक्ट कैटेगरी, डिपार्टमेंट, ब्रांच, FAQ के विषय। होम डेकोर ब्रांड Rangoli Home, ग्राहक के "catalogue" लिखने पर यह भेजता है:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "919876543210",
  "type": "interactive",
  "interactive": {
    "type": "list",
    "header": {
      "type": "text",
      "text": "Rangoli Home"
    },
    "body": {
      "text": "आज आप क्या देखना चाहेंगी, प्रिया जी? नीचे बटन दबाकर कैटेगरी चुनें।"
    },
    "footer": {
      "text": "सोम-शनि, सुबह 10 से शाम 7"
    },
    "action": {
      "button": "See categories",
      "sections": [
        {
          "title": "Living room",
          "rows": [
            {
              "id": "cat_cushions",
              "title": "Cushion covers",
              "description": "Block-printed cotton, from ₹349"
            },
            {
              "id": "cat_throws",
              "title": "Throws and rugs",
              "description": "Handloom, 3 sizes"
            }
          ]
        },
        {
          "title": "Dining",
          "rows": [
            {
              "id": "cat_runners",
              "title": "Table runners"
            },
            {
              "id": "cat_napkins",
              "title": "Napkin sets"
            }
          ]
        },
        {
          "title": "Help",
          "rows": [
            {
              "id": "help_order",
              "title": "Track my order"
            },
            {
              "id": "help_agent",
              "title": "Talk to the team"
            }
          ]
        }
      ]
    }
  }
}

इस लिस्ट में 3 सेक्शन में 6 पंक्तियाँ हैं। याद रखें कि 10 की लिमिट कुल पंक्तियों की है, हर सेक्शन की नहीं: तीन-तीन पंक्तियों वाले दस सेक्शन फ़ेल होंगे। button लेबल ("See categories") वह है जिसे ग्राहक लिस्ट खोलने के लिए टैप करता है, और यह 20 कैरेक्टर तक हो सकता है। पंक्ति का विवरण वैकल्पिक है; ऊपर की तरह इसमें दाम या समय लिखें।

स्टेप 3: CTA URL बटन भेजें

Reply बटन कोई वेबसाइट नहीं खोल सकता। जब ग्राहक को किसी लिंक पर भेजना हो, जैसे ट्रैकिंग पेज, पेमेंट पेज या बुकिंग कैलेंडर, तब CTA URL मैसेज भेजें:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "919876543210",
  "type": "interactive",
  "interactive": {
    "type": "cta_url",
    "header": {
      "type": "text",
      "text": "ऑर्डर #RH-20417"
    },
    "body": {
      "text": "आपका ऑर्डर कूरियर को दे दिया गया है। लाइव स्टेटस देखने के लिए नीचे टैप करें।"
    },
    "footer": {
      "text": "Rangoli Home"
    },
    "action": {
      "name": "cta_url",
      "parameters": {
        "display_text": "Track order",
        "url": "https://rangolihome.in/track?o=RH-20417"
      }
    }
  }
}

ग्राहक को लंबे URL की जगह Track order नाम का एक साफ़ बटन दिखता है। Attribution के लिए tracking parameters URL में रख सकते हैं; बटन का टेक्स्ट फिर भी साफ़ रहता है।

स्टेप 4: ग्राहक की लोकेशन माँगें

लोकेशन रिक्वेस्ट में body टेक्स्ट और एक Send location बटन दिखता है। टैप करने पर WhatsApp की लोकेशन शेयर करने वाली स्क्रीन खुलती है। घर से सैंपल लेने वाली कोई डायग्नॉस्टिक लैब यह भेज सकती है:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "919876543210",
  "type": "interactive",
  "interactive": {
    "type": "location_request_message",
    "body": {
      "text": "घर से सैंपल लेने के लिए कृपया अपनी लोकेशन भेजें, ताकि हमारा फ़्लेबोटॉमिस्ट सही पते पर पहुँचे।"
    },
    "action": {
      "name": "send_location"
    }
  }
}

जवाब एक साधारण location मैसेज के रूप में latitude और longitude के साथ आता है। name और address तभी आते हैं जब ग्राहक इन्हें शेयर करे, इसलिए अपने कोड में इन्हें ज़रूरी न मानें।

स्टेप 5: webhook में जवाब पढ़ें

हर टैप आपके webhook पर messages change के रूप में आता है। Reply बटन टैप होने पर पूरा payload ऐसा दिखता है:

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "field": "messages",
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "911412345678",
              "phone_number_id": "<PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "Meera"
                },
                "wa_id": "919876543210"
              }
            ],
            "messages": [
              {
                "from": "919876543210",
                "id": "wamid.HBgM...",
                "timestamp": "1793424000",
                "context": {
                  "from": "911412345678",
                  "id": "wamid.HBgL..."
                },
                "type": "interactive",
                "interactive": {
                  "type": "button_reply",
                  "button_reply": {
                    "id": "appt_reschedule_8841",
                    "title": "Reschedule"
                  }
                }
              }
            ]
          }
        }
      ]
    }
  ]
}

context.id उस मैसेज का id है जिसका ग्राहक ने जवाब दिया, इसलिए आप टैप को अपने भेजे सही मैसेज से मिला सकते हैं। बाक़ी टाइप में सिर्फ़ messages[0] के अंदर का हिस्सा बदलता है:

लिस्ट से चुनाव

{
  "type": "interactive",
  "interactive": {
    "type": "list_reply",
    "list_reply": {
      "id": "cat_cushions",
      "title": "Cushion covers",
      "description": "Block-printed cotton, from ₹349"
    }
  }
}

शेयर की गई लोकेशन

{
  "type": "location",
  "location": {
    "latitude": 26.9124,
    "longitude": 75.7873,
    "name": "Optional, only if the user shares it",
    "address": "Optional, only if the user shares it"
  }
}

Template का quick-reply बटन

{
  "type": "button",
  "context": {
    "from": "911412345678",
    "id": "wamid.HBgL..."
  },
  "button": {
    "payload": "Stop offers",
    "text": "Stop offers"
  }
}

फ़र्क़ पर ध्यान दें: interactive जवाब type: "interactive" के साथ button_reply या list_reply में आते हैं, जबकि template के quick-reply बटन का टैप type: "button" के साथ button.payload और button.text में आता है। दोनों संभालें, क्योंकि असली बातचीत अक्सर template से शुरू होती है और interactive मैसेज से आगे बढ़ती है। Node.js में एक छोटा handler:

// webhook से ग्राहक की पसंद निकालना (Cloud API "messages" webhook का value ऑब्जेक्ट)
export function readChoice(value) {
  const msg = value.messages?.[0];
  if (!msg) return null; // यह status update है, मैसेज नहीं
  switch (msg.type) {
    case 'interactive': {
      const it = msg.interactive;
      if (it.type === 'button_reply') return { kind: 'button', id: it.button_reply.id };
      if (it.type === 'list_reply') return { kind: 'list', id: it.list_reply.id };
      return { kind: it.type, raw: it }; // बाकी interactive रिप्लाई, जैसे Flow
    }
    case 'button': // template का quick-reply बटन
      return { kind: 'template_button', payload: msg.button.payload, text: msg.button.text, repliedTo: msg.context?.id };
    case 'location':
      return { kind: 'location', lat: msg.location.latitude, lng: msg.location.longitude };
    default:
      return { kind: msg.type, text: msg.text?.body };
  }
}

दो आदतें डिबगिंग का समय बचाती हैं। Webhook को तुरंत HTTP 200 लौटाएँ और मैसेज को बैकग्राउंड job में प्रोसेस करें, क्योंकि फ़ेल हुए webhook Meta दोबारा भेजता है। और आने वाले मैसेज के id पर de-duplicate करें, क्योंकि retry में एक ही टैप दो बार आ सकता है।

विंडो के बाहर: बटन वाले template

Broadcast, रिमाइंडर और ग्राहक के आख़िरी मैसेज के 24 घंटे बाद भेजी जाने वाली हर चीज़ template होनी चाहिए। Template के अपने बटन होते हैं, जो template के साथ approve होते हैं:

Quick-reply बटन एक साथ ग्रुप में होने चाहिए, बाक़ी टाइप के बटन से अलग, वरना API template रिजेक्ट कर देता है। Meta यह भी बताता है कि चार या ज़्यादा बटन वाले, या quick reply के साथ दूसरे बटन मिलाने वाले template WhatsApp desktop पर नहीं दिखते; ग्राहक से फ़ोन पर मैसेज खोलने को कहा जाता है।

जो तरीका काम करता है: दो-तीन quick reply वाला utility या marketing template बातचीत शुरू करता है। ग्राहक के टैप करते ही विंडो खुल जाती है और आपका bot interactive बटन और लिस्ट से आगे बढ़ता है। Template वाला हिस्सा हमारी API से template मैसेज भेजने की गाइड में है।

Flows और product मैसेज

WhatsApp Flows चैट के अंदर कई स्क्रीन वाले फ़ॉर्म हैं, जो तब काम आते हैं जब एक के बाद एक कई जवाब चाहिए, जैसे नाम, तारीख़ और टाइम स्लॉट। विंडो के अंदर ये flow टाइप के interactive मैसेज की तरह जाते हैं और विंडो के बाहर template से। पहले Flow बनाएँ; Meta डिफ़ॉल्ट रूप से published वर्ज़न भेजता है, और टेस्ट करते समय draft mode में draft भी भेजा जा सकता है। ज़्यादा जानकारी अंग्रेज़ी glossary में WhatsApp Flows पर है।

Product मैसेज आपके WhatsApp अकाउंट से जुड़े catalog के आइटम दिखाते हैं: एक आइटम के लिए product, और कई आइटम के लिए product_list, जिसमें 10 सेक्शन में 30 प्रोडक्ट तक आ सकते हैं। हर प्रोडक्ट catalog_id के साथ उसके product_retailer_id से पहचाना जाता है। आज़माने से पहले catalog को WhatsApp अकाउंट से जोड़ लें।

आम errors और उनका हल

बाक़ी error codes के लिए हमारी WhatsApp API error codes सूची देखें।

Broadchat में बिना कोड

Broadchat के visual chatbot builder (Chatbots → Chatbots) में Ask Question स्टेप का Interactive मैसेज टाइप है, जहाँ आप बटन या लिस्ट चुनते हैं, लिस्ट बटन का नाम रखते हैं, सेक्शन और पंक्तियाँ जोड़ते हैं, और हर विकल्प को अपनी ब्रांच से जोड़ते हैं। इसी स्टेप में Location Request भी है, और लिंक बटन के लिए Send Message स्टेप में Cta url है। Template के quick-reply बटन से भी flow ब्रांच हो सकता है। Chatbot बनाने का help लेख, बिना कोड chatbot बनाने की हिंदी गाइड और WhatsApp chatbot builder देखें।

डेवलपर इस गाइड के JSON वैसे ही भेज सकते हैं: हर चैनल का एक access token और पैनल पर Graph-compatible API पता होता है, जो उस चैनल के नंबर के लिए Cloud API जैसी ही /messages रिक्वेस्ट लेता है। Interactive मैसेज पूरे प्लेटफ़ॉर्म में कहाँ फ़िट होते हैं, यह समझने के लिए WhatsApp Business API क्या है से शुरू करें।