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 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 और आगमन समय से ग्रुप करें; कोई ऐरे इन्हें एकत्र नहीं करता।

अगले कदम

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

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

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