ধাপ ১: চার দলে ভাগ করুন (লোড / কনফিগ / ফ্রেমওয়ার্ক / প্রদর্শন)
আপনার «চ্যাট আসেনি» যাই হোক, আগে চার দলে সংকীর্ণ করুন — এটাই বেশিরভাগ ঘোরাঘুরি বাঁচায়। ফ্লোচার্ট সিদ্ধান্ত স্পষ্ট করে: স্ক্রিপ্ট আদৌ লোড হয়েছে কিনা (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, তাই ইনজেকশন কখনো চলেনি। |
| স্ক্রিপ্ট লোড কিন্তু চ্যাট বোতাম নেই | প্রদর্শন সমস্যা | উইজেট কোড সাইটে মানিয়ে নেয় ও চ্যাট বোতাম দেখায়; প্রদর্শন ব্যর্থ হলে দেখুন এটি স্টাইলে লুকানো নাকি init বাধাগ্রস্ত। | স্ক্রিপ্ট লোড কিন্তু বোতাম নেই হলে সাধারণত «প্রদর্শন স্তর» সমস্যা: সাইট-ব্যাপী CSS বোতামের অবস্থান ওভাররাইড / display:none, z-index হারে, বা অন্য স্থির উপাদান ঢাকে; অন্য JS ত্রুটিও init বাধাগ্রস্ত করতে পারে। |
| meiqia.js adblock এক্সটেনশনে ব্লকড | লোড ব্যর্থতা | 美洽 চ্যাট স্ক্রিপ্ট থার্ড-পার্টি ডোমেন থেকে আসে; ব্লকিং এক্সটেনশন থাকলে এটি বিজ্ঞাপন / ট্র্যাকার ভেবে লোড আটকাতে পারে — ব্লকিং বন্ধ বা হোয়াইটলিস্ট করুন। | ERR_BLOCKED_BY_CLIENT মানে ব্রাউজার এক্সটেনশন (AdBlock / uBlock / AdGuard) ফিল্টার তালিকা দিয়ে অনুরোধ ব্লক করেছে। 美洽 স্ক্রিপ্ট «থার্ড-পার্টি অফ-ডোমেন + রিয়েল-টাইম যোগাযোগ», যা এমন নিয়ম প্রায়ই বিজ্ঞাপন / ট্র্যাকার ভুল বোঝে, «কনসোল ঠিক, ব্যবহারকারী দিকে নেই» মিথ্যা ব্যর্থতা ঘটায়। |
| meiqia.js 404 / খারাপ স্ট্যাটাস / মিশ্র কনটেন্ট | লোড ব্যর্থতা | ডিপ্লয়ের পর Network প্যানেলে meiqia.js খুঁজুন; ২০০ স্ট্যাটাস মানে স্ক্রিপ্ট সঠিক স্থাপিত ও লোডড। | সাধারণ নন-২০০ কারণ: কোড পৃষ্ঠা / 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) | ফ্রেমওয়ার্ক ইন্টিগ্রেশন | ডাউনলোডের পর অটো-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 অনুমান (বিক্রেতার প্রতিশ্রুতি বা প্রত্যক্ষ পরিমাপ নয়; রেফারেন্সের জন্য, সংস্করণ ও ব্রাউজার নীতিতে বদলায়):
| মাত্রা | অনুমান / তুলনা |
|---|---|
| না দেখানোর কারণের বণ্টন (কমিউনিটি / টিকিট · অনু.) | অবস্থান / লোড হয়নি ~৩৫% > adblock / ব্রাউজার এক্সটেনশন ~২৫% > কনফিগ / অনুমোদন (entId / ডোমেন) ~২০% > ফ্রেমওয়ার্ক (SPA) ~১২% > স্টাইল / থার্ড-পার্টি প্লাগইন দ্বন্দ্ব ~৮% |
| ইন্টিগ্রেশন আসলে কী | ওয়েব উইজেট = DOM ইনজেক্টকারী থার্ড-পার্টি অফ-ডোমেন অ্যাসিনক্রোনাস JS + দীর্ঘস্থায়ী ক্রস-অরিজিন সংযোগ (এমবেড স্ট্যাটিক কম্পোনেন্ট নয়); তাই অবস্থান, adblock নিয়ম, CSS স্ট্যাকিং, SPA জীবনচক্রে প্রভাবিত |
| প্রতি-প্ল্যাটফর্ম ইন্টিগ্রেশন (অনু.) | PC / মোবাইল ওয়েব = JS উইজেট (একই কোড, আলাদা ডিপ্লয়); অ্যাপ = নেটিভ SDK (AppKey); WeChat / Douyin / RED = চ্যানেল-অনুমোদিত ইন্টিগ্রেশন |
| adblock প্রভাব (অনু.) | প্রায় ৩০-৪০% PC ব্যবহারকারী adblock এক্সটেনশন ব্যবহার করেন → থার্ড-পার্টি চ্যাট স্ক্রিপ্ট বিজ্ঞাপন নিয়মে ব্লকড (ERR_BLOCKED_BY_CLIENT), «কনসোল ঠিক, ব্যবহারকারী দিকে নেই» এর প্রধান কারণ |
| JS উইজেট লাইভ সময় (অফিশিয়াল) | নিবেদিত JS পৃষ্ঠার নিচে পেস্ট করলে প্রায় ৩-৫ মিনিটে লাইভ; entId কোম্পানির অনন্য আইডি, আর ওয়ার্কবেঞ্চের সাথে অমিল এজেন্টদের চ্যাটহীন রাখে |
অনুমান ভিত্তি: উৎস বেসলাইন + সময় এক্সট্রাপোলেশন (meiqia.com/help অ্যাক্সেস চ্যানেল / JavaScript ওয়েব উইজেট, meiqia.im ইন্টিগ্রেশন গাইড, সর্বজনীন সমস্যা-সমাধান, 2026); সংস্করণ ও ব্রাউজার ব্লকিং নীতিতে বদলায়। 美洽-এর সর্বশেষ অফিশিয়াল তথ্য অনুসরণ করুন। অনানুষ্ঠানিক · LLM স্থানীয়করণ।
পাঁচ 美洽 ইন্টিগ্রেশন পদ্ধতির তুলনা (কোড / কঠিনতা / বৈশিষ্ট্য / পরিস্থিতি / লাইভ সময়)
কোন ইন্টিগ্রেশন পদ্ধতি? নিচের তুলনা দ্রুত ক্রস-রেফারেন্সে 美洽 অফিশিয়াল ডক সংশ্লেষ করে (কোড পরিমাণ, বৈশিষ্ট্য পূর্ণতা, সেরা মানানসই, লাইভ সময়)। বেশিরভাগ সাইট «ওয়েব JS উইজেট» বেছে নেয়।
| ইন্টিগ্রেশন পদ্ধতি | কোড / কঠিনতা | বৈশিষ্ট্য পূর্ণতা | উপযুক্ত | লাইভ সময় |
|---|---|---|---|---|
| ওয়েব JS উইজেট | এক JS স্নিপেট · কম | সবচেয়ে পূর্ণ (ভাসমান / পপআপ / অটো-অভ্যর্থনা / দর্শক ট্রেইল) | PC + মোবাইল সাইট (অফিশিয়াল প্রস্তাবিত) | ~৩-৫ মিনিট |
| চ্যাট লিঙ্ক | কোড নেই · সর্বনিম্ন | মৌলিক চ্যাট | টেকনিক ছাড়া / দ্রুত চ্যাট লিঙ্ক রাখা | তাৎক্ষণিক |
| 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 খুঁজুন: কোনো অনুরোধ নেই → কোড কার্যকর নয় (অবস্থান যাচাই / ক্যাশ মুছুন); অনুরোধ কিন্তু নন-২০০ → ব্লকড বা পথ সমস্যা; সব ঠিক কিন্তু এখনো লুকানো → entId / ডোমেন অনুমোদন ও নিচের দল যাচাই করুন।
美洽 স্ক্রিপ্ট লোড কিন্তু চ্যাট বোতাম নেই — কীভাবে ঠিক করবেন?
উইজেট কোড সাইটে মানিয়ে নেয় ও চ্যাট বোতাম দেখায়; প্রদর্শন ব্যর্থ হলে দেখুন এটি স্টাইলে লুকানো নাকি init বাধাগ্রস্ত। স্ক্রিপ্ট লোড কিন্তু বোতাম নেই হলে সাধারণত «প্রদর্শন স্তর» সমস্যা: সাইট-ব্যাপী CSS বোতামের অবস্থান ওভাররাইড / display:none, z-index হারে, বা অন্য স্থির উপাদান ঢাকে; অন্য JS ত্রুটিও init বাধাগ্রস্ত করতে পারে। F12 → Elements, 美洽 কন্টেইনার খুঁজুন — আছে, লুকানো, নাকি স্ক্রিন-বাইরে?; পুনঃপরীক্ষায় সাময়িকভাবে কাস্টম CSS / অন্য স্ক্রিপ্ট বন্ধ করুন; কার্যনির্বাহ থামানো ত্রুটির জন্য কনসোল যাচাই করুন।
美洽 meiqia.js adblock এক্সটেনশনে ব্লকড — কীভাবে ঠিক করবেন?
美洽 চ্যাট স্ক্রিপ্ট থার্ড-পার্টি ডোমেন থেকে আসে; ব্লকিং এক্সটেনশন থাকলে এটি বিজ্ঞাপন / ট্র্যাকার ভেবে লোড আটকাতে পারে — ব্লকিং বন্ধ বা হোয়াইটলিস্ট করুন। ERR_BLOCKED_BY_CLIENT মানে ব্রাউজার এক্সটেনশন (AdBlock / uBlock / AdGuard) ফিল্টার তালিকা দিয়ে অনুরোধ ব্লক করেছে। 美洽 স্ক্রিপ্ট «থার্ড-পার্টি অফ-ডোমেন + রিয়েল-টাইম যোগাযোগ», যা এমন নিয়ম প্রায়ই বিজ্ঞাপন / ট্র্যাকার ভুল বোঝে, «কনসোল ঠিক, ব্যবহারকারী দিকে নেই» মিথ্যা ব্যর্থতা ঘটায়। ইনকগনিটোতে বা adblock বন্ধে পুনঃপরীক্ষা করুন — দেখালে ব্লকিংই কারণ; ব্যবহারকারীদের সাইট হোয়াইটলিস্ট করতে বলুন; ফ্রন্টএন্ড চ্যাট স্ক্রিপ্ট বিলম্বিত / শর্তসাপেক্ষে লোড করে কিছু অটো নিয়ম এড়াতে পারে।
美洽 meiqia.js 404 / খারাপ স্ট্যাটাস / মিশ্র কনটেন্ট — কীভাবে ঠিক করবেন?
ডিপ্লয়ের পর Network প্যানেলে meiqia.js খুঁজুন; ২০০ স্ট্যাটাস মানে স্ক্রিপ্ট সঠিক স্থাপিত ও লোডড। সাধারণ নন-২০০ কারণ: কোড পৃষ্ঠা / 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 ডিফল্ট প্রথম লোডে একবার ইনজেক্ট করে আর রুট পরিবর্তনে নিজে পুনর্নির্মিত হয় না, তাই «পৃষ্ঠা বদলান, চ্যাট হারায়»। অটো-init থামাতে _MEIQIA('manualInit') ব্যবহার করুন এবং দরকারে পুনঃমাউন্টে রুট হুকে (React useEffect / Vue mounted / router afterEach) _MEIQIA('init') কল করুন; একাধিক ইনস্ট্যান্স init এড়ান।
美洽 ম্যানুয়াল init দরকার (manualInit / init) — কীভাবে ঠিক করবেন?
ডাউনলোডের পর অটো-init থামাতে 美洽 এমবেড কোডের পর _MEIQIA('manualInit') যোগ করুন; দরকারে ম্যানুয়াল init-এ _MEIQIA('init') কল করুন। ডিফল্টে 美洽 ডাউনলোডের সাথে সাথে init হয়; যখন আগে কন্টেইনার প্রস্তুত / গ্রাহক তথ্য পাঠানো / রুট স্থিতিশীল দরকার, সেই সময় «খুব আগে» — ক্রম নিয়ন্ত্রণে ম্যানুয়াল init-এ যান। কোডের পর _MEIQIA('manualInit') যোগ করুন; শর্ত প্রস্তুত হলে (DOM / সেশন / রুট) _MEIQIA('init') কল করুন; তথ্য API ডক অনুযায়ী init সময়ে ক্রমে কল করুন।
আরো ইন্টিগ্রেশন সেটআপ: 美洽 ওয়েব ইন্টিগ্রেশন, APP SDK ইন্টিগ্রেশন; শুরুতে: 美洽 গাইড। সার্চযোগ্য সম্পূর্ণ সংস্করণ (এই টুলসহ) এখানেও 美洽 ইন্টিগ্রেশন সমস্যা-সমাধান (GitHub Pages)।