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 वर्कस्पेस के चैनल ऐप्स में से एक है। इसके पेज:
| पेज | किसके लिए है |
|---|---|
| Messages | इनबाउंड और आउटबाउंड संदेश, प्रति-संदेश कंटेंट, इवेंट, और डिलीवरी विवरण के साथ |
| Metrics | आउटबाउंड डिलीवरी मेट्रिक्स और इनबाउंड संदेश वॉल्यूम |
| Templates | वे टेम्पलेट जो आप भेज सकते हैं, प्रबंधित और आपके अपने: नाम, भाषा, कैटेगरी, और रेंडर किया हुआ प्रीव्यू |
| Numbers | Bird-प्रबंधित प्रेषक नंबर और आपके अपने कनेक्टेड नंबर |
| Groups | 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 टैब एक प्राप्त संदेश टाइम सीरीज़ और फ़ोन नंबर के अनुसार ब्रेकडाउन दिखाता है। हर इनबाउंड संदेश आते ही उस पर कार्रवाई करने के लिए, इसके बजाय whatsapp.received webhook इवेंट को सब्सक्राइब करें; देखें इनबाउंड संदेश webhooks।
कुछ प्राप्तकर्ता आपसे रुकने के लिए कहते हैं, और STOP का जवाब इसका सबसे आम तरीका है: Bird कीवर्ड सूची के साथ आता है, इसलिए यह आपके नंबरों पर बिना किसी सेटअप के काम करता है। आप एक बिज़नेस अकाउंट तक सीमित सप्रेशन भी रिकॉर्ड कर सकते हैं, या पूरे वर्कस्पेस को कवर करने वाला ऑप्ट-आउट। Bird दोनों स्थितियों में उस पते पर बाद के संदेश ब्लॉक कर देता है। देखें ऑप्ट-आउट और कीवर्ड।
अगले कदम
- WhatsApp संदेश भेजना: API के ज़रिए टेम्पलेट या सर्विस संदेश भेजें
- अपना नंबर कनेक्ट करना: अपने ब्रांड से संदेश भेजने और प्राप्त करने के लिए नंबर सेट अप करें
- टेम्पलेट: टेम्पलेट ब्राउज़ करें और उन्हें भेजने के लिए ज़रूरी वेरिएबल खोजें
- WhatsApp संदेश प्राप्त करना: इनबाउंड संदेश पढ़ें और मीडिया फ़ेच करें
- Webhooks: इनकमिंग संदेशों और डिलीवरी अपडेट की सदस्यता लें
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।