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: प्राप्तकर्ता, टेम्पलेट, कंपोनेंट, टैग, एसिंक मॉडल
सर्विस मैसेज	नौ सामग्री प्रकार, सर्विस विंडो, और URL से मीडिया भेजना
प्राप्त करना	इनबाउंड संदेश, मीडिया फ़ेच करना, और whatsapp.received webhook
टेम्पलेट	टेम्पलेट कैटलॉग, कैटेगरी और वेरिएबल्स, और slug से भेजना
WhatsApp लॉग	इनबाउंड और आउटबाउंड संदेश, कंटेंट, स्टेटस, और इवेंट टाइमलाइन
इवेंट्स	संदेश टाइमलाइन और API पर रिएक्शन हिस्ट्री
Webhooks	डिलीवरी, इनकमिंग-मैसेज, रिएक्शन, सप्रेशन, और ग्रुप webhooks
Groups	कई ग्राहकों के साथ शेयर्ड चैट, इनवाइट लिंक, और ग्रुप सीमाएँ
ग्रुप को भेजना	ग्रुप को संबोधित करना, इसके लिए क्या चाहिए, और प्रति-प्रतिभागी रसीदें
ग्रुप संदेश प्राप्त करना	किस प्रतिभागी ने ग्रुप संदेश लिखा, और उसका जवाब कैसे दें
ऑप्ट-आउट	कीवर्ड नियम, प्राप्तकर्ता प्राथमिकताएँ, और सप्रेशन सूची
WhatsApp मेट्रिक्स	आउटबाउंड डिलीवरी प्रदर्शन और इनबाउंड संदेश वॉल्यूम
दर सीमाएँ	ऑर्गनाइज़ेशन पॉलिसी क्षमता, रिस्पॉन्स हेडर, और 429 हैंडलिंग