असमर्थित WhatsApp संदेश प्रकार

कुछ संदेश WhatsApp ऐप में काम करते हैं लेकिन API के ज़रिए पढ़े नहीं जा सकते। Bird इन्हें unsupported फ़ील्ड वाले प्राप्त संदेशों के रूप में रिकॉर्ड करता है। आप देख सकते हैं कि संदेश किसने और कब भेजा, लेकिन इसकी सामग्री डैशबोर्ड या API के ज़रिए नहीं पढ़ सकते। भेजने वाले से कहें कि जानकारी टेक्स्ट या किसी अन्य समर्थित संदेश प्रकार में दोबारा भेजें।

प्राप्त संदेश में त्रुटि क्यों हो सकती है

जब WhatsApp Cloud API किसी कंटेंट को सपोर्ट नहीं करता, तो Meta आने वाले संदेश की नोटिफ़िकेशन में error 131051 शामिल कर सकता है। कोई फ़ीचर WhatsApp ऐप में काम कर सकता है और फिर भी Cloud API के ज़रिए अनुपलब्ध हो सकता है।

Bird उस नोटिफ़िकेशन को direction: inbound और status: received के साथ रिकॉर्ड करता है। संदेश के last_error में meta_error_code: "131051" हो सकता है, भले ही Bird ने इसे भेजने का प्रयास नहीं किया। इस स्थिति में, त्रुटि अनुपलब्ध आने वाले कंटेंट का वर्णन करती है। यह किसी विफल आउटबाउंड भेजने का संकेत नहीं है।

नॉर्मलाइज़्ड last_error.code इस प्राप्त रिकॉर्ड पर undeliverable पढ़ सकता है। किसी रिकॉर्ड को डिलीवरी विफलता मानने से पहले direction, status, और last_error.meta_error_code को एक साथ जाँचें।

Meta उस संदेश के लिए भी 131060 का उपयोग करता है जो फ़िलहाल अनुपलब्ध है। यह तब हो सकता है जब कोई व्यक्ति किसी कनेक्टेड WhatsApp Business ऐप नंबर से पहली बार किसी बिज़नेस को संदेश भेजता है। इसका अर्थ असमर्थित कंटेंट त्रुटि 131051 से अलग है। इन नोटिफ़िकेशन के लिए Meta का असमर्थित संदेश संदर्भ देखें।

संदेश प्रकार पढ़ें

unsupported.type फ़ील्ड कंटेंट की उतनी सटीक पहचान करता है जितनी नोटिफ़िकेशन अनुमति देती है:

• जब Meta unsupported.type देता है, तो Bird उसका मान सुरक्षित रखता है, जैसे poll_creation, pin, या edit।
• जब Meta unsupported.type नहीं देता, तो Bird उस फ़ील्ड में संदेश का टॉप-लेवल type रखता है। unsupported या unknown जैसा मान भेजने वाले द्वारा की गई कार्रवाई की पहचान नहीं करता।
• जब Meta ऐसा कंटेंट देता है जिसे Bird का API मॉडल नहीं करता, तो Bird उसका type भी यहाँ रिकॉर्ड करता है, जैसे order या system।

टाइप नाम में गायब कॉन्टेंट शामिल नहीं होता। उदाहरण के लिए, poll_creation आपको प्रश्न या विकल्प नहीं देता, और edit आपको रिप्लेसमेंट टेक्स्ट नहीं देता। मैसेज स्टोर करते समय अपरिचित टाइप वैल्यू रखें ताकि आपका इंटीग्रेशन नए टाइप स्वीकार कर सके।

Bird इमेज, बटन रिप्लाई, लिस्ट रिप्लाई और रिएक्शन सपोर्ट करता है। इनमें से किसी नाम वाली असमर्थित नोटिफिकेशन उस विशेष नोटिफिकेशन का वर्णन करती है; इसका मतलब यह नहीं कि पूरा फ़ीचर असमर्थित है। देखें इमेज प्राप्त करना, इंटरैक्टिव रिप्लाई, और रिएक्शन वेबहुक।

प्राप्त वेबहुक को हैंडल करें

एक असमर्थित मैसेज data.unsupported.type के साथ whatsapp.received एमिट करता है। प्राप्त वेबहुक में मैसेज रिकॉर्ड का last_error शामिल नहीं होता; जब आपको वह डायग्नोस्टिक चाहिए तो API के ज़रिए मैसेज प्राप्त करें।

कॉन्टेंट प्रोसेस करने से पहले unsupported को स्पष्ट रूप से हैंडल करें। दिखाएं कि कॉन्टेंट अनुपलब्ध है, टाइप स्टोर करें, और हैंडल करने के बाद 2xx रिस्पॉन्स के साथ वेबहुक को एक्नॉलेज करें। उसी नोटिफिकेशन को फिर से प्रयास करने से गायब कॉन्टेंट वापस नहीं आता। एक्नॉलेजमेंट और फिर से प्रयास के व्यवहार के लिए वेबहुक डिलीवरी देखें।

रिकॉर्ड WhatsApp लॉग में दिखाई देता रहता है। Bird इसे कस्टमर सर्विस विंडो के लिए इनकमिंग मैसेज के रूप में हैंडल करता है।

आज़माने के लिए उदाहरण

ये unsupported.type के मानों के उदाहरण हैं। अगर आपका WhatsApp ऐप जिस कन्वर्सेशन को आप टेस्ट कर रहे हैं उसमें संबंधित ऐक्शन प्रदान करता है, तो आप इसे आज़मा सकते हैं और परिणामी रिकॉर्ड की जाँच कर सकते हैं:

उपलब्धता ऐप, बातचीत और खाते पर निर्भर करती है। आपको किसी कार्रवाई के लिए एक सामान्य प्रकार मिल सकता है, या कोई इनकमिंग संदेश सूचना नहीं मिल सकती। भेजने वाले, टाइमस्टैम्प और unsupported.type की तुलना अपनी की गई कार्रवाई से करें। यदि प्रकार सामान्य है, तो आप केवल उस रिकॉर्ड से कार्रवाई की पहचान नहीं कर सकते।

अगले कदम

• प्राप्त करना कैसे काम करता है: इनकमिंग संदेश, मीडिया, और वेबहुक
• इंटरैक्टिव उत्तर प्राप्त करना: बटन टैप और सूची चयन
• WhatsApp लॉग: डैशबोर्ड या API में संदेश देखें