WhatsApp का अवलोकन

Bird WhatsApp उसी प्लेटफ़ॉर्म और उन्हीं API कुंजियों का उपयोग करता है जिनका Bird Email और Bird SMS करते हैं। API कुंजी के क्षेत्रीय होस्ट (https://us1.platform.bird.com या https://eu1.platform.bird.com) को कॉल करें। WhatsApp एंडपॉइंट /v1/whatsapp/… के अंतर्गत हैं।

व्यवसाय की ओर से शुरू किए गए संदेश पहले से स्वीकृत संदेश टेम्पलेट का उपयोग करते हैं। आप Bird के प्रबंधित कैटलॉग से टेम्पलेट भेज सकते हैं, जिसके लिए आपके अपने नंबर की ज़रूरत नहीं होती और जो Bird द्वारा प्रबंधित सेंडर से भेजा जाता है। या आप अपना नंबर कनेक्ट करके उससे अपने टेम्पलेट भेज सकते हैं। संपर्क आपके अपने नंबर पर संदेश भेज सकते हैं, और Bird इन इनबाउंड संदेशों को आउटबाउंड संदेशों के साथ रिकॉर्ड करता है।

भेजना कैसे काम करता है

POST /v1/whatsapp/messages से WhatsApp संदेश भेजें: एक प्राप्तकर्ता, एक टेम्पलेट, और वैकल्पिक टैग और मेटाडेटा। हम अनुरोध की जाँच करते हैं और संदेश ID के साथ 202 Accepted लौटाते हैं। शुल्क और डिलीवरी असिंक्रोनस रूप से होते हैं। API में कोई बैच एंडपॉइंट नहीं है, इसलिए हर संदेश के लिए एक अनुरोध भेजें।

पूरे API को तीन बातें आकार देती हैं:

• भेजना और डिलीवरी अलग-अलग चरण हैं। 202 का अर्थ है कि Bird ने संदेश स्वीकार कर लिया है। प्राप्तकर्ता के डिवाइस तक संदेश तभी पहुँचता है जब वह WhatsApp से गुज़रकर अंतिम डिलीवरी परिणाम तक पहुँच जाता है। पढ़ने की रसीद read_at टाइमस्टैम्प और whatsapp.read इवेंट के रूप में दिखती है; इससे संदेश की स्थिति नहीं बदलती।
• व्यवसाय की ओर से शुरू किया गया हर संदेश टेम्पलेट का उपयोग करता है। टेम्पलेट का slug, वैकल्पिक language, और उसके वेरिएबल के मान दें। सर्विस संदेश, यानी फ़्री-फ़ॉर्म टेक्स्ट या मीडिया, किसी संपर्क तक केवल उस 24 घंटे की विंडो में पहुँचता है जो उसके अपने संदेश से खुलती है, और केवल उस नंबर से जो आपके वर्कस्पेस का है। देखें WhatsApp संदेश भेजना।
• श्रेणी और गंतव्य से सेंडर और कीमत तय होती है। हर टेम्पलेट की श्रेणी authentication, utility या marketing होती है। प्रबंधित टेम्पलेट अपनी श्रेणी के Bird नंबर से भेजा जाता है, इसलिए उसमें from फ़ील्ड नहीं होता; बाकी हर संदेश अपना सेंडर खुद बताता है। कीमत प्राप्तकर्ता के देश पर भी निर्भर करती है, और शुल्क दो चरणों में लगता है: Bird जब संदेश प्रोसेस करता है तब Bird का शुल्क, और संदेश डिलीवर होने पर Meta का हिस्सा। देखें लागत और बिलिंग।

डैशबोर्ड में WhatsApp ऐप

डैशबोर्ड में, WhatsApp वर्कस्पेस के चैनल ऐप्स में से एक है। इसके पेज:

दृश्यता

Bird हर संदेश के लिए एक टाइमलाइन रिकॉर्ड करता है। आउटबाउंड टाइमलाइन में accepted, sent, delivered, read और failure इवेंट शामिल होते हैं। इनबाउंड टाइमलाइन यह रिकॉर्ड करती है कि Bird को संदेश कब मिला।

• टाइमलाइन पढ़ें: GET /v1/whatsapp/messages/{message_id}/events संदेश के इवेंट लौटाता है। Messages पेज वही टाइमलाइन दिखाता है। WhatsApp इवेंट देखें।
• आउटबाउंड डिलीवरी इवेंट की सदस्यता लें: सार्वजनिक whatsapp.accepted, whatsapp.sent, whatsapp.delivered, whatsapp.read, whatsapp.failed और whatsapp.rejected इवेंट किसी webhook एंडपॉइंट पर भेजें।
• कुल मेट्रिक्स देखें: Metrics पेज पर अलग-अलग Outbound और Inbound टैब हैं।

संदेश प्राप्त करना

आपके वर्कस्पेस के स्वामित्व वाले नंबर पर भेजे गए इनबाउंड संदेशों को Bird received स्थिति के साथ संग्रहीत करता है। Bird-प्रबंधित नंबर आपके वर्कस्पेस के लिए संदेश प्राप्त नहीं करते। संदेश Messages पेज पर या GET /v1/whatsapp/messages?direction=inbound से खोजें। संदेश विवरण में टेक्स्ट, समर्थित मीडिया, दस्तावेज़, लोकेशन और वे कंटेंट प्रकार दिखते हैं जिन्हें Bird रेंडर नहीं कर सकता। प्राप्त मीडिया 30 दिनों तक उपलब्ध रहता है।

Metrics पेज का Inbound टैब Messages received टाइम सीरीज़ और By phone number ब्रेकडाउन दिखाता है। हर इनबाउंड संदेश के आते ही उस पर कार्रवाई करने के लिए इसके बजाय whatsapp.received webhook इवेंट की सदस्यता लें; इनबाउंड संदेश webhooks देखें।

कुछ प्राप्तकर्ता आपसे संदेश बंद करने को कहते हैं, और इसका सबसे आम तरीका STOP का जवाब भेजना है: Bird कीवर्ड सूची पहले से देता है, इसलिए यह बिना किसी सेटअप के आपके नंबरों पर काम करता है। आप किसी एक बिज़नेस अकाउंट तक सीमित सप्रेशन, या पूरे वर्कस्पेस पर लागू ऑप्ट-आउट भी रिकॉर्ड कर सकते हैं। दोनों ही स्थितियों में Bird उस पते पर आगे भेजे जाने वाले संदेश रोक देता है। ऑप्ट-आउट और कीवर्ड देखें।

अगले कदम

• WhatsApp संदेश भेजना: API के ज़रिए टेम्पलेट या सर्विस संदेश भेजें
• अपना नंबर कनेक्ट करना: अपने ब्रांड के नाम से संदेश भेजने और प्राप्त करने के लिए नंबर सेट अप करें
• टेम्पलेट: टेम्पलेट ब्राउज़ करें और उन्हें भेजने के लिए ज़रूरी वेरिएबल देखें
• WhatsApp संदेश प्राप्त करना: इनबाउंड संदेश पढ़ें और मीडिया प्राप्त करें
• वेबहुक: आने वाले संदेशों और डिलीवरी अपडेट की सदस्यता लें