Sign inGet Started
शुरू करें
गाइड
API Reference
SDKs
CLI
Knowledge Base
Changelog

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"
    }
  }
}

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

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

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

अगले कदम

संबंधित संसाधन

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।

अभ्यास करें और इम्प्लीमेंटेशन ब्रीफ़ पाएँ