رفع اشکال

چرا: کنسول می‌گوید [Daneshyar] widget.js needs data-api-key, data-app-id and data-workspace-id، یا widget.js اصلاً بارگذاری نشده است.

راه‌حل: مطمئن شوید هر سه ویژگی روی همان تگ اسکریپت هستند و خالی نیستند. متغیر محیطی‌ای که موقع ساخت تنظیم نشده باشد، خالی است. نشانی src را در زبانهٔ Network بررسی کنید.

چرا: حالت درون‌صفحه‌ای عنصری لازم دارد که داخلش جا بگیرد. یا اسکریپت پیش از ساخته شدن آن عنصر اجرا شده، یا انتخابگر اشتباه است.

راه‌حل: <div id="daneshyar-widget"></div> را بالای تگ اسکریپت بگذارید، یا data-target را روی انتخابگر خودتان تنظیم کنید.

چرا: گفت‌وگو باز شده، اما کلید API به آن نرسیده است.

راه‌حل: مطمئن شوید data-api-key مقدار دارد. در فریم‌ورک‌ها بررسی کنید متغیر محیطی در مرورگر در دسترس باشد (مثلاً با پیشوند NEXT_PUBLIC_ یا VITE_).

چرا: سایت شما در دامنه‌های مجاز اپ نیست. این فهرست به کل اپ تعلق دارد و ابزارکِ همهٔ فضاهای کاری آن اپ را پوشش می‌دهد. یادتان باشد *.clinic.ir با clinic.ir جور نیست و localhost:5173 با localhost:3000 هم جور نیست.

راه‌حل: در کنسول، صفحهٔ ابزارک را باز کنید و دقیقاً همان نام میزبانی را که در نوار نشانی می‌بینید اضافه کنید.

چرا: سایت خودتان یک Content-Security-Policy می‌فرستد که سایت ابزارک را مجاز نمی‌داند.

راه‌حل: سایت ابزارک (نشانی داخل src کد ابزارک) را به script-src و frame-src این سیاست اضافه کنید.

چرا: ابزارک نتوانسته تنظیماتش را بارگذاری کند. معمولاً کلید اشتباه است (۴۰۳) یا شناسهٔ فضای کاری به این اپ تعلق ندارد (۴۰۴).

راه‌حل: کد را دوباره از صفحهٔ ابزارک همان فضای کاری کپی کنید. اگر شناسه‌ها درست است، یک دقیقهٔ دیگر امتحان کنید؛ شاید مشکل از شبکه باشد.

چرا: به یکی از محدودیت‌ها رسیده‌اید: ۲۰ سؤال در ساعت از یک نشانی IP، یا ۵۰۰ سؤال در روز برای کل اپ.

راه‌حل: کمی صبر کنید و دوباره امتحان کنید. همهٔ کسانی که در یک اداره به یک شبکه وصل‌اند، یک نشانی IP دارند. اگر محدودیت بیشتری لازم دارید، با ما تماس بگیرید.

چرا: اعتبار حسابی که مالک اپ است تمام شده است (۴۰۲). بازدیدکننده هیچ‌وقت پیامی دربارهٔ پرداخت نمی‌بیند.

راه‌حل: از کنسول، اعتبار حساب مالک را شارژ کنید.

چرا: فضای کاری سندی ندارد، یا هیچ‌کدام از اسنادش هنوز آماده نشده است.

راه‌حل: اسناد را در کنسول بارگذاری کنید و صبر کنید تا وضعیتشان «آماده» شود.

چرا: این رفتار عمدی است. ابزارک فقط از روی اسناد فضای کاری پاسخ می‌دهد و باقی سؤال‌ها را مؤدبانه رد می‌کند.

راه‌حل: دربارهٔ چیزی بپرسید که در اسنادتان آمده، یا سندی اضافه کنید که جواب را داشته باشد.

چرا: در برنامهٔ تک‌صفحه‌ای، اسکریپت داخل کامپوننت یک صفحه یا در دو جا اضافه شده است.

راه‌حل: آن را یک بار، در layout یا کامپوننت اصلی، بارگذاری کنید. راهنمای فریم‌ورک‌ها را ببینید.

چرا: کنسول هنوز نمی‌تواند فهرست خالی را ذخیره کند.

راه‌حل: برای خالی کردن فهرست با ما تماس بگیرید. تا آن موقع، دست‌کم یک دامنه را در فهرست نگه دارید.

چرا: هدر X-API-Key فرستاده نشده، یا کلید با هیچ اپی جور نیست. کلید نبودن یا اشتباه بودن، ۴۰۳ برمی‌گرداند، نه ۴۰۱.

راه‌حل: هدر را در همهٔ درخواست‌ها بفرستید و دور کلید فاصله یا شکست خط نگذارید. بررسی کنید سرورتان متغیر محیطی درست را می‌خواند.

چرا: شناسهٔ فضای کاری اشتباه است، فضای کاری حذف شده، یا به اپ دیگری تعلق دارد. هر کلید فقط فضاهای کاری اپ خودش را می‌بیند و برای بقیه ۴۰۴ می‌گیرد.

راه‌حل: با همان کلید، فضاهای کاری‌تان را با GET /v1/workspaces/ فهرست کنید و یکی از شناسه‌های همان فهرست را به کار ببرید.

چرا: بدنهٔ درخواست معتبر نیست؛ مثلاً در درخواست گفت‌وگو، external_user_id نیامده است.

راه‌حل: فیلد message پاسخ را بخوانید: نام فیلد و مشکلش را می‌گوید.

چرا: اعتبار حسابی که مالک اپ است تمام شده است.

راه‌حل: از کنسول اعتبار را شارژ کنید و بعد درخواست را دوباره بفرستید.

چرا: JavaScript سایت شما مستقیم /v1 را صدا می‌زند. API این اجازه را نمی‌دهد و این کار کلیدتان را هم لو می‌دهد.

راه‌حل: API را از سرورتان صدا بزنید. صفحهٔ امنیت را ببینید.

چرا: مشکلی کوتاه از سمت ما یا شبکه. ساختن پاسخ ممکن است چند ثانیه طول بکشد، چون اول اسناد شما خوانده می‌شود.

راه‌حل: برای درخواست‌های گفت‌وگو دست‌کم ۶۰ ثانیه مهلت بگذارید. خطاهای 5xx را بعد از کمی مکث دوباره بفرستید، اما خطاهای 4xx را نه.