شخصیت، تم و دستورات

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

شخصیت و لحن

شیء JSON شخصیت کوچک اما تأثیرگذار است:

{
    "name": "آریا",
    "tone": "دوستانه و مختصر"
}

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

راهنمای سیستم

راهنمای داخلی قبلاً ایمنی، زمینه‌یابی RAG، قالب‌بندی ارجاعات و دفاع در برابر تزریق راهنما را پوشش می‌دهد. فیلد system_prompt شما پس از راهنماهای داخلی اضافه می‌شود — از آن برای موارد زیر استفاده کنید:

• واژگان برند ("محصول ما را 'Pitchbar' بنامید، هرگز 'نوار پیچ'").
• رفتار تبدیل ("زمانی که بازدیدکننده درباره قیمت‌گذاری می‌پرسد، پیشنهاد ثبت تماس بدهید").
• راهنمایی‌های حوزه ("اگر درباره بازگشت کالا پرسیده شد، همیشه به بازه ۳۰ روزه اشاره کنید").

محافظ‌ها

بلوک guardrails در حال حاضر از موارد زیر پشتیبانی می‌کند:

پیام‌های شروع

تا شش گزینه پیشنهادی در اولین بار که بازدیدکننده ویجت را باز می‌کند، بالای ورودی ظاهر می‌شوند. پس از اولین نوبت ناپدید می‌شوند. آنها را زیر ۸۰ کاراکتر و با هدف تبدیل نگه دارید ("قیمت نسخه حرفه‌ای چقدر است؟"، "آیا آزمایش رایگان ارائه می‌دهید؟"، "می‌توانم با یک کارشناس صحبت کنم؟").

ظاهر

بلوک ظاهر، ظاهر ویجت را کنترل می‌کند:

{
    "primary": "#111827",
    "accent": "#10b981",
    "radius": 12,
    "position": "bottom-right",
    "launcher_label": "نیاز به کمک؟",
    "launcher_icon_url": "https://your-cdn.example.com/storage/agent-launcher-icons/abc.png",
    "default_open": true
}

• primary — رنگ پس‌زمینه دکمه راه‌انداز و حباب‌های پیام خروجی.
• accent — رنگ لینک‌ها، حلقه‌های فوکوس، نشان‌های ارجاع.
• radius — شعاع گوشه به پیکسل برای راه‌انداز و پنل.
• position — موقعیت ویجت. bottom-center (پیش‌فرض — قرص نوار همه‌کاره)، bottom-right (حباب شناور به سبک Intercom / Drift / Tawk در گوشه)، یا bottom-left (قرینه‌ی حالت راست، زمانی که لبه راست صفحه با ویجت‌های دیگر شلوغ است مفید است). از یک گروه رادیویی در صفحه سفارشی‌سازی قابل انتخاب است؛ در theme.position ذخیره می‌شود و ویجت آن را در زمان راه‌اندازی می‌خواند.
• launcher_label — متن روی قرص راه‌انداز بسته. رشته خالی = راه‌انداز فقط دایره‌ای.
• launcher_icon_url — یک تصویر سفارشی (PNG، JPG، WEBP، یا SVG، تا ۲۵۶ کیلوبایت) که به جای کره شیب‌دار بنفش پیش‌فرض نشان داده می‌شود. آن را از بخش راه‌انداز در صفحه سفارشی‌سازی آپلود کنید؛ فایل روی دیسک عمومی ذخیره شده و آدرس حل‌شده در اینجا ذخیره می‌شود. ویجت آن را به‌عنوان یک آواتار دایره‌ای به اندازه قرص راه‌انداز نمایش می‌دهد. برای حفظ کره پیش‌فرض خالی بگذارید.
• default_open — آیا پنل چت در اولین بار که بازدیدکننده فرود می‌آید به‌طور خودکار باز شود. برای سازگاری، پیش‌فرض true است. برای راه‌اندازی کمتر مزاحم، false تنظیم کنید (بازدیدکننده فقط قرص راه‌انداز را می‌بیند تا زمانی که روی آن ضربه بزند). ترجیح بازدیدکننده همیشه برنده است: هنگامی که بازدیدکننده نوار را به‌صورت دستی باز یا بسته کند، آن انتخاب بدون توجه به این پرچم، در بارگذاری‌های مجدد به خاطر سپرده می‌شود.

صفحه سفارشی‌سازی (/app/agents/{id}/customize) دارای پیش‌نمایش زنده است تا بتوانید تغییرات را قبل از انتشار مشاهده کنید.

آیکون راه‌انداز و دید

بخش راه‌انداز در صفحه سفارشی‌سازی، دو مورد اضافی را فراتر از تم رنگی نمایش می‌دهد:

• آیکون سفارشی — یک تصویر مربع (PNG/JPG/WEBP/SVG، ≤ ۲۵۶ کیلوبایت) آپلود کنید. در هر جایی که راه‌انداز نمایش داده می‌شود (آواتار قرص بسته، آواتار هدر پنل باز) جایگزین کره شیب‌دار پیش‌فرض می‌شود. فایل قبلی هنگام جایگزینی به‌طور خودکار حذف می‌شود، بنابراین یک فایل .png قدیمی زمانی که یک .webp آپلود می‌کنید، باقی نمی‌ماند. برای بازگشت به کره پیش‌فرض از حذف استفاده کنید.
• باز شدن خودکار در بارگذاری صفحه — کلیدی که به theme.default_open نگاشت می‌شود. وقتی روشن باشد، پنل چت در اولین بار که بازدیدکننده فرود می‌آید، به‌طور پیش‌فرض باز است. وقتی خاموش باشد، بازدیدکننده فقط قرص راه‌انداز را می‌بیند تا زمانی که روی آن ضربه بزند. در هر دو حالت، بازدیدکننده‌ای که نوار را به‌طور صریح می‌بندد (یا باز می‌کند)، ترجیح خود را برای آن مرورگر قفل می‌کند.

