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

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

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

आने वाली इमेज में क्या होता है

कोड उदाहरण
{
  "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 कुंजी से प्राप्त किया जाता है
mime_typeफ़ाइल के लिए WhatsApp द्वारा बताया गया मीडिया प्रकार, जैसे image/jpeg
captionवह टेक्स्ट जो संपर्क ने इमेज के नीचे लिखा; कुछ न भेजने पर यह मौजूद नहीं होता

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

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

बाइट प्राप्त करना

url और id दोनों एक ही संग्रहीत फ़ाइल की ओर इशारा करते हैं: संदेश ID और मीडिया id को चैनल की मीडिया मेथड में पास करें, किसी भी SDK, CLI या cURL से। हब का आने वाला मीडिया प्राप्त करना पेज यह कॉल हर भाषा में दिखाता है, साथ ही वे रीडायरेक्ट और हेडर नियम भी जिनका यह पालन करता है।

संदेश और उसका मीडिया एक साथ समाप्त होते हैं, संदेश आने के 30 दिन बाद। यह अवधि और उसके बीतने के बाद रीड क्या लौटाते हैं, इसका विवरण हब के आने वाला मीडिया प्राप्त करना पेज पर है। जिस इमेज की आपको अधिक समय तक ज़रूरत है, उसे संदेश के पढ़ने योग्य रहते ही संग्रहीत कर लें।

वेबहुक पेलोड

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

कोड उदाहरण
{
  "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?"
    }
  }
}

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

ध्यान रखने योग्य बातें

  • कैप्शन संपर्क का होता है। यह बिना किसी फ़ॉर्मैटिंग या एंटिटी जानकारी के सादे टेक्स्ट के रूप में आता है, इसलिए इसे टेक्स्ट के रूप में ही दिखाएँ।
  • हर संदेश में एक इमेज। जब कोई संपर्क कई फ़ोटो भेजता है, तो कई आने वाले संदेश बनते हैं, और हर संदेश का अपना id और अपना मीडिया संदर्भ होता है। इन्हें from और पहुँचने के समय के आधार पर समूहित करें, क्योंकि इन्हें एक साथ रखने वाला कोई ऐरे नहीं होता।

अगले कदम

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

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

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