WhatsApp स्टिकर संदेश

स्टिकर संदेश में एक सार्वजनिक WebP URL होता है, जिसे WhatsApp भेजते समय फ़ेच करता है। यह सबसे सरल मीडिया प्रकार है: भेजते समय न कैप्शन होता है, न कोई अन्य वैकल्पिक फ़ील्ड।

स्टिकर भेजें

sticker.url सेट करें; इसके अलावा कुछ और जोड़ने की ज़रूरत नहीं है:

const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  sticker: { url: "https://cdn.example.com/stickers/thumbs-up.webp" },
});
console.log(msg.id, msg.status);

msg = client.whatsapp.send(
    to="+16505551234",
    from_="+13124495648",
    sticker={"url": "https://cdn.example.com/stickers/thumbs-up.webp"},
)
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",
		Sticker: &bird.WhatsAppStickerSend{Url: "https://cdn.example.com/stickers/thumbs-up.webp"},
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(msg.Id, *msg.Status)
}

$sticker = (new WhatsAppMessageSendRequestSticker())
    ->setUrl('https://cdn.example.com/stickers/thumbs-up.webp');
$message = $bird->whatsapp->send(
    to: '+16505551234',
    from: '+13124495648',
    sticker: $sticker,
);
echo $message->getId(), ' ', $message->getStatus();

bird whatsapp send \
  --from +13124495648 \
  --sticker https://cdn.example.com/stickers/thumbs-up.webp \
  --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",
      "sticker": {
        "url": "https://cdn.example.com/stickers/thumbs-up.webp"
      }
    }'

sticker में caption फ़ील्ड नहीं होता, और animated ऐसा कुछ नहीं है जिसे आप भेजते समय सेट करें; Bird इसे केवल आने वाले स्टिकर पर लौटाता है। हर सेवा संदेश के लिए from ज़रूरी है: यह आपके वर्कस्पेस का अपना नंबर होना चाहिए, न कि Bird द्वारा प्रबंधित नंबर।

सीमाएँ

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

आने वाला स्टिकर पढ़ना

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

सीमाएँ और विफलता के कारण

• ग्राहक सेवा विंडो खुली होनी चाहिए। स्टिकर सेवा संदेश हैं, जो केवल खुली विंडो के भीतर डिलीवर हो सकते हैं। हब में ग्राहक सेवा विंडो देखें।
• Bird http को अस्वीकार करता है, जबकि WhatsApp स्वयं उसे फ़ेच कर लेता। बनावट की पूरी जाँच के लिए हब में URL से मीडिया भेजना देखें।
• अस्वीकार हुए फ़ेच का भी शुल्क लगता है। हब में मीडिया विफल होने पर देखें। WhatsApp से स्टिकर के अपने अस्वीकृति संदेश को स्वतंत्र रूप से मापा नहीं गया है, इसलिए इस मैपिंग को हर कारण के लिए पुष्ट न मानें, बल्कि समानता के आधार पर अनुमानित मानें।
• animated केवल पढ़ा जा सकता है, और यह केवल आने वाले या फ़ेच किए गए स्टिकर पर मौजूद होता है। यह फ़ाइल के बारे में WhatsApp का अपना निर्णय है, जिसे आप स्वयं घोषित नहीं कर सकते। स्टिकर स्टैटिक हो या ऐनिमेटेड, इससे केवल उसकी आकार सीमा बदलती है। दोनों स्थितियों में WebP आवश्यक है।
• WhatsApp फ़ेच किए गए URL को लगभग 10 मिनट तक कैश करता है। उस अवधि में वही URL दोबारा भेजने पर पहला फ़ेच ही फिर से दिया जाता है। नया फ़ेच करवाने के लिए URL बदलें।

अगले कदम

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