مستندات استفاده از گفت‌بان

آنچه در نمای کلی می‌بینید

چک‌لیست تأیید ایمیل، انتشار دانش، ثبت دامنه و تشخیص نصب تگ در بالای داشبورد قرار دارد. تعداد گفتگو و پیام، مصرف دوره، موارد خوانده‌نشده، ارجاع انسانی، خطای پاسخ، رضایت، هزینه تخمینی AI و آخرین گفتگوها نیز همان‌جا خلاصه می‌شوند.

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

در صفحه «دستیار من» نامی را انتخاب کنید که مشتری آن را به‌عنوان نماینده رسمی کسب‌وکار بشناسد. پیام خوش‌آمدگویی کوتاه باشد و دقیقاً بگوید دستیار در چه موضوعاتی کمک می‌کند.

• رنگ برند باید با فرمت شش‌رقمی مانند #6D3DF5 باشد.
• هر دامنه را به‌صورت Origin کامل، بدون مسیر وارد کنید؛ مانند https://shop.example.com.
• دامنه HTTP فقط برای توسعه محلی مناسب است؛ محیط واقعی باید HTTPS باشد.
• انتقال به اپراتور و دریافت اطلاعات سرنخ را می‌توان جداگانه فعال یا غیرفعال کرد.

فایل دانش منبع اطلاعات واقعی دستیار است. محصولات، قوانین، قیمت‌ها، زمان‌بندی، شرایط مرجوعی، محدوده خدمات و راه‌های تماس را با عنوان‌های روشن جدا کنید. فایل تا ۵۰۰ کیلوبایت پذیرفته می‌شود و هر انتشار نسخه مستقل دارد.

# معرفی کسب‌وکار
فروشگاه نمونه عرضه‌کننده محصولات دیجیتال است.

## ارسال
- سفارش‌های تهران طی ۲ روز کاری ارسال می‌شوند.
- هزینه ارسال پیش از پرداخت نمایش داده می‌شود.

## مرجوعی
مشتری تا ۷ روز پس از تحویل می‌تواند درخواست مرجوعی ثبت کند.

## ارتباط با پشتیبانی
- ایمیل: support@example.com
- ساعت پاسخ‌گویی: شنبه تا چهارشنبه، ۹ تا ۱۷

اصول نوشتن دانش باکیفیت

• هر موضوع را زیر یک Heading مشخص قرار دهید.
• اطلاعات متناقض یا تاریخ‌گذشته را پیش از انتشار حذف کنید.
• قیمت، محدودیت و زمان را دقیق بنویسید؛ دستیار اجازه حدس‌زدن ندارد.
• مسیر ارجاع انسانی و اطلاعات تماس را حتماً درج کنید.
• پس از انتشار چند سؤال واقعی را در بخش تست امتحان کنید.

گفت‌بان سند را به بخش‌های کوچک تقسیم می‌کند و فقط قسمت‌های مرتبط با سؤال فعلی را به AI می‌دهد. بنابراین کل فایل در هر درخواست ارسال نمی‌شود. هر انتشار یک نسخه مستقل می‌سازد؛ از فهرست نسخه‌ها می‌توانید نسخه قبلی را دوباره منتشر کنید.

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

پاسخ‌های آماده از «دستیار من» قابل ویرایش، غیرفعال‌سازی، فعال‌سازی و حذف هستند. هر تغییر در FAQ کش پاسخ همان دستیار را پاک می‌کند تا اطلاعات قبلی باقی نماند.

هر پاسخ تأییدشده یک سیگنال یادگیری است. گفت‌بان از این سیگنال‌ها متن کامل FAQ را کپی نمی‌کند؛ فقط الگوهای پایدارِ لحن، ساختار، واژگان، رفع ابهام و شرایط ارجاع را در یک پروفایل کوتاه ادغام می‌کند.

• پروفایل برای هر کسب‌وکار کاملاً جداست.
• حجم آن سقف مشخص دارد تا پرامپت کند و گران نشود.
• هر بهینه‌سازی نسخه جدید می‌سازد و نسخه‌های قبلی قابل بازگشت‌اند.
• اطلاعات واقعی مانند قیمت و موجودی همچنان فقط از دانش و FAQ بازیابی می‌شوند.
• پاسخ خام AI بدون تأیید مدیر به دانش دائمی تبدیل نمی‌شود.

از بخش «نصب در سایت» تگ تولیدشده برای حساب خود را کپی کنید. کلید عمومی هر دستیار متفاوت است.

<script async
  src="https://support.example.com/widget.js?key=agt_YOUR_PUBLIC_KEY"
  data-agent-key="agt_YOUR_PUBLIC_KEY">
</script>

1. دامنه سایت را دقیقاً در دامنه‌های مجاز ثبت کنید.
2. تگ را یک‌بار در قالب اصلی سایت و نزدیک انتهای body قرار دهید.
3. کش سایت یا CDN را پاک کنید.
4. صفحه را از همان دامنه باز و دکمه گفتگو را آزمایش کنید.

درخواست فایل ویجت باید Referer معتبر داشته باشد. پس از تأیید دامنه، سرور یک توکن HMAC کوتاه‌عمر برای iframe صادر می‌کند؛ کلید عمومی به‌تنهایی اجازه ارسال پیام نمی‌دهد.

تجربه مشتری داخل ویجت

