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

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

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

आने वाले ऑडियो में क्या होता है

कोड उदाहरण
{
  "id": "wam_01kyb3q8ndvt6r2h5k9wxc4pfa",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "audio": {
    "id": "waf_01kyb2m4xq7whs0d8n3prv6tez",
    "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kyb3q8ndvt6r2h5k9wxc4pfa/media/waf_01kyb2m4xq7whs0d8n3prv6tez",
    "mime_type": "audio/ogg; codecs=opus",
    "voice": true
  },
  "created_at": "2026-08-25T09:07:32Z"
}
फ़ील्डइसमें क्या होता है
idसंग्रहीत फ़ाइल, जिसे बाइट्स प्राप्त करते समय media_id के रूप में पास करना है
urlएक Bird URL, जिसे आपकी API कुंजी से प्राप्त किया जाता है
mime_typeWhatsApp द्वारा बताया गया मीडिया टाइप, जैसे वॉइस नोट के लिए audio/ogg; codecs=opus
voiceचैट में रिकॉर्ड किए गए वॉइस नोट के लिए true, संलग्न ऑडियो फ़ाइल के लिए नहीं

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

वॉइस नोट WhatsApp क्लाइंट में अपने आप डाउनलोड होता है और वहाँ प्राप्तकर्ता के लिए उसका ट्रांसक्रिप्शन हो सकता है। Bird ऑडियो को आगे भेज देता है और उसका ट्रांसक्रिप्शन नहीं करता। इसलिए आपके संपर्क को अपने ऐप में जो ट्रांसक्रिप्ट दिखता है, वह आपके पढ़े जाने वाले संदेश का हिस्सा नहीं होता।

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

संदेश ID और मीडिया id को चैनल के मीडिया मेथड में पास करें। हब के इनबाउंड मीडिया प्राप्त करना पेज पर यह कॉल हर भाषा में दी गई है, साथ ही वे रीडायरेक्ट और हेडर नियम भी जिनका यह पालन करती है।

mime_type कंटेनर और कोडेक दोनों बताता है। वॉइस नोट Ogg कंटेनर में Opus होता है, जबकि अटैचमेंट आमतौर पर MP3 या AAC होता है। टाइप इसी फ़ील्ड से पढ़ें, url के फ़ाइल एक्सटेंशन से नहीं, क्योंकि उसमें कोई एक्सटेंशन नहीं होता। बाइट्स को किसी ऐसी ट्रांसक्रिप्शन सेवा को देने से पहले टाइप जाँच लें जो केवल कुछ फ़ॉर्मैट स्वीकार करती है। संदेश और उसका मीडिया एक साथ, संदेश आने के 30 दिन बाद समाप्त हो जाते हैं। यह अवधि और उसके बाद रीड क्या लौटाते हैं, इसकी जानकारी हब के इनबाउंड मीडिया प्राप्त करना पेज पर है।

वेबहुक पेलोड

whatsapp.received इवेंट एनवेलप पर audio आर्म भेजता है, जिसमें voice फ़्लैग भी शामिल है:

कोड उदाहरण
{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:07:32.451Z",
  "data": {
    "whatsapp_id": "wam_01kyb3q8ndvt6r2h5k9wxc4pfa",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100" },
    "to": { "phone_number": "+13124495569" },
    "audio": {
      "id": "waf_01kyb2m4xq7whs0d8n3prv6tez",
      "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kyb3q8ndvt6r2h5k9wxc4pfa/media/waf_01kyb2m4xq7whs0d8n3prv6tez",
      "mime_type": "audio/ogg; codecs=opus",
      "voice": true
    }
  }
}

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

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

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

अगले कदम

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

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

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