جذب مشتری قبل از چت

کلید جذب مشتری قبل از چت در صفحه سفارشی‌سازی (ستون require_lead_before_chat) سطح چت را پشت یک فرم نام + ایمیل قرار می‌دهد. بازدیدکننده به‌جای نوار همه‌کاره، فرم را می‌بیند؛ پس از ارسال، پنل چت در همان نصب بدون بارگذاری مجدد باز می‌شود.

• چرا از آن استفاده کنید. نرخ جذب بالاتر. بازدیدکننده هنوز برای دریافت پاسخ خود انگیزه دارد تا خود را شناسایی کند — همان الگویی که Intercom و Drift برای یک دهه استفاده کرده‌اند.
• چرا آن را خاموش بگذارید. اصطکاک. برای یک سایت مستندات یا یک صفحه بازاریابی عمومی که هدف آن پاسخ‌های سریع است، یک درگاه ایمیل بیشتر از اینکه به جذب کمک کند، به تعامل آسیب می‌زند.
• ماندگاری. هنگامی که یک بازدیدکننده جذب شد، درگاه در بازخوانی باز نمی‌گردد. /widget/init وجود یک Lead را در مکالمه بررسی کرده و state.leadCaptured را براساس آن تنظیم می‌کند.
• نقطه پایانی جذب. بدون تغییر — POST /v1/widget/leads همان نقطه پایانی است که فرم درون‌خطی وسط مکالمه استفاده می‌کند. درگاه فقط آن را زودتر فراخوانی می‌کند.

فیلدهای فرم جذب مشتری سفارشی

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

انواع فیلدهای پشتیبانی‌شده در نسخه v1:

• text، email، tel، textarea — ورودی‌های متنی یک خطی / چندخطی.
• select — منوی کشویی با لیستی از options.
• checkbox — معمولاً یک کلید "رضایت".

هر فیلد دارای یک key پایدار (حروف کوچک / زیرخط)، یک label قابل مشاهده برای بازدیدکننده، یک پرچم required اختیاری، یک placeholder اختیاری و یک maxlength اختیاری برای فیلدهای نوع متن است.

کلیدهای رزرو شده. email، name و phone رزرو شده‌اند — زمانی که ویجت فرم را ارسال می‌کند، آن مقادیر مستقیماً در ستون‌های Lead منطبق قرار می‌گیرند تا پرس‌وجوهای تحلیل موجود روی email / name / phone همچنان کار کنند. هر چیز دیگری در ستون JSON fields Lead قرار می‌گیرد.

سازگاری با نسخه‌های قبلی. اگر lead_form_fields تهی باشد (پیش‌فرض برای دستیاران فروش موجود)، ویجت به شکل قدیمی نام + ایمیل بازمی‌گردد — بدون نیاز به مهاجرت داده‌های موجود، بدون شکست برای مکالمات در حال انجام.

همان ساختار در هر دو نقطه نصب نمایش داده می‌شود. فرم جذب مشتری وسط مکالمه ویجت (زمانی که هوش مصنوعی lead_prompt را مطرح می‌کند) و درگاه قبل از چت (زمانی که require_lead_before_chat روشن است) هر دو از همان لیست فیلدها استفاده می‌کنند، بنابراین خریداری که یک فرم ۵ فیلدی می‌سازد، دقیقاً همان شکل را بدون توجه به نحوه باز شدن فرم می‌بیند.

پیش‌تنظیم‌ها. سازنده دارای چهار نقطه شروع است: کلاسیک (نام + ایمیل)، B2B SaaS (نام + ایمیل کاری + شرکت + اندازه تیم)، پشتیبانی (ایمیل + شناسه سفارش + دسته‌بندی موضوع)، سازگار با GDPR (ایمیل + چک‌باکس رضایت). "بازنشانی به پیش‌فرض" سفارشی‌سازی را حذف کرده و به حالت تهی / نام + ایمیل بازمی‌گردد.

محدودیت‌ها: تا ۱۲ فیلد در هر دستیار فروش، برچسب هر فیلد تا ۱۲۰ کاراکتر، هر انتخاب تا ۲۴ گزینه، هر متن/متن‌ناحیه تا ۴۰۰۰ کاراکتر.

زبان

language_default زبان پاسخ دستیار فروش را قفل می‌کند. هر محلی که از lang/*.json به‌طور خودکار تشخیص داده شود را می‌پذیرد — Pitchbar ۱۳۲ زبان را به‌صورت پیش‌فرض ارائه می‌دهد (انگلیسی، اسپانیایی، فرانسوی، ترکی به‌طور کامل ترجمه شده‌اند؛ بقیه دارای بخش‌های اصلی ترجمه شده هستند و در صورت عدم پوشش به انگلیسی بازمی‌گردند). زمانی که این فیلد خالی باشد، دستیار فروش از هدر Accept-Language مرورگر بازدیدکننده پیروی می‌کند و در صورت عدم تطابق هیچ‌کدام از گزینه‌ها، به انگلیسی بازمی‌گردد.

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

آستانه اطمینان

یک عدد ۰ تا ۱ که رفتار "نمی‌دانم" را کنترل می‌کند. برای راهنمایی تنظیم به دستیاران فروش مراجعه کنید — اما نسخه کوتاه: برای Cloudflare bge-base کمتر، برای OpenAI embeddings بیشتر، و پس از هر تغییر، گزارش شکاف تحلیل‌ها را بررسی کنید.