• تاریخچه همان گفتگو برای بازدیدکننده حفظ و به‌روزرسانی می‌شود.
• در صورت فعال‌بودن انتقال انسانی، مشتری می‌تواند اپراتور درخواست کند.
• در صورت فعال‌بودن دریافت سرنخ، نام، ایمیل یا تلفن با رضایت مشتری ثبت می‌شود.
• مشتری می‌تواند کیفیت گفتگو را از ۱ تا ۵ امتیاز دهد.
• پاسخ‌های جدید اپراتور، ویرایش و حذف پیام در همان ویجت همگام می‌شوند.

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

فهرست گفتگوها و گزارش‌ها را می‌توانید بر اساس بازه زمانی، متن پیام، وضعیت باز یا بسته، اولویت، مسیر AI/انسان، رضایت و مسئول گفتگو فیلتر کنید. پیش‌نویس پاسخ و یادداشت هر گفتگو نیز جداگانه در مرورگر نگهداری می‌شود.

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

فیلترهای بازه، وضعیت، اولویت، مسیر پاسخ، رضایت، اپراتور و جست‌وجوی متن هم‌زمان روی فهرست، KPIها و خروجی CSV اعمال می‌شوند.

نمای سریع مدیر

• کل، باز، خوانده‌نشده و ارجاع‌های انسانی
• رضایت و زمان اولین پاسخ
• کل سؤال‌های قابل تحلیل، موضوع‌های پرتکرار و نرخ پاسخ خودکار
• پوشش پاسخ قطعی، شکاف دانش، سؤال‌های بدون پاسخ و هزینه AI
• هشدارهای قابل اقدام و عملکرد تخصیص تیم

تحلیل عمیق سؤال

بیان‌های مشابه مانند «هزینه ارسال چقدره؟» و «ارسال رایگانه؟» در یک موضوع گروه‌بندی می‌شوند و پیام‌های صرفاً سلام، تشکر و تأیید کوتاه در تحلیل سؤال وارد نمی‌شوند. با بازکردن هر موضوع، شکل‌های مختلف سؤال، نمونه گفتگوها، منبع پاسخ، رضایت، ارجاع، زمان پاسخ و هزینه را می‌بینید و می‌توانید همان‌جا پاسخ قطعی بسازید.

گزارش بین «تطابق قطعی» و «FAQ مرتبط» تفاوت می‌گذارد: فقط تطابق قطعی مستقیماً بدون AI پاسخ می‌دهد؛ FAQ مشابه صرفاً برای ساخت پاسخ بهتر بازیابی می‌شود. منبع هر پاسخ نیز با یکی از حالت‌های FAQ، حافظه، AI، اپراتور یا سیستم ثبت می‌شود.

دعوت‌نامه هفت روز اعتبار دارد و فقط حسابی که با همان ایمیل وارد شده است می‌تواند آن را بپذیرد.

هر پلن سقف پیام ماهانه، تعداد دامنه و بودجه AI مستقل دارد. پاسخ قطعی FAQ هزینه AI ندارد اما به‌عنوان یک تعامل قابل گزارش ثبت می‌شود. پرداخت موفق فقط پس از Verify سمت سرور پلن را فعال می‌کند.

• کاهش پلن در پایان دوره جاری اعمال می‌شود.
• لغو تمدید، دسترسی دوره پرداخت‌شده را زودتر قطع نمی‌کند.
• در پایان بودجه یا سهمیه، ویجت پاسخ مناسب نشان می‌دهد و مصرف بیشتر متوقف می‌شود.
• تاریخچه سفارش و شناسه مرجع در بخش صورتحساب باقی می‌ماند.

در بخش «پروفایل و سازمان» نام نمایشی و تصویر کاربر را تنظیم کنید. تصویر کاربر کنار فعالیت‌های همان عضو و لوگوی سازمان در داشبورد و پیام‌های پشتیبانی نمایش داده می‌شود.

• فرمت‌های PNG، JPG، WEBP و GIF پذیرفته می‌شوند.
• حداکثر حجم تصویر در رابط کاربری ۱٫۴ مگابایت است.
• هر کاربر می‌تواند نام و تصویر خودش را تغییر دهد.
• فقط مالک یا مدیر می‌تواند لوگوی سازمان را تغییر یا حذف کند.

• نشست مشتری در کوکی HttpOnly با اعتبار ۳۰ روز و نشست مدیر پلتفرم در کوکی مستقل ۱۲ ساعته نگهداری می‌شود.
• ورود دومرحله‌ای TOTP، کدهای بازیابی یک‌بارمصرف و لغو نشست دستگاه‌ها در بخش امنیت قرار دارند.
• توکن‌های ویجت امضاشده و کوتاه‌عمر هستند و iframe فقط در Origin مجاز باز می‌شود.
• Rate limit مشترک PostgreSQL و Turnstile اختیاری از مسیرهای عمومی محافظت می‌کنند.
• مالک می‌تواند خروجی داده بگیرد یا حساب را با تأیید رمز و نام سازمان حذف کند.
• سیاست نگهداری داده در عملیات روزانه سرور اعمال می‌شود.

لینک بازیابی رمز ۳۰ دقیقه و لینک تأیید ایمیل ۲۴ ساعت اعتبار دارد. خروجی کامل اطلاعات فقط برای مالک در قالب JSON قابل دریافت است و شامل تنظیمات دستیار، اعضا، گفتگوها، پیام‌ها، صورتحساب و رویدادهای حساب می‌شود.