WhatsApp वीडियो संदेश
एक वीडियो संदेश एक सार्वजनिक URL रखता है जिसे WhatsApp भेजते समय फ़ेच करता है, और इसके नीचे एक वैकल्पिक कैप्शन होता है।
वीडियो भेजें
video.url सेट करें:
const msg = await bird.whatsapp.send({
to: "+16505551234",
from: "+13124495648",
video: { url: "https://cdn.example.com/unboxing.mp4" },
});
console.log(msg.id, msg.status);msg = client.whatsapp.send(
to="+16505551234",
from_="+13124495648",
video={"url": "https://cdn.example.com/unboxing.mp4"},
)
print(msg.id, msg.status)package main
import (
"context"
"fmt"
"log"
"os"
bird "github.com/messagebird/bird-sdk-go"
"github.com/messagebird/bird-sdk-go/option"
)
func main() {
client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
if err != nil {
log.Fatal(err)
}
msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
To: "+16505551234",
From: "+13124495648",
Video: &bird.WhatsAppVideoSend{Url: "https://cdn.example.com/unboxing.mp4"},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(msg.Id, *msg.Status)
}$video = (new WhatsAppMessageSendRequestVideo())
->setUrl('https://cdn.example.com/unboxing.mp4');
$message = $bird->whatsapp->send(
to: '+16505551234',
from: '+13124495648',
video: $video,
);
echo $message->getId(), ' ', $message->getStatus();bird whatsapp send \
--from +13124495648 \
--to +16505551234 \
--video https://cdn.example.com/unboxing.mp4{
"name": "whatsapp_send",
"arguments": {
"from": "+13124495648",
"to": "+16505551234",
"video": {
"url": "https://cdn.example.com/unboxing.mp4"
}
}
}curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
-H "Authorization: Bearer $BIRD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+16505551234",
"from": "+13124495648",
"video": {
"url": "https://cdn.example.com/unboxing.mp4"
}
}'पूर्ण संरचना एक वैकल्पिक caption जोड़ती है:
कोड उदाहरण
{
"to": "+16505551234",
"from": "+13124495648",
"video": {
"url": "https://cdn.example.com/unboxing.mp4",
"caption": "How to set it up"
}
}video में कोई filename फ़ील्ड नहीं है। from हर सर्विस संदेश पर आवश्यक है: आपके वर्कस्पेस का अपना नंबर, Bird-प्रबंधित नंबर नहीं।
सीमाएँ
| फ़ील्ड | सीमा | लागू करने वाला |
|---|---|---|
| फ़ाइल साइज़ | 16 MB | केवल WhatsApp, फ़ेच पर (async) |
| फ़ॉर्मेट | MP4 कंटेनर, H.264 वीडियो, AAC ऑडियो | केवल WhatsApp, फ़ेच पर (async) |
| caption | अधिकतम 1,024 अक्षर | Bird, स्वीकृति पर (422) |
| url | absolute, https, होस्ट हो, कोई रॉ स्पेस न हो | Bird, स्वीकृति पर (422) |
Bird कुछ भी कतार में डालने से पहले URL की संरचना और कैप्शन की लंबाई जाँचता है। यह फ़ाइल का वास्तविक साइज़, कंटेनर या कोडेक नहीं जाँचता; केवल WhatsApp का अपना फ़ेच भेजते समय ऐसा कर सकता है। हब का URL द्वारा मीडिया भेजना और जब मीडिया विफल होता है देखें।
इनबाउंड वीडियो पढ़ना
एक इनबाउंड वीडियो वही video ऑब्जेक्ट रखता है, साथ ही एक id और mime_type जो Bird ने फ़ाइल फ़ेच करके प्राप्त किए। दोनों आउटबाउंड रीड-बैक में अनुपस्थित होते हैं, क्योंकि Bird ने भेजी गई फ़ाइल को कभी फ़ेच नहीं किया। पूरा इनबाउंड रीड, whatsapp.received पेलोड, और ध्यान रखने योग्य बातों के लिए WhatsApp वीडियो प्राप्त करना देखें।
सीमाएँ और विफलता के तरीके
- कस्टमर सर्विस विंडो खुली होनी चाहिए। वीडियो एक सर्विस संदेश है, केवल खुली विंडो के अंदर ही डिलीवर होता है; हब की कस्टमर सर्विस विंडो देखें।
- Bird http को अस्वीकार करता है; WhatsApp स्वयं इसे फ़ेच करेगा। पूर्ण संरचना जाँच के लिए हब का URL द्वारा मीडिया भेजना देखें।
- अस्वीकृत फ़ेच पर भी शुल्क लगता है। media_rejected और चार्ज-ऑन-फ़ेलियर तथ्य के लिए हब का जब मीडिया विफल होता है देखें। वीडियो के लिए WhatsApp से आने वाला अस्वीकृति टेक्स्ट अभी तक स्वतंत्र रूप से मापा नहीं गया है जैसा इमेज के लिए मापा गया है, इसलिए इस मैपिंग को प्रति कारण पुष्ट के बजाय समरूपता से अनुमानित मानें।
- WhatsApp फ़ेच किए गए URL को लगभग 10 मिनट तक कैश करता है। उस विंडो के अंदर वही URL दोबारा भेजने पर पहले वाला फ़ेच ही दिया जाता है; नया फ़ेच कराने के लिए URL बदलें।
- एनिमेटेड GIF कोई अलग टाइप नहीं है। WhatsApp के पास कोई gif संदेश टाइप नहीं है; आपका भेजा एनिमेटेड GIF प्राप्तकर्ता को पहुँचता है, और इनबाउंड में आपको वापस आता है, एक सामान्य video के रूप में जिसका MIME टाइप MP4 होता है।
अगले कदम
- WhatsApp सर्विस संदेश: कस्टमर सर्विस विंडो और वह मॉडल जो हर सर्विस संदेश साझा करता है
- इमेज: फ़ोटो या ग्राफ़िक के लिए वही संरचना
- ऑडियो: वॉइस नोट या ऑडियो क्लिप के लिए
- WhatsApp संदेश भेजना: अनुरोध एन्वेलप, 202 मॉडल, और सुरक्षित फिर से प्रयास
संबंधित संसाधन
इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।
गाइड देखेंConnecting WhatsApp to Bird: from buying a number to a live channelकॉन्सेप्ट समझेंWhat is the 24-hour customer service window on WhatsApp?टूल का उपयोग करेंWhatsApp message builderक्षमता जानेंWhatsApp
अभ्यास करें और इम्प्लीमेंटेशन ब्रीफ़ पाएँ