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

किसी कॉन्टैक्ट द्वारा शेयर किया गया पिन location के साथ इनबाउंड मैसेज के रूप में आता है। यही arm आपके भेजे गए लोकेशन रिक्वेस्ट का जवाब भी देता है, जो एकमात्र इंटरैक्टिव टाइप है जिसका रिप्लाई 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 उस मैसेज को नाम देता है जिसमें बटन था। यही किसी जवाब को सवाल से जोड़ता है, और यही कॉन्टैक्ट इन्फ़ो रिक्वेस्ट से अंतर है, जिसके रिप्लाई में ऐसा कोई लिंक नहीं होता।

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

वेबहुक पेलोड

whatsapp.received इवेंट एनवेलप पर location arm रखता है:

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

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

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

अगले कदम

• रिसीविंग कैसे काम करती है: इनबाउंड एनवेलप, मीडिया फ़ेचिंग, और whatsapp.received वेबहुक
• WhatsApp लोकेशन मैसेज: इसी arm का सेंड साइड
• WhatsApp लोकेशन रिक्वेस्ट: पिन माँगने वाला बटन
• WhatsApp webhooks: हर वह इवेंट जिसे आप सब्सक्राइब कर सकते हैं