رفتن به محتوا
دانشیارمستندات
ورود
  • معرفی
  • شروع سریع
  • دانشیار چیست؟
  • صفحهٔ اپ‌ها
  • داخل یک اپ
  • فضای کاری: فایل‌ها و گفت‌وگو
  • اشتراک‌گذاری و اعضا
  • یادداشت و ضبط صدا
  • تمرین زبان
  • رزرو نوبت
  • خودکارسازی
  • صفحهٔ خواندن فایل
  • پروفایل شما
  • کیف پول
  • گفتگوهای مشتریان
  • کلیدهای API
  • احراز هویت
  • اپ، فضای کاری، سند
  • پردازش سند
  • گفت‌وگو و نشست‌ها
  • ارجاع‌ها
  • مهارت‌ها
  • قراردادها
  • فضاهای کاری
  • سندها
  • گفت‌وگو
  • مهارت‌ها
  • خطاها
  • دستیار پشتیبانی مشتری
  • پایگاه دانش داخلی
  • چت‌بات مستندات
  • دستیار آموزشگاه
  • ابزارک سایت
  • تنظیمات ابزارک
  • راهنمای فریم‌ورک‌ها
  • امنیت
  • رفع اشکال
  • پرسش‌های پرتکرار
  1. مستندات
  2. امنیت و راهنما
  3. رفع اشکال

رفع اشکال

مشکل را از روی چیزی که می‌بینید پیدا کنید و بخوانید چرا پیش می‌آید و چطور حل می‌شود.

اول این‌ها را بررسی کنید

بیشتر مشکلات در یکی از این سه جا پیدا می‌شوند:

  1. ۱

    کنسول مرورگر را باز کنید

    کلید F12 (یا Cmd+Option+I در مک) را بزنید و Console را انتخاب کنید. پیام‌های خود ابزارک با [Daneshyar] شروع می‌شوند.

  2. ۲

    زبانهٔ Network را ببینید

    با widget فیلتر کنید. ببینید widget.js بارگذاری می‌شود یا نه، و کد وضعیت هر درخواست /api/widget/ را بررسی کنید.

  3. ۳

    با صفحهٔ ابزارک مقایسه کنید

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

مشکلات ابزارک

چرا: کنسول می‌گوید [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 را روی انتخابگر خودتان تنظیم کنید.

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

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

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

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

چرا: ابزارک برای این فضای کاری خاموش است. هر فضای کاری کلید روشن/خاموش خودش را دارد و فضای کاری تازه خاموش شروع می‌شود.

راه‌حل: در کنسول، صفحهٔ «ابزارک» همان فضای کاری را باز کنید و «ابزارک این فضای کاری» را روشن کنید. لازم نیست کد ابزارک را عوض کنید.

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

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

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

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

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

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

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

راه‌حل: از کنسول، کیف پول مالک را شارژ کنید (منوی عکس پروفایل ← کیف پول).

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

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

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

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

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

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

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

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

مشکلات REST API

هر خطا یک کد وضعیت و یک بدنه دارد. فهرست کامل در صفحهٔ خطاها آمده است.

چرا: هدر X-API-Key فرستاده نشده، یا کلید یک کلید محرمانهٔ معتبر نیست. کلید ابزارک (pk_…) اینجا پذیرفته نمی‌شود. کلید نبودن یا اشتباه بودن، ۴۰۳ برمی‌گرداند، نه ۴۰۱.

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

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

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

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

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

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

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

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

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

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

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

مرورگرها و دستگاه‌ها

  • ابزارک در نسخه‌های فعلی Chrome، Edge، Firefox و Safari، روی رایانه و گوشی، کار می‌کند.
  • اسکریپت بارگذار عمداً با JavaScript خیلی قدیمی نوشته شده تا حتی در مرورگر قدیمی هم صفحهٔ شما را خراب نکند.
  • بعضی افزونه‌های حریم خصوصی، iframeهای سایت‌های دیگر را مسدود می‌کنند. اگر دکمه دیده می‌شود اما گفت‌وگو خالی می‌ماند، یک بار با افزونه‌های خاموش امتحان کنید.
  • هر گفت‌وگو تا وقتی صفحه باز است ادامه دارد. اگر بازدیدکننده صفحه را دوباره بارگذاری کند، گفت‌وگوی تازه‌ای شروع می‌شود. چیزی در مرورگر بازدیدکننده ذخیره نمی‌شود.
قبلیامنیتبعدیپرسش‌های پرتکرار

در این صفحه

  • اول این‌ها را بررسی کنید
  • مشکلات ابزارک
  • مشکلات REST API
  • مرورگرها و دستگاه‌ها

همهٔ نمونه‌های این مستندات روی API واقعی اجرا می‌شوند. اگر نمونه‌ای کار نکرد، به ما بگویید؛ آن یک باگ در مستندات است.

خدماتدربارهٔ ماگفت‌وگو با ما