P Pitchbar مستندات

ساخت دستیار فروش

قوانین رفتاری و تریگرها

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

ساختار یک قانون

هر قانون یک ردیف در behavior_rules با سه بخش است:

  • نوع — نوع قانون. در حال حاضر: cta (فراخوان)، lead_capture (جذب مشتری)، route (مسیریابی)، curated (پاسخ دستی).
  • شرایط — JSON که زمان اجرای قانون را مشخص می‌کند (کلمات کلیدی قصد، تطابق آدرس صفحه، عمق اسکرول، زمان بیکاری، تعداد پیام‌ها).
  • اقدام — JSON که مشخص می‌کند چه کاری انجام شود (نمایش کارت فراخوان، درخواست ایمیل، مسیریابی به اپراتور، بازگرداندن متن دستی).

قوانین همچنین دارای فیلدهای enabled (روشن/خاموش) و priority (اولویت) هستند. وقتی چندین قانون مطابقت داشته باشند، اولویت بالاتر برنده است. قوانین غیرفعال برای سابقه نگهداری می‌شوند، نه حذف.

ویرایش قوانین

مسیر /app/agents/{id}/behavior را باز کنید. فرم یک سازنده‌ی آگاه از نوع است — نوع را انتخاب کنید، شرایط و اقدام را پر کنید و ذخیره کنید. تا ۲۰ قانون فعال در زمان راه‌اندازی در ویجت بارگذاری می‌شوند؛ بیش از آن در زمان اجرا نادیده گرفته می‌شوند (بنابراین لیست غیرفعال‌ها را دوره‌ای پاک‌سازی کنید).

محرک‌ها (سمت بازدیدکننده)

ویجت سیگنال‌های سبک را برای اجرای قوانین بدون اینکه بازدیدکننده چیزی بگوید، ردیابی می‌کند:

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

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

فراخوان‌ها

یک اقدام فراخوان، یک کارت در داخل پنل چت با عنوان، توضیحات و یک یا دو دکمه نمایش می‌دهد. دکمه‌ها می‌توانند:

  • آدرس را باز کنند در یک زبانه‌ی جدید.
  • پیام ارسال کنند به‌گونه‌ای که انگار بازدیدکننده آن را تایپ کرده است.
  • مشتری جذب کنند (فرم جذب مشتری را باز کنند).
  • رد کنند.

فراخوان‌ها را در /app/agents/{id}/ctas مدیریت کنید. آنها به‌عنوان قوانین رفتار با kind=cta ذخیره می‌شوند، اما رابط کاربری اختصاصی آن از ویرایشگر خام قانون کاربرپسندتر است.

پاسخ‌های دستی

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

  • سوالات قیمت‌گذاری که می‌خواهید اعداد دقیق باشند و هرگز بازنویسی نشوند.
  • متون حقوقی/بازپرداخت که باید کلمه به کلمه باشند.
  • "چگونه با پشتیبانی تماس بگیرم؟" که می‌خواهید مسیریابی را کنترل کنید.

آنها را در /app/agents/{id}/curated مدیریت کنید. هر ورودی دارای لیستی از عبارات محرک، پاسخ آماده و یک منبع اختیاری است. در زمان اجرا، دستیار فروش متن دستی را توکن به توکن پخش می‌کند تا رفتار هوش مصنوعی را شبیه‌سازی کند — بازدیدکنندگان یک ظاهر ناگهانی و ناهماهنگ نمی‌بینند.

قوانین جذب مشتری

یک قانون lead_capture فرم جذب مشتری را فعال می‌کند. محرک‌های رایج:

  • پس از N نوبت پیام (قصد بازدیدکننده واقعی به نظر می‌رسد).
  • زمانی که اطمینان پایین تشخیص داده شود ("ما پیگیری می‌کنیم").
  • در قصد خروج ("قبل از رفتن…").

فیلدهای فرم قابل تنظیم هستند — نام، ایمیل، تلفن و هر فیلد سفارشی که تعریف کرده‌اید. مشاهده کنید صدا، مشتریان و ماندگاری برای جریان سمت بازدیدکننده.

قوانین مسیریابی

یک قانون route به یک اپراتور انسانی اعلان می‌دهد. از آن برای ارجاع زمانی استفاده کنید که:

  • بازدیدکننده به‌صراحت درخواست اپراتور می‌کند.
  • اطمینان از آستانه‌ای پایین‌تر می‌رود.
  • مکالمه به یک پیچیدگی خاص می‌رسد (پیام‌های طولانی، چندین موضوع بی‌پاسخ).

مسیر در /app/inbox به‌عنوان یک رشته‌ی خوانده‌نشده ظاهر می‌شود؛ یک اپراتور می‌تواند آن را تصاحب کرده و به‌صورت درون‌خطی ادامه دهد. مشاهده کنید صندوق ورودی و تحویل انسانی.

آزمایش‌ها

قوانین رفتار را می‌توان به‌صورت A/B آزمایش کرد. صفحه‌ی آزمایش‌ها (/app/agents/{id}/experiments) به شما امکان می‌دهد ترافیک را بین دو نوع قانون تقسیم کنید و تغییرات تبدیل را مشاهده کنید. تقسیم‌بندی براساس هر بازدیدکننده است، نه هر مکالمه — وقتی یک بازدیدکننده در یک گروه قرار گرفت، تا پایان عمر مکالمه در همان گروه باقی می‌ماند.

زبان خود را انتخاب کنید