# WhatsApp इमेज प्राप्त करना

कोई संपर्क जो फ़ोटो या ग्राफ़िक भेजता है, वह एक इनबाउंड मैसेज के रूप में `image` के साथ आता है: Bird द्वारा आपके लिए संग्रहित फ़ाइल का रेफ़रेंस, साथ ही उन्होंने उसके नीचे जो भी कैप्शन टाइप किया हो।

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

```json
{
  "id": "wam_01kya19eknftrs2s6p82asmvnh",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "image": {
    "id": "waf_01kyb2m4xq7whs0d8n3prv6tez",
    "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kya19eknftrs2s6p82asmvnh/media/waf_01kyb2m4xq7whs0d8n3prv6tez",
    "mime_type": "image/jpeg",
    "caption": "Is this the right part?"
  },
  "created_at": "2026-08-25T09:04:11Z"
}
```

| फ़ील्ड      | इसमें क्या होता है                                                                  |
| ----------- | ----------------------------------------------------------------------------------- |
| `id`        | संग्रहित फ़ाइल, बाइट्स फ़ेच करते समय `media_id` के रूप में पास करें                 |
| `url`       | एक Bird URL, आपकी API key से फ़ेच किया जाता है                                      |
| `mime_type` | फ़ाइल के लिए WhatsApp द्वारा रिपोर्ट किया गया मीडिया टाइप, जैसे `image/jpeg`        |
| `caption`   | संपर्क ने इमेज के नीचे जो टेक्स्ट टाइप किया; जब उन्होंने कुछ नहीं भेजा तो अनुपस्थित |

`id` और `mime_type` केवल इनबाउंड इमेज पर दिखते हैं: Bird दोनों को फ़ाइल फ़ेच करके सीखता है, और आपके भेजे हुए को कभी संग्रहित नहीं करता। आउटबाउंड इमेज आपके दिए गए `url` के साथ वापस पढ़ी जाती है और उसमें कोई `id` नहीं होता।

`mime_type` को गारंटी के बजाय WhatsApp की रिपोर्ट मानें, और `url` में फ़ाइल एक्सटेंशन के बजाय इसी पर ब्रांच करें, क्योंकि उसमें कोई एक्सटेंशन नहीं होता।

## बाइट्स फ़ेच करना

`url` और `id` दोनों एक ही संग्रहित फ़ाइल की ओर इशारा करते हैं: मैसेज ID और मीडिया `id` को चैनल की मीडिया मेथड में पास करें, किसी भी SDK, CLI, या cURL में। हब का [इनबाउंड मीडिया फ़ेच करना](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media) वह कॉल हर भाषा में देता है, साथ ही रीडायरेक्ट और हेडर नियम जो वह फ़ॉलो करता है।

मैसेज और उसका मीडिया एक साथ एक्सपायर होते हैं, मैसेज आने के 30 दिन बाद; हब का [इनबाउंड मीडिया फ़ेच करना](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media) उस विंडो और उसके बीतने के बाद रीड्स क्या लौटाती हैं, इसका मालिक है। जिस इमेज को आपको अधिक समय तक रखना है, उसे मैसेज के पढ़ने योग्य रहते हुए संग्रहित कर लें।

## वेबहुक पेलोड

`whatsapp.received` इवेंट एन्वेलप पर `image` आर्म को ले जाता है, मीडिया रेफ़रेंस सहित:

```json
{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:04:11.118Z",
  "data": {
    "whatsapp_id": "wam_01kya19eknftrs2s6p82asmvnh",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100" },
    "to": { "phone_number": "+13124495569" },
    "image": {
      "id": "waf_01kyb2m4xq7whs0d8n3prv6tez",
      "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kya19eknftrs2s6p82asmvnh/media/waf_01kyb2m4xq7whs0d8n3prv6tez",
      "mime_type": "image/jpeg",
      "caption": "Is this the right part?"
    },
    "tags": null,
    "metadata": null
  }
}
```

वेबहुक मैसेज आने पर फ़ायर होता है, और तभी रिटेंशन विंडो भी शुरू होती है, इसलिए जो एंडपॉइंट फ़ेच को इनलाइन करने के बजाय क्यू करता है, उसके पास पकड़ने के लिए पूरी विंडो होती है।

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

- **कैप्शन संपर्क का है।** यह बिना किसी फ़ॉर्मेटिंग या एंटिटी जानकारी के प्लेन टेक्स्ट के रूप में आता है, इसलिए इसे टेक्स्ट के रूप में रेंडर करें।
- **एक मैसेज में एक इमेज।** कई फ़ोटो भेजने वाला संपर्क कई इनबाउंड मैसेज बनाता है, प्रत्येक का अपना `id` और अपना मीडिया रेफ़रेंस। इन्हें `from` और आगमन समय से ग्रुप करें; कोई ऐरे इन्हें एकत्र नहीं करता।

## अगले कदम

- [प्राप्त करना कैसे काम करता है](/docs/guides/whatsapp/receiving-whatsapp): इनबाउंड एन्वेलप, मीडिया फ़ेचिंग, और `whatsapp.received` वेबहुक
- [WhatsApp इमेज मैसेज](/docs/guides/whatsapp/message-types/images): उसी आर्म का सेंड साइड
- [डॉक्यूमेंट प्राप्त करना](/docs/guides/whatsapp/receiving-whatsapp/documents): वही मीडिया शेप, भेजने वाले के फ़ाइलनाम के साथ
- [WhatsApp इवेंट](/docs/guides/whatsapp/events): पूरी इवेंट सूची, API या वेबहुक पर

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)