WhatsApp इमेज संदेश

इमेज संदेश में एक सार्वजनिक URL होता है, जिसे WhatsApp भेजते समय फ़ेच करता है। उसके नीचे एक वैकल्पिक कैप्शन भी हो सकता है।

Quiet shapes. Thoughtful details.

इमेज भेजें

image.url सेट करें:

const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  image: { url: "https://cdn.example.com/receipt.png" },
});
console.log(msg.id, msg.status);

msg = client.whatsapp.send(
    to="+16505551234",
    from_="+13124495648",
    image={"url": "https://cdn.example.com/receipt.png"},
)
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",
		Image: &bird.WhatsAppImageSend{Url: "https://cdn.example.com/receipt.png"},
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(msg.Id, *msg.Status)
}

$image = (new WhatsAppMessageSendRequestImage())
    ->setUrl('https://cdn.example.com/receipt.png');
$message = $bird->whatsapp->send(
    to: '+16505551234',
    from: '+13124495648',
    image: $image,
);
echo $message->getId(), ' ', $message->getStatus();

bird whatsapp send \
  --from +13124495648 \
  --image https://cdn.example.com/receipt.png \
  --to +16505551234

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",
      "image": {
        "url": "https://cdn.example.com/receipt.png"
      }
    }'

पूरे रूप में एक वैकल्पिक caption भी जुड़ता है:

{
  "to": "+16505551234",
  "from": "+13124495648",
  "image": {
    "url": "https://cdn.example.com/receipts/a1b2c3.png",
    "caption": "Your receipt for order A1B2C3"
  }
}

image में कोई filename फ़ील्ड नहीं होता। हर सेवा संदेश पर from ज़रूरी है: यह आपके वर्कस्पेस का अपना नंबर होना चाहिए, Bird द्वारा प्रबंधित नंबर नहीं।

सीमाएँ

कुछ भी कतार में डालने से पहले Bird URL का स्वरूप और कैप्शन की लंबाई जाँचता है। यह फ़ाइल का वास्तविक आकार या प्रकार नहीं जाँचता; यह जाँच केवल भेजते समय WhatsApp का अपना फ़ेच कर सकता है। स्वरूप की यह जाँच किन बातों को कवर करती है, यह जानने के लिए हब का URL से मीडिया भेजना देखें, और WhatsApp का फ़ेच फ़ाइल को अस्वीकार करे तो क्या होता है, इसके लिए जब मीडिया विफल हो देखें।

आने वाली इमेज पढ़ना

आने वाली इमेज में वही image ऑब्जेक्ट होता है, साथ ही id और mime_type भी, जो Bird को फ़ाइल फ़ेच करके पता चलते हैं। भेजे गए संदेश को वापस पढ़ने पर ये दोनों मौजूद नहीं होते, क्योंकि Bird ने अपनी भेजी फ़ाइल कभी फ़ेच नहीं की। आने वाले संदेश को पूरी तरह पढ़ने, whatsapp.received पेलोड और ध्यान रखने योग्य बातों के लिए WhatsApp इमेज प्राप्त करना देखें।

सीमाएँ और विफलता की स्थितियाँ

• ग्राहक सेवा विंडो खुली होनी चाहिए। इमेज सेवा संदेश हैं, जो केवल खुली विंडो के भीतर डिलीवर हो सकते हैं; हब की ग्राहक सेवा विंडो देखें।
• Bird http को अस्वीकार करता है, जबकि WhatsApp खुद उसे फ़ेच कर लेता। यह अंतर और URL स्वरूप जाँच का बाकी विवरण हब के URL से मीडिया भेजना पर है।
• बहुत बड़ी फ़ाइल, गलत MIME प्रकार या पहुँच से बाहर URL, तीनों एक ही तरह विफल होते हैं, और शुल्क लगने के बाद। media_rejected और विफलता पर भी शुल्क लगने के बारे में हब का जब मीडिया विफल हो देखें।
• WhatsApp फ़ेच किए गए URL को लगभग 10 मिनट तक कैश करता है। उस अवधि में वही URL दोबारा भेजने पर फिर से फ़ेच नहीं होता, बल्कि पहला फ़ेच ही परोसा जाता है; नया फ़ेच करवाने के लिए URL बदलें, जैसे कोई क्वेरी पैरामीटर जोड़कर।

अगले कदम

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