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

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

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

कोड उदाहरण

{
  "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 को चैनल की मीडिया मेथड में पास करें। हब का इनबाउंड मीडिया फ़ेच करना वह कॉल हर भाषा में देता है, साथ ही रीडायरेक्ट और हेडर नियम जिनका वह पालन करता है।

वीडियो सबसे बड़ी चीज़ है जो कोई संपर्क आपको भेज सकता है, और फ़ेच बाइट्स को API के बजाय सीधे स्टोरेज से सर्व करता है, इसलिए रिस्पॉन्स को बफ़र करने के बजाय डिस्क या अपने बकेट में स्ट्रीम करें। मैसेज और उसका मीडिया एक साथ एक्सपायर होते हैं, मैसेज आने के 30 दिन बाद; हब का इनबाउंड मीडिया फ़ेच करना उस विंडो का मालिक है और बताता है कि विंडो बीतने के बाद रीड्स क्या लौटाते हैं।

वेबहुक पेलोड

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

कोड उदाहरण

{
  "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 सेट करता है।
एक मैसेज में एक क्लिप। कई वीडियो कई इनबाउंड मैसेज के रूप में आते हैं, हर एक का अपना मीडिया रेफ़रेंस होता है।

अगले कदम

प्राप्त करना कैसे काम करता है: इनबाउंड एन्वेलप, मीडिया फ़ेचिंग, और whatsapp.received वेबहुक
WhatsApp वीडियो मैसेज: इसी आर्म का सेंड साइड
ऑडियो प्राप्त करना: वॉइस नोट्स और अटैच की गई ऑडियो फ़ाइलें
WhatsApp इवेंट्स: पूरी इवेंट सूची, API या वेबहुक के ज़रिए