Sign inGet Started

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

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

Sticker

स्टिकर भेजें

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);

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

सीमाएँ

फ़ील्डसीमाकौन लागू करता है
फ़ाइल का आकार, स्टैटिक100 KBकेवल WhatsApp, फ़ेच के समय (async)
फ़ाइल का आकार, ऐनिमेटेड500 KBकेवल WhatsApp, फ़ेच के समय (async)
फ़ाइल प्रकारकेवल WebPकेवल WhatsApp, फ़ेच के समय (async)
captionमान्य फ़ील्ड नहीं हैBird, स्वीकार करते समय (422, स्कीमा द्वारा अस्वीकृति)
urlनिरपेक्ष, https, होस्ट होना चाहिए, कोई कच्चा स्पेस नहींBird, स्वीकार करते समय (422)

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

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

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

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

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

अगले कदम

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

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