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

پرسش‌های پرتکرار

پاسخ‌های کوتاه دربارهٔ کلیدها، ابزارک، پاسخ‌ها و راه‌اندازی.

کلیدهای API

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

کلید ابزارک: در صفحهٔ اپ، هر وقت بخواهید کپی‌اش کنید. کلید محرمانه فقط یک بار نمایش داده می‌شود — اگر گمش کردید، زیر «کلید محرمانه» «ساخت کلید جدید» را بزنید و از کلید تازه استفاده کنید.

بله، هر کلید جداگانه. در صفحهٔ اپ در کنسول، «ساخت کلید جدید» را برای کلید تازه یا «حذف» را برای از کار انداختن آن بزنید. کلید قدیمی همان لحظه باطل می‌شود. امنیت را ببینید.

کلید محرمانه: در متغیر محیطی سرور یا یک ابزار نگهداری رمزها، و هیچ‌وقت در Git. کلید ابزارک: به هر حال عمومی است، پس متغیر سمت کاربر اشکالی ندارد.

ابزارک

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

نه. هر گفت‌وگو تا وقتی صفحه باز است ادامه دارد. چیزی در مرورگر بازدیدکننده ذخیره نمی‌شود و بازدیدکننده‌ها گفت‌وگوهای هم را نمی‌بینند.

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

بله، برای هر ابزارک یکی. هر صفحه یک ابزارک نشان می‌دهد، پس در هر بخش سایتتان کد ابزارک جدایی با data-workspace-id متفاوت بگذارید.

نه. ابزارک رویداد یا callback ندارد. در حالت درون‌صفحه‌ای می‌توانید گفت‌وگو را با کد خودتان نشان دهید یا پنهان کنید. حالت شناور و درون‌صفحه‌ای را ببینید.

پاسخ‌ها

عمداً. فقط از روی اسناد شما پاسخ می‌دهد تا پاسخی از خودش نسازد. اگر جواب سؤالی در اسناد نباشد، همین را می‌گوید.

هر پاسخ اسنادی را که به کار برده نام می‌برد و نشانه‌های شماره‌دار داخل متن، دقیقاً به همان بخش اشاره می‌کنند. ارجاع‌ها را ببینید.

متن‌های خود ابزارک فارسی و انگلیسی دارد (data-locale). پاسخ‌ها از روی اسناد شما نوشته می‌شوند، پس سؤال به زبان اسنادتان بهترین نتیجه را می‌دهد.

docs.faq.items.memory.a

راه‌اندازی

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

برای ابزارک: ۲۰ سؤال در ساعت برای هر نشانی IP، ۵۰۰ سؤال در روز برای هر اپ، و ۶۰ بار بارگذاری در ساعت برای هر نشانی IP. REST API بارگذاری فایل را به ۶۰ بار و پردازش دوباره را به ۳۰ بار در ساعت محدود می‌کند؛ بقیهٔ درخواست‌ها هنوز محدودیتی ندارند. محدودیت‌ها و هزینه را ببینید.

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

بله. REST API زیر /v1 است. هر تغییری که کد شما را خراب کند، در نسخهٔ تازه می‌آید و این مستندات دربارهٔ /v1 است.

قبلیرفع اشکال

در این صفحه

  • کلیدهای API
  • ابزارک
  • پاسخ‌ها
  • راه‌اندازی

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

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