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{
"name": "whatsapp_send",
"arguments": {
"from": "+13124495648",
"sticker": {
"url": "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-प्रबंधित नहीं।
सीमाएँ
| फ़ील्ड | सीमा | लागू करने वाला |
|---|---|---|
| फ़ाइल साइज़, स्टैटिक | 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 द्वारा मीडिया भेजना देखें।
- अस्वीकृत फ़ेच पर भी शुल्क लगता है। हब का मीडिया विफल होने पर देखें। WhatsApp से स्टिकर की अपनी अस्वीकृति टेक्स्ट स्वतंत्र रूप से मापी नहीं गई है, इसलिए इस मैपिंग को प्रति-कारण पुष्टि के बजाय सममिति द्वारा अनुमानित मानें।
- animated रीड-ओनली है, और केवल इनबाउंड या फ़ेच किए गए स्टिकर पर मौजूद होता है। यह WhatsApp का फ़ाइल पर अपना निर्णय है, कुछ ऐसा नहीं जो आप घोषित कर सकें। स्टिकर स्टैटिक है या एनिमेटेड, इससे केवल उसकी साइज़ सीमा बदलती है; WebP दोनों स्थितियों में अनिवार्य है।
- WhatsApp फ़ेच किए गए URL को लगभग 10 मिनट के लिए कैश करता है। उस विंडो के अंदर वही URL दोबारा भेजने पर पहले फ़ेच का कैश सर्व होता है; नया फ़ेच ज़बरदस्ती कराने के लिए URL बदलें।
अगले कदम
- WhatsApp सर्विस संदेश: कस्टमर सर्विस विंडो और वह मॉडल जो हर सर्विस संदेश साझा करता है
- Audio: बिना कैप्शन फ़ील्ड वाली एक और मीडिया शाखा
- Images: कैप्शन के साथ फ़ोटो या ग्राफ़िक के लिए
- 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
अभ्यास करें और इम्प्लीमेंटेशन ब्रीफ़ पाएँ