एक ही API से WhatsApp अपडेट, सत्यापन कोड और इंटरैक्टिव जवाब भेजें।
ऑर्डर पुष्टि, वन-टाइम सत्यापन कोड, रिच मीडिया और इंटरैक्टिव बटन या सूची मेन्यू सीधे अपने ग्राहकों की WhatsApp चैट में पहुँचाएँ। Bird भेजने से पहले टेम्पलेट पैरामीटर सत्यापित करता है और 24 घंटे की ग्राहक सेवा विंडो जाँचता है, जिससे विफल कॉल और अप्रत्याशित शुल्क से बचाव होता है, और डिलीवरी व पढ़ने की रसीदें आपके ऐप तक लगातार पहुँचती रहती हैं।
// Install the SDK
// npm install @messagebird/sdk
const msg = await bird.whatsapp.send({
to: "+15551234567",
template: {
slug: "bird_otp",
components: [{ type: "body", parameters: [{ type: "text", text: "123456" }] }],
},
});
console.log(msg.id, msg.status);हमारे TypeScript, Python, Go या PHP SDK, Bird CLI या सीधे HTTP अनुरोधों से कुछ ही मिनटों में अपना पहला संदेश भेजें। जब तक आपका अपना WhatsApp Business नंबर सत्यापित हो रहा है, Bird के पहले से स्वीकृत टेम्पलेट से तुरंत शुरू करें।
टेम्पलेट और 24 घंटे की विंडो
24 घंटे की विंडो के भीतर या बाहर सही प्रारूप भेजें।
WhatsApp व्यवसाय द्वारा शुरू किए गए संपर्क को सक्रिय ग्राहक बातचीत से अलग रखता है। सक्रिय चैट के बाहर ग्राहकों तक Meta द्वारा स्वीकृत यूटिलिटी, प्रमाणीकरण या मार्केटिंग टेम्पलेट से पहुँचें, फिर उनके संदेश या कॉल के बाद 24 घंटे तक मुक्त टेक्स्ट, मीडिया और इंटरैक्टिव मेन्यू भेजें।
बंद विंडो और वेरिएबल की गड़बड़ी पहले ही पकड़ें
Bird हर प्राप्तकर्ता और व्यवसाय नंबर के लिए 24 घंटे की ग्राहक सेवा विंडो ट्रैक करता है। अगर आपका ऐप विंडो बंद होने के बाद मुक्त संदेश भेजने की कोशिश करता है, या ऐसे टेम्पलेट वेरिएबल देता है जो आपके प्लेसहोल्डर से मेल नहीं खाते, तो API कुछ भी बनने या बिल होने से पहले कॉल अस्वीकार कर देती है।
रिच मीडिया, इंटरैक्टिव बटन और सूची मेन्यू
बातचीत खुली होने पर एक ही एंडपॉइंट से चित्र, PDF, ऑडियो क्लिप, वीडियो, लोकेशन या संपर्क कार्ड भेजें। क्विक-रिप्लाई बटन, कई विकल्पों वाले सूची मेन्यू, प्रोडक्ट कैरोसेल या लोकेशन और संपर्क अनुरोध जोड़ें, ताकि ग्राहक टाइप करने के बजाय टैप कर सकें।
रीयल-टाइम डिलीवरी ट्रैकिंग
API द्वारा स्वीकार किए जाने से लेकर पढ़ने की रसीद तक संदेशों को ट्रैक करें।
WhatsApp पर भेजना एसिंक्रोनस है। Bird के आपका अनुरोध स्वीकार करते ही, वेबहुक इवेंट और हर संदेश की टाइमलाइन दिखाते हैं कि संदेश कब WhatsApp को सौंपा गया, ग्राहक के फ़ोन पर पहुँचा और चैट में खोला गया।
Meta त्रुटि विवरण से अस्वीकृतियों का कारण जानें
अगर स्वीकार होने के बाद कोई संदेश विफल होता है, जैसे भेजे जाने के दौरान सेवा विंडो समाप्त हो जाए या Meta डिलीवरी रोक दे, तो Bird संदेश रिकॉर्ड पर विफलता का विवरण और मूल Meta त्रुटि कोड दर्ज करता है, ताकि आपकी टीम जान सके कि फिर से प्रयास करना है या चैनल बदलना है।
नेटवर्क पर फिर से प्रयास होने पर दोहरे संदेश रोकें
अपने भेजने के अनुरोध के साथ एक आइडेम्पोटेंसी कुंजी शामिल करें, ताकि रिटेंशन अवधि के भीतर टाइमआउट या वर्कर के फिर से प्रयास पर दोहरा संदेश भेजने के बजाय मूल प्रतिक्रिया लौटाई जाए।
दो-तरफ़ा वर्कफ़्लो के लिए संदर्भ
ग्राहकों के जवाबों को सही ऑर्डर या टिकट से जोड़े रखें।
किसी पिछले संदेश को उद्धृत करें, ताकि आपका ग्राहक अपनी चैट में ही देख सके कि आप किस प्रश्न या ऑर्डर का जवाब दे रहे हैं। जब ग्राहक क्विक-रिप्लाई बटन टैप करता है, सूची का कोई विकल्प चुनता है या किसी हाल के संदेश का जवाब देता है, तो Bird चुनी गई कार्रवाई और उद्धृत संदेश का संदर्भ लौटाता है, ताकि आपका ऐप जवाब को तुरंत सही जगह भेज सके।
भेजे जाने वाले संदेशों में टैग और मेटाडेटा जोड़ें
किसी भेजे जाने वाले संदेश में फ़िल्टर करने योग्य 20 तक टैग और 2 KB तक कस्टम JSON मेटाडेटा जोड़ें। संदेश लॉग को अभियान या वर्कफ़्लो के अनुसार बाँटें, और API रीड और डिलीवरी वेबहुक में अपने आंतरिक ऑर्डर या टिकट ID भेजे गए रिकॉर्ड से जुड़े रखें।
अपने कोडबेस, टर्मिनल या AI एजेंट से काम करें
Bird CLI से टेस्ट संदेश भेजें, डिलीवरी टाइमलाइन देखें और हाल का इतिहास फ़िल्टर करें, या Bird MCP सर्वर के ज़रिए अपने कोडिंग असिस्टेंट को जोड़ें, जो आपके वर्कस्पेस की भूमिका और प्रेषक अनुमतियों के अधीन रहता है।
WhatsApp पर भेजने से जुड़े प्रश्न
क्या स्वीकृत अनुरोध का मतलब है कि संदेश डिलीवर हो गया?
क्या मैं किसी भी समय फ़्री-फ़ॉर्म संदेश भेज सकता हूँ?
क्या कोई WhatsApp बैच एंडपॉइंट है?
मैं इंटरैक्टिव उत्तर को अपने ऐप्लिकेशन से कैसे मैच करूँ?
संपूर्ण यात्रा को जोड़ें
नियंत्रण खोए बिना स्केल करें।
Separate production and sandbox traffic into dedicated workspaces, scope API keys to the exact channels each service or agent needs, and track permission changes in the audit log.