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

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 द्वारा प्रबंधित नंबर नहीं।

सीमाएँ

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 प्राप्तकर्ता तक MP4 MIME प्रकार वाले साधारण video के रूप में पहुँचता है, और इनबाउंड में भी आपको इसी रूप में मिलेगा।

अगले कदम

• WhatsApp सेवा संदेश: ग्राहक सेवा विंडो और वह मॉडल जो हर सेवा संदेश में समान है
• इमेज: फ़ोटो या ग्राफ़िक के लिए वही संरचना
• ऑडियो: वॉइस नोट या ऑडियो क्लिप के लिए
• WhatsApp संदेश भेजना: अनुरोध की संरचना, 202 मॉडल और सुरक्षित रूप से फिर से प्रयास करना