# WhatsApp वीडियो प्राप्त करना

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

## एक इनबाउंड वीडियो क्या लेकर आता है

```json
{
  "id": "wam_01kyc5r9pewu7s3j6m0xyd5qgb",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "video": {
    "id": "waf_01kyc4n5yr8xit1e9o4qsw7ufa",
    "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kyc5r9pewu7s3j6m0xyd5qgb/media/waf_01kyc4n5yr8xit1e9o4qsw7ufa",
    "mime_type": "video/mp4",
    "caption": "The rattle starts around 0:12"
  },
  "created_at": "2026-08-25T09:11:48Z"
}
```

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

यह आर्म कोई अवधि, कोई आयाम और कोई थंबनेल नहीं देता। बाइट्स मिलने के बाद ये फ़ाइल से पढ़ें, या अपनी मीडिया पाइपलाइन से।

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

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

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

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

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

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

```json
{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:11:48.204Z",
  "data": {
    "whatsapp_id": "wam_01kyc5r9pewu7s3j6m0xyd5qgb",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100" },
    "to": { "phone_number": "+13124495569" },
    "video": {
      "id": "waf_01kyc4n5yr8xit1e9o4qsw7ufa",
      "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kyc5r9pewu7s3j6m0xyd5qgb/media/waf_01kyc4n5yr8xit1e9o4qsw7ufa",
      "mime_type": "video/mp4",
      "caption": "The rattle starts around 0:12"
    },
    "tags": null,
    "metadata": null
  }
}
```

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

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

- **वीडियो नोट एक वीडियो के रूप में आता है।** WhatsApp का गोल वीडियो नोट इस आर्म पर बिना किसी अलग फ़्लैग के आता है, ऑडियो के विपरीत जहाँ वॉइस नोट `voice` सेट करता है।
- **एक मैसेज में एक क्लिप।** कई वीडियो कई इनबाउंड मैसेज के रूप में आते हैं, हर एक का अपना मीडिया रेफ़रेंस होता है।

## अगले कदम

- [प्राप्त करना कैसे काम करता है](/docs/guides/whatsapp/receiving-whatsapp): इनबाउंड एन्वेलप, मीडिया फ़ेचिंग, और `whatsapp.received` वेबहुक
- [WhatsApp वीडियो मैसेज](/docs/guides/whatsapp/message-types/video): इसी आर्म का सेंड साइड
- [ऑडियो प्राप्त करना](/docs/guides/whatsapp/receiving-whatsapp/audio): वॉइस नोट्स और अटैच की गई ऑडियो फ़ाइलें
- [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)