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 key से फ़ेच किया जाता है
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?"
    },
    "tags": null,
    "metadata": null
  }
}

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

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

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

अगले कदम

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