चरण 1: चार समूहों में बाँटें (लोड / कॉन्फ़िग / फ़्रेमवर्क / प्रदर्शन)
आपका «चैट नहीं आई» जो भी हो, पहले चार समूहों तक सीमित करें — यही अधिकांश चक्कर बचाता है। फ़्लोचार्ट निर्णय स्पष्ट करता है: जाँचें कि स्क्रिप्ट लोड हुई (F12 में meiqia.js), फिर कॉन्फ़िग, फ़्रेमवर्क या प्रदर्शन-परत समस्या। बुनियाद हेतु देखें 美洽 वेब इंटीग्रेशन गाइड।
इंटीग्रेशन कैसे काम करता: यह JS इंजेक्शन क्यों विफल / ब्लॉक होता
एक वाक्य काफ़ी: 美洽 वेब विजेट आपके पेज में स्थिर घटक नहीं — यह meiqia.js है जो 美洽 के ऑफ़-डोमेन स्रोत से असिंक्रोनस लोड होता, गतिशील रूप से चैट कंटेनर (DOM / iframe) इंजेक्ट करता और लंबा क्रॉस-ओरिजिन कनेक्शन खोलता है। इंजेक्शन सफल होने हेतु चाहिए «स्क्रिप्ट लोड (सही प्लेसमेंट, adblock नहीं), कंटेनर CSS / अन्य प्लगइन से न ढका, entId और डोमेन मेल, और SPA रूट बदलाव के बाद दोबारा माउंट»। नीचे आरेख इस शृंखला और चार ब्लॉक बिंदु बनाता है — इसीलिए समान कोड एक साइट / फ़्रेमवर्क पर चलता पर दूसरे पर नहीं।
कोड सही रखा पर फिर भी नहीं दिखता: इंटीग्रेशन स्व-जाँच पैनल चलाएँ
यदि प्लेसमेंट, meiqia.js 200 और entId सब पुष्ट पर फिर भी नहीं दिखता, तो मूलतः «adblock» या «फ़्रेमवर्क / स्टैकिंग»। नीचे पैनल महत्व अनुसार क्रमित: हरा आमतौर पर ठीक, लाल (adblock, SPA / थर्ड-पार्टी प्लगइन स्टैकिंग) बारंबार जाल। एक-एक जाँच तेज़ी से स्थानीकृत करती है।
पूर्ण लक्षण तालिका (व्यवहार / आधिकारिक स्थिति · L2 मूल कारण)
नीचे तालिका एक साथ सामान्य न दिखने / त्रुटि लक्षण सूचीबद्ध करती, प्रत्येक अपनी आधिकारिक स्थिति और L2 मूल कारण के साथ। ऊपर खोज बॉक्स इस तालिका के डेटा से चलता — अपना मिला कीवर्ड खोजें।
| लक्षण | समूह | L1 व्यवहार / आधिकारिक स्थिति | L2 मूल कारण |
|---|---|---|---|
| चैट विंडो / बबल बिल्कुल नहीं दिखता | लोड विफलता | 美洽 वेब विजेट एक चिपकाए गए JS स्निपेट से तैरती चैट विंडो लोड करता है; पुष्टि करें कि कोड सही एम्बेड है और इंटीग्रेशन साइट कंसोल में कॉन्फ़िगर है। | विजेट असिंक्रोनस लोड के बाद DOM में इंजेक्ट होने वाला meiqia.js है, इसलिए «कुछ भी नहीं» आमतौर पर «स्क्रिप्ट कभी लोड नहीं हुई» — गलत प्लेसमेंट, adblock / कैश से ब्लॉक, या बेमेल डोमेन / entId, तो इंजेक्शन कभी नहीं चला। |
| स्क्रिप्ट लोड पर चैट बटन गायब | प्रदर्शन समस्याएँ | विजेट कोड साइट के अनुकूल होकर चैट बटन दिखाता है; प्रदर्शन विफल हो तो जाँचें कि यह स्टाइल से छिपा या प्रारंभीकरण बाधित। | स्क्रिप्ट लोड पर बटन गायब हो तो आमतौर पर «प्रदर्शन परत» समस्या: साइट-व्यापी CSS बटन स्थिति ओवरराइड / display:none, z-index हारता, या कोई अन्य स्थिर तत्व ढकता; कोई अन्य JS त्रुटि भी प्रारंभीकरण रोक सकती है। |
| meiqia.js adblock एक्सटेंशन से ब्लॉक | लोड विफलता | 美洽 चैट स्क्रिप्ट थर्ड-पार्टी डोमेन से आती है; ब्लॉकिंग एक्सटेंशन इंस्टॉल हो तो इसे विज्ञापन / ट्रैकर मानकर लोड रोक सकता है — ब्लॉकिंग बंद करें या व्हाइटलिस्ट करें। | ERR_BLOCKED_BY_CLIENT का अर्थ ब्राउज़र एक्सटेंशन (AdBlock / uBlock / AdGuard) ने अनुरोध को फ़िल्टर सूचियों से ब्लॉक किया। 美洽 स्क्रिप्ट «थर्ड-पार्टी ऑफ़-डोमेन + रियल-टाइम संचार» है, जिसे ऐसे नियम अक्सर विज्ञापन / ट्रैकर समझ लेते हैं, «कंसोल ठीक, उपयोगकर्ता पक्ष गायब» झूठी विफलता। |
| meiqia.js 404 / खराब स्थिति / मिश्रित सामग्री | लोड विफलता | तैनाती के बाद Network पैनल में meiqia.js खोजें; 200 स्थिति का अर्थ स्क्रिप्ट सही रखी और लोड है। | सामान्य गैर-200 कारण: कोड पेज / CDN कैश में अटका (प्रकाशन के बाद रीफ़्रेश नहीं), HTTP पेज पर लोड / अधूरी प्रमाणपत्र शृंखला मिश्रित-सामग्री ब्लॉक ट्रिगर, या टूटा / आंशिक कॉपी कोड। यह चरण विफल तो इंजेक्शन और कनेक्शन कभी नहीं होते। |
| कोड गलत जगह (head ब्लॉकिंग / प्रभावहीन) | लोड विफलता | 美洽 कोड को पेज के नीचे, </body> से पहले चिपकाने की सलाह देता है; विजेट मुख्य सामग्री लोड होने के बाद चलता है। | विजेट को DOM तैयार होने के बाद कंटेनर इंजेक्ट करना होता है। <head> में यह रेंडर ब्लॉक करता है (धीमे नेटवर्क पर पहले खाली स्क्रीन) या DOM तैयार होने से पहले चलकर विफल; कुछ async / मॉड्यूल स्कोप में लोड क्रम भी बिगड़ सकता है। |
| चैट विंडो / बटन स्टाइल टूटी | प्रदर्शन समस्याएँ | विजेट अपनी स्टाइल इंजेक्ट करता और साइट के अनुकूल होता है; साइट-व्यापी स्टाइल से टकराव दृश्य गड़बड़ी कर सकता है। | 美洽 स्क्रिप्ट रनटाइम पर CSS इंजेक्ट करती है; साइट-व्यापी स्टाइल (सार्वभौमिक चयनकर्ता / उच्च-प्राथमिकता नियम / रीसेट) पहले इसके वर्ग ओवरराइड करें तो स्थिति, स्टैकिंग और फ़ॉन्ट टूटते हैं — «गतिशील इंजेक्शन + एक दस्तावेज़ स्टाइल स्थान साझा» का दुष्प्रभाव। |
| बटन स्क्रीन से बाहर / ढका | प्रदर्शन समस्याएँ | विजेट बटन स्थिर-स्थिति तैरते रूप में आता है; अन्य स्थिर तत्वों से ढका हो तो स्टैकिंग या स्थिति समायोजित करें। | साइट के अन्य position:fixed तत्व (ऊपर जाएँ, तैरते विज्ञापन, अपनी सपोर्ट बार) उच्च z-index से 美洽 बटन ढकते हैं, या थीम इसके निर्देशांक गलत गणना करती, इसे «स्क्रीन बाहर / ढका» छोड़ती। |
| थर्ड-पार्टी प्लगइन / एनालिटिक्स DOM टकराव | प्रदर्शन समस्याएँ | पेज की अन्य स्क्रिप्ट जो DOM बदलें या अनुरोध रोकें, विजेट के सामान्य लोड और प्रदर्शन को प्रभावित कर सकती हैं। | हीटमैप / एनालिटिक्स / कन्वर्ज़न स्क्रिप्ट DOM दोबारा लिखती, ओवरले इंजेक्ट या अनुरोध रोकती हैं; वे और 美洽 एक ही दस्तावेज़ में इंजेक्ट होने से स्टैकिंग / इवेंट टकराते हैं और 美洽 कंटेनर ढका या इसका init बाधित। |
| SPA रूट बदलाव के बाद विजेट गायब | फ़्रेमवर्क इंटीग्रेशन | एकल-पेज ऐप (SPA) हेतु फ़्रेमवर्क रूट हुक से 美洽 विजेट लोड / init करें ताकि फ़्रंट-एंड रूटिंग के अनुकूल हो। | SPA फ़्रंट-एंड रूटिंग से व्यू बदलता, DOM नष्ट / दोबारा बनाता है, पर meiqia.js डिफ़ॉल्ट पहले लोड पर एक बार इंजेक्ट करता और रूट बदलाव पर स्वयं दोबारा नहीं बनता, इसलिए «पेज बदलो, चैट गायब»। |
| मैन्युअल init चाहिए (manualInit / init) | फ़्रेमवर्क इंटीग्रेशन | डाउनलोड के बाद ऑटो-इनिट रोकने हेतु 美洽 एम्बेड कोड के बाद _MEIQIA('manualInit') जोड़ें; ज़रूरत पर मैन्युअल init हेतु _MEIQIA('init') कॉल करें। | डिफ़ॉल्ट रूप से 美洽 डाउनलोड के तुरंत बाद init होता है; जब आपको पहले कंटेनर तैयार / ग्राहक जानकारी भेजी / रूट स्थिर चाहिए, वह समय «बहुत जल्दी» — क्रम नियंत्रित करने हेतु मैन्युअल init पर जाएँ। |
| entId मेल नहीं / एजेंट चैट नहीं पाते | कॉन्फ़िग / प्राधिकरण | कोड में entId के बाद की संख्या आपकी कंपनी की अद्वितीय आईडी है; वर्कबेंच से मेल न खाने पर एजेंट चैट संभाल नहीं सकते — सेटिंग्स - टीम - आईडी खोज में कंपनी आईडी खोजें। | entId स्निपेट को एक विशिष्ट कंपनी खाते से बाँधता है। किसी और के / अन्य परिवेश के कोड, या मिले खातों से, फ़्रंट-एंड विंडो लोड करता पर संदेश «दूसरी कंपनी» जाते हैं, तो यह वर्कबेंच कुछ नहीं पाता — क्लासिक «ठीक दिखता पर कुछ नहीं पाता»। |
| साइट डोमेन कंसोल में अनधिकृत | कॉन्फ़िग / प्राधिकरण | 美洽 कंसोल «इंटीग्रेशन साइट जोड़ें» की अनुमति देता है, प्रत्येक अपनी कॉन्फ़िग के साथ; नई साइट को ठीक इंटीग्रेट होने से पहले कंसोल में कॉन्फ़िगर करना होता है। | 美洽 कई साइटों को «इंटीग्रेशन साइट» के रूप में प्रबंधित करता है; डोमेन को पहचाने जाने हेतु कंसोल में पंजीकृत / अधिकृत होना चाहिए। नया अजोड़ा प्रोडक्शन डोमेन अस्वीकृत हो सकता या गलत कॉन्फ़िग से मैप। |
| मल्टी-साइट / उप-चैनल (प्रोब) मिश्रण | कॉन्फ़िग / प्राधिकरण | 美洽 प्रति साइट अलग विजेट और चैट लिंक तैनाती समर्थित करता है (उप-चैनल / प्रोब); डिफ़ॉल्ट साइट के अलावा और जोड़ सकते हैं, प्रत्येक अपनी कॉन्फ़िग के साथ। | अलग व्यवसाय लाइन को अलग एजेंट समूह / ऑटो-संदेश चाहिए, पर हर साइट एक डिफ़ॉल्ट स्निपेट साझा करे तो स्रोत अलग नहीं होते और कॉन्फ़िग मिल जाते। उप-चैनल (प्रोब) «एक कंपनी, कई प्रवेश, रूटेड» हेतु बने हैं। |
| मोबाइल वेब चैट नहीं दिखता / अलग तैनाती चाहिए | मोबाइल / SDK | विजेट कोड साइट के अनुकूल होता है; मोबाइल / PC समान स्निपेट उपयोग करते पर अलग तैनात होने चाहिए। | कई टीमों के पास अलग PC और मोबाइल पेज / टेम्पलेट होते और कोड केवल PC टेम्पलेट में चिपकाया। स्निपेट समान और स्व-अनुकूल, पर «चिपकाने» का चरण मोबाइल टेम्पलेट में भी करना होता; छूटा तो मोबाइल पर चैट नहीं। |
| नेटिव ऐप SDK इंटीग्रेशन / AppKey | मोबाइल / SDK | इन-ऐप इंटीग्रेशन को 美洽 वर्कबेंच से AppKey चाहिए (सेटिंग्स - इंटीग्रेशन - SDK, «APP कॉन्फ़िग जोड़ें»), और डेवलपर आधिकारिक दस्तावेज़ व डेमो अनुसार iOS / Android SDK इंटीग्रेट करते हैं। | ऐप वेब JS नहीं, नेटिव SDK उपयोग करता है: पहले AppKey हेतु «APP कॉन्फ़िग जोड़ें», फिर चैट UI, अपठित, पुश आदि हेतु प्रति प्लेटफ़ॉर्म SDK इंटीग्रेट — वेब विजेट से बिल्कुल अलग पथ। |
| SDK संदेश पुश नहीं आता | मोबाइल / SDK | 美洽 SDK पुश के दो मोड: «कोई पुश नहीं» पर एजेंट संदेश केवल ऐप के भीतर पहुँचते (पाने हेतु ऐप खोलें); «कस्टम पुश सर्वर» से उपयोगकर्ता ऐप छोड़ने के बाद भी फ़ोन पर पुश पाते हैं। | गायब «ऑफ़लाइन पुश» आमतौर पर पुश मोड «कोई पुश नहीं», या कोई कस्टम पुश सर्वर / प्रति-प्लेटफ़ॉर्म पुश प्रमाणपत्र नहीं। पथ «美洽 → ऐप सर्वर → उपयोगकर्ता फ़ोन»; एक कड़ी गायब तो केवल इन-ऐप प्राप्ति। |
| डिफ़ॉल्ट बटन छिपाएँ / कस्टम प्रवेश | API कॉल | 美洽 नेटिव चैट बटन न दिखाने हेतु _MEIQIA('withoutBtn') कॉल करें; init सफल होने पर चैट खोलने हेतु _MEIQIA('showPanel') कॉल करें। | डिफ़ॉल्ट रूप से नेटिव तैरता बटन रेंडर होता है; अपने प्रवेश हेतु init से पहले / दौरान «कोई नेटिव बटन नहीं» घोषित करें और «चैट खोलें» को अपने तत्व से बाँधें — API समय का मामला, «टूटा बटन» नहीं। |
| ग्राहक जानकारी भेजना / सिंक करना प्रभावहीन | API कॉल | 美洽 वेब विजेट विज़िटर डेटा चैट में लाने हेतु «ग्राहक जानकारी भेजें», «ग्राहक पहचान सिंक करें» और «कस्टम इवेंट जानकारी जोड़ें» API प्रदान करता है। | इन API को सही init समय के भीतर कॉल करना होता है: init सफल होने के बाद (या manualInit + init समय में)। बहुत जल्दी / देर, या गलत फ़ील्ड प्रारूप, तो «सेट पर प्रभावहीन»। |
美洽 न दिखने के कारण & इंटीग्रेशन तरीकों की तुलना (2026 अनुमान)
निम्नलिखित 美洽 की आधिकारिक सहायता (एक्सेस चैनल / JavaScript वेब विजेट API) और सार्वजनिक इंटीग्रेशन समस्या-निवारण से संश्लेषित 2026 अनुमान हैं (विक्रेता प्रतिबद्धता या प्रत्यक्ष माप नहीं; संदर्भ हेतु, संस्करण और ब्राउज़र नीति से बदलते):
| आयाम | अनुमान / तुलना |
|---|---|
| न दिखने के कारणों का वितरण (समुदाय / टिकट · अनु.) | प्लेसमेंट / लोड नहीं ~35% > adblock / ब्राउज़र एक्सटेंशन ~25% > कॉन्फ़िग / प्राधिकरण (entId / डोमेन) ~20% > फ़्रेमवर्क (SPA) ~12% > स्टाइल / थर्ड-पार्टी प्लगइन टकराव ~8% |
| इंटीग्रेशन वास्तव में क्या है | वेब विजेट = DOM इंजेक्ट करने वाला थर्ड-पार्टी ऑफ़-डोमेन असिंक्रोनस JS + लंबा क्रॉस-ओरिजिन कनेक्शन (एम्बेडेड स्थिर घटक नहीं); इसलिए प्लेसमेंट, adblock नियम, CSS स्टैकिंग, SPA जीवनचक्र प्रभावित |
| प्रति-प्लेटफ़ॉर्म इंटीग्रेशन (अनु.) | PC / मोबाइल वेब = JS विजेट (समान कोड, अलग तैनात); ऐप = नेटिव SDK (AppKey); WeChat / Douyin / RED = चैनल-अधिकृत इंटीग्रेशन |
| adblock प्रभाव (अनु.) | लगभग 30-40% PC उपयोगकर्ता adblock एक्सटेंशन उपयोग करते → थर्ड-पार्टी चैट स्क्रिप्ट विज्ञापन नियमों से ब्लॉक (ERR_BLOCKED_BY_CLIENT), «कंसोल ठीक, उपयोगकर्ता पक्ष गायब» का प्रमुख कारण |
| JS विजेट लाइव समय (आधिकारिक) | समर्पित JS को पेज नीचे चिपकाएँ, लगभग 3-5 मिनट में लाइव; entId कंपनी की अद्वितीय आईडी है, और वर्कबेंच से बेमेल एजेंट को बिना चैट छोड़ता है |
अनुमान आधार: स्रोत आधार रेखा + समय एक्सट्रापोलेशन (meiqia.com/help एक्सेस चैनल / JavaScript वेब विजेट, meiqia.im इंटीग्रेशन गाइड, सार्वजनिक समस्या-निवारण, 2026); संस्करण और ब्राउज़र ब्लॉकिंग नीति से बदलता। 美洽 की नवीनतम आधिकारिक जानकारी का पालन करें। अनौपचारिक · LLM स्थानीयकरण।
पाँच 美洽 इंटीग्रेशन तरीके तुलना (कोड / कठिनाई / सुविधाएँ / परिदृश्य / लाइव समय)
कौन-सा इंटीग्रेशन तरीका? नीचे तुलना त्वरित क्रॉस-संदर्भ हेतु 美洽 आधिकारिक दस्तावेज़ संश्लेषित करती (कोड मात्रा, सुविधा पूर्णता, सर्वोत्तम मेल, लाइव समय)। अधिकांश साइट «वेब JS विजेट» चुनती हैं।
| इंटीग्रेशन तरीका | कोड / कठिनाई | सुविधा पूर्णता | सर्वोत्तम हेतु | लाइव समय |
|---|---|---|---|---|
| वेब JS विजेट | एक JS स्निपेट · कम | सबसे पूर्ण (तैरता / पॉपअप / स्वतः अभिवादन / विज़िटर ट्रेल) | PC + मोबाइल साइट (आधिकारिक अनुशंसित) | ~3-5 मिनट |
| चैट लिंक | कोई कोड नहीं · न्यूनतम | बुनियादी चैट | बिना तकनीक / त्वरित चैट लिंक लगाना | तुरंत |
| API / WebIM SDK | विकास चाहिए · उच्च | गहन कस्टमाइज़ेशन (अपना UI / सिस्टम / ऑर्डर इंटीग्रेशन) | गहन एकीकरण हेतु विकास क्षमता वाली टीम | विकास अनुसार |
| नेटिव ऐप SDK | SDK इंटीग्रेट · उच्च | इन-ऐप चैट + संदेश पुश | iOS / Android ऐप | विकास अनुसार |
| CMS त्वरित सेटअप | प्लगइन / एक-क्लिक · कम | JS विजेट जैसा | WordPress / Fkw / Shopify साइट | मिनट |
चैनल / परिदृश्य → इंटीग्रेशन परिणाम मानचित्र
समान 美洽 चैनल / परिदृश्य अनुसार भिन्न इंटीग्रेट होता है। नीचे मानचित्र सामान्य चैनल दिखाता: हरा = चिपकाओ और चले, अंबर = सेटअप चाहिए (अलग तैनाती / init / व्हाइटलिस्ट), लाल = डिफ़ॉल्ट रूप से तरीका बदलें (adblock / entId / ऐप SDK उपयोग करता)।
अक्सर पूछे जाने वाले प्रश्न
美洽 चैट विंडो / बबल बिल्कुल नहीं दिखता — कैसे ठीक करें?
美洽 वेब विजेट एक चिपकाए गए JS स्निपेट से तैरती चैट विंडो लोड करता है; पुष्टि करें कि कोड सही एम्बेड है और इंटीग्रेशन साइट कंसोल में कॉन्फ़िगर है। विजेट असिंक्रोनस लोड के बाद DOM में इंजेक्ट होने वाला meiqia.js है, इसलिए «कुछ भी नहीं» आमतौर पर «स्क्रिप्ट कभी लोड नहीं हुई» — गलत प्लेसमेंट, adblock / कैश से ब्लॉक, या बेमेल डोमेन / entId, तो इंजेक्शन कभी नहीं चला। F12 → Network, meiqia.js खोजें: कोई अनुरोध नहीं → कोड प्रभावहीन (प्लेसमेंट जाँचें / कैश साफ़ करें); अनुरोध पर गैर-200 → ब्लॉक या पथ समस्या; सब ठीक पर फिर भी छिपा → entId / डोमेन प्राधिकरण और नीचे के समूह जाँचें।
美洽 स्क्रिप्ट लोड पर चैट बटन गायब — कैसे ठीक करें?
विजेट कोड साइट के अनुकूल होकर चैट बटन दिखाता है; प्रदर्शन विफल हो तो जाँचें कि यह स्टाइल से छिपा या प्रारंभीकरण बाधित। स्क्रिप्ट लोड पर बटन गायब हो तो आमतौर पर «प्रदर्शन परत» समस्या: साइट-व्यापी CSS बटन स्थिति ओवरराइड / display:none, z-index हारता, या कोई अन्य स्थिर तत्व ढकता; कोई अन्य JS त्रुटि भी प्रारंभीकरण रोक सकती है। F12 → Elements, 美洽 कंटेनर खोजें — मौजूद, छिपा, या स्क्रीन-बाहर?; अस्थायी रूप से कस्टम CSS / अन्य स्क्रिप्ट बंद कर दोबारा जाँचें; कंसोल में निष्पादन रोकने वाली त्रुटि देखें।
美洽 meiqia.js adblock एक्सटेंशन से ब्लॉक — कैसे ठीक करें?
美洽 चैट स्क्रिप्ट थर्ड-पार्टी डोमेन से आती है; ब्लॉकिंग एक्सटेंशन इंस्टॉल हो तो इसे विज्ञापन / ट्रैकर मानकर लोड रोक सकता है — ब्लॉकिंग बंद करें या व्हाइटलिस्ट करें। ERR_BLOCKED_BY_CLIENT का अर्थ ब्राउज़र एक्सटेंशन (AdBlock / uBlock / AdGuard) ने अनुरोध को फ़िल्टर सूचियों से ब्लॉक किया। 美洽 स्क्रिप्ट «थर्ड-पार्टी ऑफ़-डोमेन + रियल-टाइम संचार» है, जिसे ऐसे नियम अक्सर विज्ञापन / ट्रैकर समझ लेते हैं, «कंसोल ठीक, उपयोगकर्ता पक्ष गायब» झूठी विफलता। गुप्त मोड में या adblock बंद कर दोबारा जाँचें — दिखे तो ब्लॉकिंग कारण; उपयोगकर्ताओं से साइट व्हाइटलिस्ट कराएँ; फ़्रंट-एंड चैट स्क्रिप्ट को विलंबित / सशर्त लोड कर कुछ ऑटो-नियम टाल सकता है।
美洽 meiqia.js 404 / खराब स्थिति / मिश्रित सामग्री — कैसे ठीक करें?
तैनाती के बाद Network पैनल में meiqia.js खोजें; 200 स्थिति का अर्थ स्क्रिप्ट सही रखी और लोड है। सामान्य गैर-200 कारण: कोड पेज / CDN कैश में अटका (प्रकाशन के बाद रीफ़्रेश नहीं), HTTP पेज पर लोड / अधूरी प्रमाणपत्र शृंखला मिश्रित-सामग्री ब्लॉक ट्रिगर, या टूटा / आंशिक कॉपी कोड। यह चरण विफल तो इंजेक्शन और कनेक्शन कभी नहीं होते। प्रकाशन के बाद CDN / ब्राउज़र कैश साफ़ करें (या गुप्त); पूर्ण प्रमाणपत्र शृंखला के साथ पूर्ण HTTPS और मिश्रित सामग्री रहित सुनिश्चित करें; कॉपी किया कोड पूर्ण और अन-एस्केप्ड सत्यापित करें।
美洽 कोड गलत जगह (head ब्लॉकिंग / प्रभावहीन) — कैसे ठीक करें?
美洽 कोड को पेज के नीचे, </body> से पहले चिपकाने की सलाह देता है; विजेट मुख्य सामग्री लोड होने के बाद चलता है। विजेट को DOM तैयार होने के बाद कंटेनर इंजेक्ट करना होता है। <head> में यह रेंडर ब्लॉक करता है (धीमे नेटवर्क पर पहले खाली स्क्रीन) या DOM तैयार होने से पहले चलकर विफल; कुछ async / मॉड्यूल स्कोप में लोड क्रम भी बिगड़ सकता है। 美洽 JS को हर पेज के साझा फ़ुटर में, </body> से पहले रखें; SPA हेतु «SPA रूट» प्रविष्टि देखें और manualInit उपयोग करें; सुनिश्चित करें कि बंडलर इसे tree-shaking से न हटाए।
美洽 चैट विंडो / बटन स्टाइल टूटी — कैसे ठीक करें?
विजेट अपनी स्टाइल इंजेक्ट करता और साइट के अनुकूल होता है; साइट-व्यापी स्टाइल से टकराव दृश्य गड़बड़ी कर सकता है। 美洽 स्क्रिप्ट रनटाइम पर CSS इंजेक्ट करती है; साइट-व्यापी स्टाइल (सार्वभौमिक चयनकर्ता / उच्च-प्राथमिकता नियम / रीसेट) पहले इसके वर्ग ओवरराइड करें तो स्थिति, स्टैकिंग और फ़ॉन्ट टूटते हैं — «गतिशील इंजेक्शन + एक दस्तावेज़ स्टाइल स्थान साझा» का दुष्प्रभाव। F12 से देखें कौन-सा साइट नियम 美洽 कंटेनर ओवरराइड करता है; साइट-व्यापी स्टाइल संकीर्ण करें / सामान्य वर्गों पर प्रभाव घटाएँ; ज़रूरत हो तो 美洽 से कंटेनर स्टैकिंग समायोजन कहें।
美洽 बटन स्क्रीन से बाहर / ढका — कैसे ठीक करें?
विजेट बटन स्थिर-स्थिति तैरते रूप में आता है; अन्य स्थिर तत्वों से ढका हो तो स्टैकिंग या स्थिति समायोजित करें। साइट के अन्य position:fixed तत्व (ऊपर जाएँ, तैरते विज्ञापन, अपनी सपोर्ट बार) उच्च z-index से 美洽 बटन ढकते हैं, या थीम इसके निर्देशांक गलत गणना करती, इसे «स्क्रीन बाहर / ढका» छोड़ती। वास्तविक निर्देशांक / z-index देखने हेतु F12 में 美洽 कंटेनर चुनें; इसे ऊँचा करें या ढकने वाले तत्व का z-index घटाएँ; एक कोने में कई स्थिर तैरते तत्व न लगाएँ।
美洽 थर्ड-पार्टी प्लगइन / एनालिटिक्स DOM टकराव — कैसे ठीक करें?
पेज की अन्य स्क्रिप्ट जो DOM बदलें या अनुरोध रोकें, विजेट के सामान्य लोड और प्रदर्शन को प्रभावित कर सकती हैं। हीटमैप / एनालिटिक्स / कन्वर्ज़न स्क्रिप्ट DOM दोबारा लिखती, ओवरले इंजेक्ट या अनुरोध रोकती हैं; वे और 美洽 एक ही दस्तावेज़ में इंजेक्ट होने से स्टैकिंग / इवेंट टकराते हैं और 美洽 कंटेनर ढका या इसका init बाधित। टकराव खोजने हेतु संदिग्ध प्लगइन एक-एक बंद करें; लोड क्रम / कंटेनर स्टैकिंग समायोजित करें; हीटमैप आदि को 美洽 कंटेनर क्षेत्र से बचाएँ।
美洽 SPA रूट बदलाव के बाद विजेट गायब — कैसे ठीक करें?
एकल-पेज ऐप (SPA) हेतु फ़्रेमवर्क रूट हुक से 美洽 विजेट लोड / init करें ताकि फ़्रंट-एंड रूटिंग के अनुकूल हो। SPA फ़्रंट-एंड रूटिंग से व्यू बदलता, DOM नष्ट / दोबारा बनाता है, पर meiqia.js डिफ़ॉल्ट पहले लोड पर एक बार इंजेक्ट करता और रूट बदलाव पर स्वयं दोबारा नहीं बनता, इसलिए «पेज बदलो, चैट गायब»। ऑटो-इनिट रोकने हेतु _MEIQIA('manualInit') उपयोग करें और रूट हुक (React useEffect / Vue mounted / router afterEach) में आवश्यकता पर दोबारा माउंट हेतु _MEIQIA('init') कॉल करें; कई इंस्टेंस से बचें।
美洽 मैन्युअल init चाहिए (manualInit / init) — कैसे ठीक करें?
डाउनलोड के बाद ऑटो-इनिट रोकने हेतु 美洽 एम्बेड कोड के बाद _MEIQIA('manualInit') जोड़ें; ज़रूरत पर मैन्युअल init हेतु _MEIQIA('init') कॉल करें। डिफ़ॉल्ट रूप से 美洽 डाउनलोड के तुरंत बाद init होता है; जब आपको पहले कंटेनर तैयार / ग्राहक जानकारी भेजी / रूट स्थिर चाहिए, वह समय «बहुत जल्दी» — क्रम नियंत्रित करने हेतु मैन्युअल init पर जाएँ। कोड के बाद _MEIQIA('manualInit') जोड़ें; शर्तें तैयार होने पर (DOM / सत्र / रूट) _MEIQIA('init') कॉल करें; जानकारी API को दस्तावेज़ अनुसार init समय में क्रम से कॉल करें।
अधिक इंटीग्रेशन सेटअप: 美洽 वेब इंटीग्रेशन, APP SDK इंटीग्रेशन; शुरुआत हेतु: 美洽 गाइड। खोजने योग्य पूर्ण संस्करण (इस टूल सहित) यहाँ भी 美洽 इंटीग्रेशन समस्या-निवारण (GitHub Pages)।