مفاهیم اصلی

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

فضای کاری

هر داده در Pitchbar دقیقاً به یک فضای کاری تعلق دارد. کاربران می‌توانند عضو چندین فضای کاری باشند و بین آنها جابه‌جا شوند؛ دستیاران فروش، مکالمات، مشتریان، منابع و تحلیل‌ها هرگز از مرزها عبور نمی‌کنند.

فضاهای کاری توسط ویژگی Eloquent BelongsToWorkspace اعمال می‌شود که یک محدوده سراسری برای فیلتر کردن هر پرس‌وجو براساس فضای کاری فعلی اضافه می‌کند. یک تست بازگشتی (MultiTenancyTest) وجود دارد که اگر یک مدل محدود به فضای کاری بدون آن پرس‌وجو شود، ساخت را با شکست مواجه می‌کند.

دستیار فروش

یک دستیار فروش واحدی است که نصب می‌کنید. شامل شخصیت، راهنمای سیستم، ظاهر، پیام‌های شروع، دامنه‌های مجاز، قوانین رفتار و — مهمتر از همه — منابع دانش خود است. یک فضای کاری می‌تواند دستیاران فروش زیادی داشته باشد (مثلاً یکی برای سایت بازاریابی، یکی برای مرکز راهنما).

دستیاران فروش دارای دو حالت پیش‌نویس و منتشر شده هستند. زمان اجرای ویجت همیشه نسخه منتشر شده را می‌خواند، بنابراین می‌توانید آزادانه ویرایش کنید بدون اینکه بر بازدیدکنندگان زنده تأثیر بگذارید. هر انتشار یک ردیف agent_version غیرقابل تغییر ایجاد می‌کند که می‌توانید به آن بازگردید.

منبع دانش

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

برای جریان دریافت به منابع دانش و برای نحوه بازیابی به مسیر RAG مراجعه کنید.

مکالمه

یک مکالمه یک رشته گفتگو بین یک بازدیدکننده و یک دستیار فروش است. در بارگذاری مجدد صفحه باقی می‌ماند — زمانی که ویجت در عرض ۲۴ ساعت دوباره راه‌اندازی شود، به‌جای شروع یک مکالمه جدید، جدیدترین مکالمه را ادامه می‌دهیم. پیام‌ها دارای نقش‌های user، assistant و human-agent هستند (زمانی که یک اپراتور از صندوق ورودی مکالمه را تحویل می‌گیرد).

مشتری بالقوه

یک مشتری بالقوه بازدیدکننده‌ای است که اطلاعات تماس شما را ثبت کرده است (نام، ایمیل، تلفن، به علاوه هر فیلد سفارشی که تعریف کرده‌اید). ویجت زمانی که مکالمه به آستانه‌ای از قصد می‌رسد، این اطلاعات را درخواست می‌کند — مشاهده کنید صدا، مشتریان و ماندگاری. مشتریان براساس ایمیل در هر دستیار فروش حذف تکراری می‌شوند تا یک نفر که دو بار فرم را پر می‌کند، دو ردیف ایجاد نکند.

پلن

پلن‌ها سطوح اشتراکی هستند که توسط مدیران پلتفرم مدیریت می‌شوند (رایگان، حرفه‌ای و غیره). هر پلن یک سهمیه مکالمات ماهانه و یک بلوک قابلیت‌ها تعریف می‌کند — در حال حاضر features.remove_branding تنها پرچم است، اما ساختار آن باز است. پلن‌ها به‌طور خودکار به‌عنوان محصولات و قیمت‌ها به Stripe همگام‌سازی می‌شوند، بنابراین مدیران هرگز با داشبورد Stripe سروکار ندارند.

مسیر اصلی

"مسیر اصلی" به معنای مسیر پیام بازدیدکننده تا اولین توکن است. دارای هدف تأخیر سخت ۱ ثانیه p95 است — بدون نوشتن در پایگاه داده، بدون وب‌هوک همزمان، بدون تلاش مجدد. مسیر توکن‌ها را پخش می‌کند، سپس کارهای ماندگاری و تحلیل را به‌صورت ناهمگام پس از اتمام جریان ارسال می‌کند. مشاهده کنید مسیر اصلی و تأخیر.

لیست دامنه‌های مجاز

اسکریپت ویجت عمومی است — هر کسی که data-agent-id شما را پیدا کند، می‌تواند آن را در سایت خود بچسباند. نقطه پایانی /v1/widget/init یک لیست دامنه مجاز سخت در هر دستیار فروش اعمال می‌کند: لیست خالی همه‌جا را رد می‌کند، در غیر این صورت تطابق دقیق scheme://host بدون استنباط زیردامنه. دامنه‌های مجاز قوانین را دارد.

مدیر ارشد در مقابل عضو فضای کاری

یک عضو فضای کاری، سطح مشتری را می‌بیند (/dashboard، /app/agents، /app/inbox، /app/billing). یک مدیر ارشد علاوه بر آن، کنسول پلتفرم را در /admin برای مدیریت پلن‌ها، مشاهده مصرف، اجرای مجدد وظایف ناموفق و ورود به حساب مشتریان برای پشتیبانی می‌بیند. پرچم آن users.role = SuperAdmin است و توسط میان‌افزار EnsureSuperAdmin محافظت می‌شود (که ۴۰۴ برمی‌گرداند، نه ۴۰۳، تا پنل وجود خود را فاش نکند).