WhatsApp लोकेशन प्राप्त करना

कोई संपर्क जो पिन साझा करता है, वह location वाले इनबाउंड संदेश के रूप में आता है। यही आर्म आपके भेजे गए लोकेशन अनुरोध का जवाब भी देता है। यह अकेला इंटरैक्टिव प्रकार है जिसका जवाब interactive_reply पर नहीं, बल्कि यहाँ आता है।

इनबाउंड लोकेशन में क्या होता है

{
  "id": "wam_01kyf8u2shzx0v6m9q3bag8tje",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "in_reply_to_message_id": "wam_01kya19eknftrs2s6p82asmvnh",
  "location": {
    "latitude": 37.7793,
    "longitude": -122.4193,
    "name": "Embarcadero Plaza",
    "address": "1 Market St, San Francisco, CA 94105"
  },
  "created_at": "2026-08-25T09:23:14Z"
}

मानचित्र पर गिराए गए सादे पिन में केवल दो निर्देशांक होते हैं, और कुछ नहीं। इसलिए name, address और url को ऐसी अतिरिक्त जानकारी मानें जिसे मौजूद होने पर आप दिखाते हैं, न कि ऐसे फ़ील्ड जिन पर आपका तर्क निर्भर करे। निर्देशांकों को JSON संख्याओं के रूप में पढ़ें, और दक्षिणी व पश्चिमी गोलार्ध में ऋणात्मक मानों की अपेक्षा करें।

लोकेशन अनुरोध का उत्तर देने वाली लोकेशन

जब पिन आपके भेजे गए लोकेशन अनुरोध का उत्तर होता है, तो WhatsApp उस अनुरोध को उत्तर के लक्ष्य के रूप में बताता है, और in_reply_to_message_id उस संदेश को बताता है जिसमें बटन था। इसी से उत्तर अपने प्रश्न से जुड़ता है, और यही संपर्क जानकारी अनुरोध से अंतर है, जिसके उत्तर में ऐसा कोई लिंक नहीं होता।

पिन को उत्तर के रूप में चिह्नित करने वाला और कुछ नहीं है। जो संपर्क बिना पूछे अपनी लोकेशन साझा करता है, उससे भी वही आर्म आता है, पर उसमें in_reply_to_message_id नहीं होता। इसलिए उत्तर की प्रतीक्षा करने वाला इंटीग्रेशन आर्म के बजाय उस फ़ील्ड की जाँच करता है। उलटी दिशा में यह फ़ील्ड गारंटी नहीं है: WhatsApp हर उत्तर को चिह्नित नहीं करता, और उसका पता लगाना विफल हो सकता है, इसलिए वास्तविक उत्तर भी इसके बिना आ सकता है। हब का उद्धृत उत्तर पेज बताता है कि ऐसा कब होता है, और जहाँ वर्गीकरण सही होना ज़रूरी है वहाँ क्या करें।

वेबहुक पेलोड

whatsapp.received इवेंट एनवेलप पर location आर्म ले जाता है:

{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:23:14.507Z",
  "data": {
    "whatsapp_id": "wam_01kyf8u2shzx0v6m9q3bag8tje",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100" },
    "to": { "phone_number": "+13124495569" },
    "in_reply_to_message_id": "wam_01kya19eknftrs2s6p82asmvnh",
    "location": {
      "latitude": 37.7793,
      "longitude": -122.4193,
      "name": "Embarcadero Plaza",
      "address": "1 Market St, San Francisco, CA 94105"
    }
  }
}

किन बातों का ध्यान रखें

• लाइव लोकेशन शेयरिंग को कंटेंट के रूप में मॉडल नहीं किया गया है। जो आता है वह एक ही समय पर तय की गई एक लोकेशन होती है, इसलिए ट्रैकिंग व्यू के पास अपडेट होने के लिए कुछ नहीं होता। इस फ़ील्ड पर ट्रैकिंग व्यू न बनाएँ।
• केवल interactive_reply पर नज़र रखने वाला इंटीग्रेशन इसे चूक जाता है। लोकेशन अनुरोध का जवाब यहाँ आता है, और संपर्क जानकारी अनुरोध का जवाब contact_cards पर आता है, इसलिए जो हैंडलर केवल टैप पढ़ता है, वह दोनों को छोड़ देता है।
• निर्देशांक वही होते हैं जो संपर्क के डिवाइस ने रिपोर्ट किए। इनमें न सटीकता का दायरा होता है, न ऊँचाई, और अगर संपर्क ने पिन को खींचकर रखा है, तो वह वहीं होता है जहाँ उन्होंने उसे खींचा। जब पता सही होना ज़रूरी हो, तो शब्दों में उसकी पुष्टि करें।

अगले चरण

• प्राप्त करना कैसे काम करता है: इनबाउंड एनवेलप, मीडिया लाना, और whatsapp.received वेबहुक
• WhatsApp लोकेशन संदेश: उसी आर्म का भेजने वाला पक्ष
• WhatsApp लोकेशन अनुरोध: वह बटन जो पिन माँगता है
• WhatsApp वेबहुक: हर वह इवेंट जिसकी आप सदस्यता ले सकते हैं