کتابچه راهنمای تصویری گام به گام

اسناد sem.chat

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

هیچ راهنمای منطبقی یافت نشد. یک کلمه کلیدی کوتاه‌تر مانند ویجت، API، صدا، صورت‌حساب، webhook، WordPress، SendPulse یا زمان‌بندی را امتحان کنید.
یادداشت اسکرین‌شات: همه تصاویر این راهنما از برنامه واقعی sem.chat و با یک فضای کاری نمایشی گرفته شده‌اند. جزئیات حساس حساب، داده‌های مشتری، کلیدهای API، اطلاعات پرداخت و محتوای گفتگوهای خصوصی پیش از انتشار پوشانده می‌شوند.
01

شروع به کار

حساب را ایجاد کنید، ورود را تمام کنید، داشبورد را درک کنید، اولین ربات را ایجاد کنید، آن را به صورت خصوصی آزمایش کنید، آن را نصب کنید و طرح مناسب را انتخاب کنید.

/authثبت نام، آزمایشی و اولین ربات
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1با ثبت نام یا ورود از سایت یا برنامه عمومی شروع کنید.
2قبل از تکیه بر اعلان‌ها یا پیام‌های صورت‌حساب، آدرس ایمیل را تأیید کنید.
3برای ایجاد اولین ربات قبل از باز کردن داشبورد از onboarding استفاده کنید.
/نمای کلینمای کلی پس از ورود به سیستم
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1از اقدامات سریع برای ایجاد ربات، مشاهده ربات ها، باز کردن تجزیه و تحلیل یا مدیریت صورتحساب استفاده کنید.
2قبل از ایجاد تغییرات، ربات‌های فعال، conversations، دقایق صوتی و میزان رضایت را مرور کنید.
3بعد از هر تست راه اندازی، فعالیت اخیر را بررسی کنید.
اولین راه اندازی

ثبت نام کنید، آزمایشی را شروع کنید و داشبورد را درک کنید

این برای چیست: از این گردش کار برای یک فضای کاری کاملاً جدید یا هنگام سوار شدن به یک هم تیمی که هرگز از sem.chat استفاده نکرده است، استفاده کنید.

قبل از شروع
  • از یک ایمیل تجاری استفاده کنید که می تواند ایمیل های تأیید و صدور صورت حساب را دریافت کند.
  • قبل از دعوت از بقیه تیم، تصمیم بگیرید که چه کسی باید صاحب فضای کاری باشد.
  • یک وب سایت آزمایشی یا صفحه مرحله بندی ایمن را برای نصب ویجت آماده نگه دارید.
1

صفحه ثبت نام برنامه را باز کنید

به برنامه بروید.sem.chat/auth از دکمه ورود به وب سایت / ثبت نام.

نتیجه مورد انتظار: صفحه احراز هویت گزینه های ورود به سیستم و ایجاد حساب را نشان می دهد.
2

حساب کاربری را ایجاد کنید

ایمیل کسب و کار را وارد کنید، رمز عبور را ایجاد کنید و فرم ثبت نام را ارسال کنید.

نتیجه مورد انتظار: برنامه درخواست تأیید می‌کند یا پس از پذیرفته شدن حساب وارد سیستم می‌شود.
3

ایمیل را تایید کنید

ایمیل تأیید را باز کنید و روی پیوند تأیید کلیک کنید.

نتیجه مورد انتظار: این حساب می‌تواند پیام‌های صورت‌حساب، دعوت، گزارش و هشدار را دریافت کند.
4

ورود کامل

نام کسب و کار را وارد کنید، هدف دستیار را توصیف کنید، رنگ شروع را انتخاب کنید و اولین ربات را ایجاد کنید.

نتیجه مورد انتظار: فضای کاری با پیش نویس ربات و حالت آزمایشی فعال باز می شود.
5

نمای کلی را باز کنید

روی نمای کلی در نوار کناری سمت چپ کلیک کنید.

نتیجه مورد انتظار: داشبورد کارت های usage، اقدامات سریع و فعالیت اخیر را نشان می دهد.
6

اقدام بعدی را انتخاب کنید

از Create New Bot برای راه‌اندازی، مشاهده همه ربات‌ها برای مدیریت، Analytics برای عملکرد یا صورت‌حساب برای محدودیت‌های طرح استفاده کنید.

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

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

تست پرتاب خصوصی

قبل از پخش زنده، اولین تست ربات خصوصی را ایجاد کنید

این برای چیست: قبل از اینکه مشتریان دستیار را ببینند، از این برای تأیید ردیابی حساب، ربات، ویجت و سابقه استفاده کنید.

قبل از شروع
  • یک نمونه سوال مشتری آماده داشته باشید.
  • یک صفحه مرحله بندی یا صفحه آزمایشی HTML محلی آماده داشته باشید.
  • در اولین آزمایش از داده های واقعی مشتری استفاده نکنید.
1

باز کردن My Bots

روی My Bots در نوار کناری کلیک کنید یا از View All Bots from Overview استفاده کنید.

نتیجه مورد انتظار: با دکمه New Bot می‌توانید ربات ایجاد شده در حین ورود یا حالت خالی را ببینید.
2

سازنده ربات را باز کنید

روی New Bot یا Edit روی ربات موجود کلیک کنید.

نتیجه مورد انتظار: Bot Builder با کنترل‌های Basics، Widget، Knowledge، Voice و یکپارچه‌سازی باز می‌شود.
3

یک بار ربات را ذخیره کنید

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

نتیجه مورد انتظار: ربات یک شناسه معتبر دریافت می کند و می تواند کد جاسازی را ایجاد کند.
4

پیش نمایش خصوصی

از پنل پیش نمایش استفاده کنید و نمونه سوال خود را بپرسید.

نتیجه مورد انتظار: پاسخ باید با دستورالعمل های شما مطابقت داشته باشد یا نشان دهد که چه دانشی از دست رفته است.
5

نصب روی استیجینگ

Embed را باز کنید، قطعه HTML را کپی کنید و آن را قبل از بسته شدن برچسب بدنه در صفحه مرحله بندی جایگذاری کنید.

نتیجه مورد انتظار: ویجت در گوشه پیکربندی شده روی دسکتاپ و موبایل ظاهر می شود.
6

ردیابی را تایید کنید

Inbox یا Chat History را بعد از مکالمه آزمایشی باز کنید.

نتیجه مورد انتظار: مکالمه آزمایشی با تاریخچه ربات، کانال و پیام صحیح ظاهر می شود.
نحوه تست کردن: در صورت فعال بودن صدا، یک پیام متنی و یک تست صوتی ارسال کنید. تأیید کنید که هر دو در Chat History ظاهر شوند.
مشکلرفع کنید
کد جاسازی در دسترس نیستابتدا ربات را ذخیره کنید. اگر همگام‌سازی صوتی هنوز در حالت تعلیق است، منتظر همگام‌سازی بمانید یا پس از تکمیل فیلدهای ضروری دوباره ذخیره کنید.
ویجت ربات اشتباهی را نشان می دهدتأیید کنید data-bot-id در قطعه با شناسه ربات از Embed modal مطابقت دارد.
هیچ مکالمه ای در تاریخ ظاهر نمی شودChat History را بازخوانی کنید، فعال بودن ربات را تأیید کنید و مطمئن شوید که آزمایش در ویجت نصب شده انجام شده است، نه یک صفحه قدیمی.

بعد چه باید کرد: به آموزش راه اندازی و دانش Bot Builder بروید.

02

ایجاد و پیکربندی یک ربات

ساخت، ویرایش، پیش نمایش، فعال کردن، انتقال یا حذف ربات ها از My Bots و Bot Builder.

/داشبوردمرکز کنترل My Bots
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1برای شروع یک دستیار جدید روی New Bot کلیک کنید.
2از ویرایش، جاسازی، انتقال، فعال کردن یا حذف در هر کارت ربات استفاده کنید.
3قبل از آزمایش وضعیت فعال و آخرین زمان به‌روزرسانی را بررسی کنید.
/bots/:id/editبرگه Bot Builder اصول اولیه
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1نام ربات، آواتار، اولین پیام و دستورالعمل های سیستم را پر کنید.
2برای تست قبل از انتشار از پیش نمایش استفاده کنید.
3قبل از کپی کد جاسازی، ذخیره و همگام سازی کنید.
ایجاد ربات

ایجاد یک ربات جدید از My Bots

این برای چیست: هنگامی که یک نام تجاری، وب سایت، صف پشتیبانی یا کمپین جدید به دستیار خود نیاز دارد، از این گردش کار استفاده کنید.

قبل از شروع
  • نام ربات، هدف، اولین پیام و دو یا سه نمونه سوال را آماده کنید.
  • اگر قصد وارد کردن محتوا را دارید، وب سایت عمومی URL را جمع آوری کنید.
  • تأیید کنید که این طرح به تعداد ربات‌ها و ویژگی‌های صوتی/آواتار مورد نیاز شما اجازه می‌دهد.
1

باز کردن My Bots

روی My Bots در نوار کناری کلیک کنید.

نتیجه مورد انتظار: ربات های موجود و دکمه New Bot قابل مشاهده هستند.
2

روی New Bot کلیک کنید

یک ربات جدید از صفحه My Bots راه اندازی کنید.

نتیجه مورد انتظار: Bot Builder با دستیار پیش نویس باز می شود.
3

تنظیم هویت ربات

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

نتیجه مورد انتظار: پانل پیش نمایش نام دستیار، آواتار و تبریک را منعکس می کند.
4

دستورالعمل های سیستم را بنویسید

توضیح دهید که ربات چه کاری باید انجام دهد، چگونه باید صحبت کند، از چه چیزی باید اجتناب کند و چه زمانی باید از انسان کمک بخواهد.

نتیجه مورد انتظار: دستیار قبل از افزودن دانش، قوانین رفتاری واضحی دارد.
5

دانش پایه را اضافه کنید

اطلاعات ضروری شرکت، محصول، پشتیبانی، قیمت و تماس را در حوزه دانش قرار دهید.

نتیجه مورد انتظار: ربات می تواند بدون نیاز به وارد کردن وب سایت، به سؤالات رایج پاسخ دهد.
6

ربات را ذخیره کنید

روی ذخیره کلیک کنید و منتظر تایید ذخیره شده یا همگام سازی شده باشید.

نتیجه مورد انتظار: ربات دارای یک شناسه پایدار است، پیش‌نمایش قابل آزمایش است و گزینه‌های جاسازی در دسترس می‌شوند.
7

پیش نمایش نتیجه

نمونه سوالات آماده شده را در Preview بپرسید.

نتیجه مورد انتظار: پاسخ ها باید دستورالعمل ها را دنبال کنند و از دانشی که وارد کرده اید استفاده کنند.
8

فقط در صورت آماده بودن فعال شود

پس از گذراندن آزمون خصوصی، ربات را فعال کنید.

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

بعد چه باید کرد: تنظیمات ویجت را پیکربندی کنید، دانش وب سایت را اضافه کنید، سپس ربات را نصب کنید.

ربات ها را مدیریت کنید

یک ربات را ویرایش، شبیه سازی، انتقال، غیرفعال کردن یا حذف کنید

این برای چیست: زمانی که ربات به به‌روزرسانی، تغییرات مالکیت، توقف موقت یا حذف دائمی نیاز دارد، از این گردش کار استفاده کنید.

قبل از شروع
  • هر مکالمه یا داده تماسی را که باید قبل از حذف ربات نگه دارید صادر کنید.
  • قبل از حذف یا انتقال، تأیید کنید که ربات در یک وب سایت زنده تعبیه نشده است.
  • قبل از غیرفعال کردن ربات تولیدی به هم تیمی ها بگویید.
1

باز کردن My Bots

کارت ربات را با نام یا وضعیت پیدا کنید.

نتیجه مورد انتظار: کارت وضعیت فعلی و اقدامات موجود را نشان می دهد.
2

روی Edit کلیک کنید

سازنده ربات را باز کنید و تغییرات مورد نیاز را انجام دهید.

نتیجه مورد انتظار: ویرایشگر پیکربندی فعلی را بارگیری می کند.
3

ذخیره و دوباره تست کنید

پس از هر تغییر مواد روی ذخیره کلیک کنید، سپس سوالات پیش نمایش را اجرا کنید.

نتیجه مورد انتظار: پیکربندی ذخیره شده توسط ویجت پیش نمایش و نصب شده استفاده می شود.
4

غیرفعال کردن موقت

اگر ربات باید فعلاً بازدیدکنندگان را متوقف کند، از کلید فعال استفاده کنید.

نتیجه مورد انتظار: ربات با حفظ پیکربندی، سرویس ترافیک زنده را متوقف می کند.
5

انتقال مالکیت

از انتقال استفاده کنید، ایمیل گیرنده را وارد کرده و تأیید کنید.

نتیجه مورد انتظار: حساب انتخابی بر اساس جریان انتقال برنامه، مالکیت را دریافت می کند.
6

حذف فقط پس از بررسی

از Delete استفاده کنید، اخطار را بخوانید و فقط زمانی که دیگر به ربات نیازی ندارید تأیید کنید.

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

بعد چه باید کرد: تجزیه و تحلیل و تاریخچه را پس از تغییرات زنده مرور کنید تا مطمئن شوید که تجربه بازدیدکنندگان بهبود یافته است.

03

ویجت را نصب کنید

کد جاسازی صحیح را کپی کنید، آن را در زمینه های HTML، WordPress، React، یا SDK پیشرفته نصب کنید، سپس رفتار دسکتاپ و موبایل را تأیید کنید.

تعبیه مدالقطعه نصب وب سایت را کپی کنید
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1HTML، WordPress، React، یا NPM/SDK را بر اساس پشته سایت انتخاب کنید.
2پس از ذخیره و همگام سازی ربات، کد را کپی کنید.
3قطعه را قبل از تگ بدنه بسته یا در طرح‌بندی چارچوب جای‌گذاری کنید.
HTML نصب کنید

ویجت را در یک وب سایت استاندارد HTML نصب کنید

این برای چیست: زمانی که می‌توانید الگوی صفحه، پاورقی طرح زمینه، یا طرح‌بندی جهانی HTML را ویرایش کنید، از این استفاده کنید.

قبل از شروع
  • ابتدا ربات را ذخیره کنید تا embed modal یک شناسه ربات واقعی داشته باشد.
  • قبل از تولید از محل استیج استفاده کنید.
  • نسخه دقیق اسکریپت و data-bot-id را از حالت مودال حفظ کنید.
1

باز کردن My Bots

رباتی را که می خواهید نصب کنید پیدا کنید و روی Embed کلیک کنید.

نتیجه مورد انتظار: Embed modal با زبانه های نصب باز می شود.
2

HTML را انتخاب کنید

برگه HTML را انتخاب کنید و روی Copy Code کلیک کنید.

نتیجه مورد انتظار: اسکریپت ویجت با شناسه ربات پیوست شده کپی می شود.
3

قالب وب سایت را باز کنید

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

نتیجه مورد انتظار: شما در حال ویرایش پوسته سایت مشترک هستید، نه یک صفحه مجزا، مگر اینکه عمدی باشد.
4

قبل از بستن بدنه بچسبانید

قطعه را بلافاصله قبل از تگ بدنه بسته، جای‌گذاری کنید.

نتیجه مورد انتظار: اسکریپت پس از محتوای صفحه بارگیری می شود و می تواند ظرف ویجت را سوار کند.
5

انتشار یا استقرار

قالب را ذخیره کنید و سایت را مستقر کنید.

نتیجه مورد انتظار: اسکریپت ویجت در صفحات هدف زنده است.
6

دسکتاپ و موبایل را تست کنید

سایت را در یک پنجره مرورگر تازه و در یک نمای موبایل باز کنید.

نتیجه مورد انتظار: ویجت در موقعیت پیکربندی شده ظاهر می شود و بدون خطاهای کنسول باز می شود.
نحوه تست کردن: از صفحه زنده پیامی ارسال کنید، سپس Inbox و Chat History را باز کنید تا تأیید کنید که مکالمه به ربات صحیح تعلق دارد.
مشکلرفع کنید
ویجت از دست رفته استتأیید کنید که کد قبل از برچسب بدنه بسته می شود، اسکریپت ها توسط سازنده سایت مسدود نمی شوند و ربات فعال است.
ربات اشتباه ظاهر می شوددوباره قطعه را کپی کنید و data-bot-id را با ربات مورد نظر مقایسه کنید.
ویجت روی کنترل‌های صفحه همپوشانی داردموقعیت یا اندازه را در تنظیمات ویجت تغییر دهید و دوباره در تلفن همراه تست کنید.

بعد چه باید کرد: تنظیمات ویجت و گرفتن سرنخ را پس از نصب تنظیم کنید.

HTML جاسازی
<!-- sem.chat Voice & Text Widget -->
<script
  src="https://app.sem.chat/widget-v2.js?v=16"
  data-bot-id="YOUR_BOT_ID"
></script>
نصب پلت فرم

نصب در جریان های WordPress، React، یا صدای پیشرفته SDK

این برای چیست: هنگامی که وب سایت توسط یک برنامه CMS، React یا یکپارچه سازی صدای سفارشی مدیریت می شود، از این استفاده کنید.

قبل از شروع
  • بدانید کدام پشته مالک طرح‌بندی مشترک است.
  • از قطعه دقیق نشان داده شده در sem.chat برای ربات انتخابی استفاده کنید.
  • برای استفاده پیشرفته SDK، تأیید کنید که کلید عمومی و شناسه دستیار Vapi مورد نیاز را دارید.
1

گزینه WordPress

از Appearance، Theme Editor، footer.php یا یک افزونه headers-and-footers قابل اعتماد استفاده کنید.

نتیجه مورد انتظار: این قطعه در صفحات عمومی WordPress بارگیری می شود.
2

گزینه React

یک جزء کوچک ChatWidget ایجاد کنید، اسکریپت را در useEffect اضافه کنید و آن را در طرح اصلی رندر کنید.

نتیجه مورد انتظار: ویجت یک بار بارگیری می شود و در صورت جدا شدن طرح، پاک می شود.
3

گزینه SDK پیشرفته

فقط زمانی از برگه NPM/SDK استفاده کنید که به کنترل‌های تماس صوتی سفارشی فراتر از ویجت پیش‌فرض نیاز دارید.

نتیجه مورد انتظار: برنامه شما جلسه صوتی را کنترل می کند در حالی که sem.chat منبع دستیار پیکربندی شده باقی می ماند.
4

شناسه ربات را تأیید کنید

تأیید کنید کد نصب شده به شناسه ربات از Embed modal ارجاع می دهد.

نتیجه مورد انتظار: ویجت زنده به دستیار مورد نظر متصل می شود.
5

کنسول را بررسی کنید

ابزارهای توسعه دهنده مرورگر را باز کنید و دوباره بارگیری کنید.

نتیجه مورد انتظار: هیچ خطای اسکریپت مسدود، کانتینر تکراری یا شبکه وجود ندارد.
نحوه تست کردن: یک پیام آزمایشی را از سایت نصب شده تکمیل کنید، سپس تأیید کنید که در Inbox با صفحه مورد انتظار URL ظاهر شود.
مشکلرفع کنید
React ویجت های تکراری را بارگیری می کنددرج اسکریپت نگهبانی با ref یا رندر مؤلفه فقط در طرح اصلی.
WordPress برچسب‌های اسکریپت را حذف می‌کنداز یک افزونه تزریق فوتر یا فایل تم استفاده کنید که به اسکریپت ها اجازه می دهد.
تماس SDK نمی تواند شروع شودکلید عمومی، شناسه دستیار، مجوزهای مرورگر، و برنامه دسترسی برای صدا را بررسی کنید.

بعد چه باید کرد: برای کنترل رفتار، نام تجاری و جذب سرنخ به تنظیمات ویجت بروید.

WordPress قطعه پاورقی
<!-- sem.chat Widget (WordPress Compatible) -->
<script>
window.SEMCHAT_CONFIG = { botId: "YOUR_BOT_ID" };
</script>
<script src="https://app.sem.chat/widget-v2.js?v=16"></script>
جزء React
import { useEffect, useRef } from 'react';

export function ChatWidget() {
  const loaded = useRef(false);

  useEffect(() => {
    if (loaded.current) return;
    loaded.current = true;

    const script = document.createElement('script');
    script.src = 'https://app.sem.chat/widget-v2.js?v=16';
    script.setAttribute('data-bot-id', 'YOUR_BOT_ID');
    script.async = true;
    document.body.appendChild(script);

    return () => {
      const container = document.getElementById('semchat-widget-container');
      if (container) container.remove();
      script.remove();
    };
  }, []);

  return null;
}
صدای پیشرفته SDK
npm install @vapi-ai/web

import Vapi from '@vapi-ai/web';

const vapi = new Vapi('YOUR_VAPI_PUBLIC_KEY');
await vapi.start('YOUR_ASSISTANT_ID');

vapi.on('call-start', () => console.log('Call started'));
vapi.on('call-end', () => console.log('Call ended'));
04

تنظیمات ویجت

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

Bot Builder / ویجتظاهر ویجت و رفتار بازدیدکنندگان
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1حالت chat، صدا یا ترکیبی را انتخاب کنید.
2موضوع، رنگ، موقعیت، اندازه، نام تجاری، رضایت و صدا را تنظیم کنید.
3ضبط سرنخ، رتبه‌بندی، واکنش‌ها و رفتار پیگیری را پیکربندی کنید.
رفتار ویجت

رفتار ویجت رو به بازدیدکننده را پیکربندی کنید

این برای چیست: از این پس از اولین نصب یا هر زمانی که ویجت نیاز دارد با وب سایت مطابقت داشته باشد و سرنخ های بهتری جذب کند، از آن استفاده کنید.

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

سازنده ربات را باز کنید

My Bots را باز کنید، روی ویرایش کلیک کنید، سپس برگه ویجت را انتخاب کنید.

نتیجه مورد انتظار: کنترل های ویجت برای ربات انتخاب شده ظاهر می شود.
2

حالت را انتخاب کنید

گپ، صدا یا ترکیبی را بر اساس تجربه بازدیدکننده ای که می خواهید انتخاب کنید.

نتیجه مورد انتظار: پیش نمایش برای نشان دادن حالت انتخابی تغییر می کند.
3

تنظیم ظاهر

گزینه های تم، رنگ، اندازه، موقعیت دکمه و نام تجاری را انتخاب کنید.

نتیجه مورد انتظار: ویجت بدون پوشش محتوای مهم با سایت مطابقت دارد.
4

فعال کردن کنترل‌های بازدیدکننده

واکنش‌ها، صداها، رتبه‌بندی‌ها و درخواست‌های رضایت را روشن یا خاموش کنید.

نتیجه مورد انتظار: بازدیدکنندگان فقط کنترل‌هایی را می‌بینند که شما می‌خواهید استفاده کنند.
5

پیکربندی جذب سرنخ

فیلدهای الزامی، قسمت توضیحات اختیاری و زمانی که فرم ظاهر می شود را انتخاب کنید.

نتیجه مورد انتظار: طبق تنظیمات شما، مخاطبین قبل یا در طول conversations جمع آوری می شوند.
6

ایمیل پیگیری را تنظیم کنید

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

نتیجه مورد انتظار: بازدیدکنندگان می توانند پس از حل شدن conversations پیام های بعدی را دریافت کنند.
7

ذخیره و تست کنید

روی ذخیره کلیک کنید، صفحه مرحله بندی را دوباره بارگیری کنید و ویجت را باز کنید.

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

بعد چه باید کرد: تنظیمات صدا/آواتار و منابع دانش را قبل از راه‌اندازی تولید اضافه کنید.

05

صدا و آواتارها

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

Bot Builder / صداصدا، محدودیت‌ها، رونوشت‌ها و آواتارها
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1صدای سهام یا صدای شبیه سازی شده ذخیره شده را انتخاب کنید.
2محدودیت‌های دقیقه صدا و ذخیره رونوشت را تنظیم کنید.
3اگر طرح اجازه می دهد، آواتارهای سهام را انتخاب کنید یا یک آواتار سفارشی آپلود کنید.
تنظیم صدا

تماس‌های صوتی و رونوشت‌ها را تنظیم کنید

این برای چیست: وقتی بازدیدکنندگان باید به جای تایپ کردن با ربات صحبت کنند از این استفاده کنید.

قبل از شروع
  • تأیید کنید که این طرح شامل دقیقه‌های صوتی و گزینه‌های صوتی/آواتار مورد نظر است.
  • از یک محیط مرورگر آرام برای آزمایش استفاده کنید.
  • یک سوال پشتیبانی یا فروش واقع بینانه را برای آزمایش صوتی آماده کنید.
1

تنظیمات Voice را باز کنید

سازنده ربات را باز کنید و ناحیه Voice یا Voice and Avatars را انتخاب کنید.

نتیجه مورد انتظار: کنترل های صوتی و انتخاب صدای فعلی قابل مشاهده است.
2

صدای سهام را انتخاب کنید

صداهای موجود را پیش‌نمایش کنید، بهترین تناسب را انتخاب کنید و انتخاب را ذخیره کنید.

نتیجه مورد انتظار: ربات از صدای انتخاب شده برای تماس استفاده می کند.
3

حالت صدا را پیکربندی کنید

وقتی صدا باید در دسترس بازدیدکنندگان باشد، از تنظیمات ویجت برای انتخاب Voice یا Hybrid استفاده کنید.

نتیجه مورد انتظار: بازدیدکنندگان یک گزینه صوتی را در ویجت می بینند.
4

محدودیت های صوتی را تنظیم کنید

در صورت وجود محدودیت برای هر کاربر یا فضای کاری تعریف کنید.

نتیجه مورد انتظار: تماس‌های طولانی یا مکرر نمی‌توانند بیش از آنچه در نظر گرفته شده است، دقایقی را صرف کنند.
5

رونوشت ها را فعال کنید

در صورت نیاز به بررسی تماس در سابقه، ذخیره رونوشت را روشن کنید.

نتیجه مورد انتظار: تماس‌های صوتی پس از جلسه رونوشت‌های قابل خواندن ایجاد می‌کنند.
6

یک تماس را تست کنید

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

نتیجه مورد انتظار: ربات با صدا پاسخ می دهد و تماس به طور کامل پایان می یابد.
7

متن را بخوانید

Chat History را باز کنید و مکالمه صوتی را پیدا کنید.

نتیجه مورد انتظار: رونوشت نشان می دهد که بازدیدکننده و ربات چه گفته اند.
نحوه تست کردن: یک تماس کوتاه را تکمیل کنید و تأیید کنید که دقیقه های صوتی، رونوشت و حالت مکالمه ضبط می شوند.
مشکلرفع کنید
مرورگر میکروفون را مسدود می کنداجازه میکروفون در مرورگر را بدهید و صفحه را دوباره بارگیری کنید.
گزینه Voice قفل شده استصورتحساب را باز کنید و تأیید کنید که طرح فضای کاری شامل ویژگی‌های صوتی است.
رونوشت خالی استتأیید کنید که ذخیره رونوشت فعال است و تماس به طور معمول پایان یافته است.

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

کلون صدا و آواتار

یک صدا را شبیه سازی کنید و یک آواتار سفارشی اختصاص دهید

این برای چیست: هنگامی که دستیار به تجربه آواتار با صدای مارک دار یا صحبت کردن نیاز دارد از این استفاده کنید.

قبل از شروع
  • فقط از صداها و تصاویری استفاده کنید که اجازه استفاده از آنها را دارید.
  • نمونه های صدای تمیز را با نویز پس زمینه کم ضبط کنید.
  • محدودیت های طرح را برای صداهای شبیه سازی شده و آواتارهای سفارشی تأیید کنید.
1

کلونینگ صوتی را باز کنید

از ناحیه Voice روی Clone Voice کلیک کنید.

نتیجه مورد انتظار: گفتگوی آپلود الزامات نمونه پذیرفته شده را نشان می دهد.
2

نمونه ها را بارگذاری کنید

یک تا پنج ضبط واضح آپلود کنید و درخواست کلون را ارسال کنید.

نتیجه مورد انتظار: صدای شبیه سازی شده پس از پردازش ظاهر می شود یا گفتگوی مورد نیاز بعدی را نشان می دهد.
3

صدای شبیه سازی شده را اختصاص دهید

صدای شبیه سازی شده را در انتخابگر صدا انتخاب کنید و ذخیره کنید.

نتیجه مورد انتظار: تماس های آینده از صدای شبیه سازی شده استفاده می کنند.
4

آواتار سهام را انتخاب کنید

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

نتیجه مورد انتظار: تجربه صوتی هویت بصری دارد.
5

آواتار سفارشی را آپلود کنید

اگر طرح شما از آن پشتیبانی می کند، یک تصویر چهره واضح یا یک ویدیوی کوتاه آپلود کنید.

نتیجه مورد انتظار: آواتار پردازش می شود و برای انتخاب در دسترس می شود.
6

پیش نمایش کامل را اجرا کنید

تماس صوتی را شروع کنید و رفتار صدا، آواتار و رونوشت را با هم تأیید کنید.

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

بعد چه باید کرد: به دانش و داده ها بروید تا تجربه صوتی پاسخ های دقیقی داشته باشد.

06

دانش و داده

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

Bot Builder / دانشمنابع دانش و پاسخ تست
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1دانش دستی را برای قوانین خط‌مشی، قیمت‌گذاری و برند اضافه کنید.
2صفحات وب سایت را وارد کنید و نتایج خزیدن را اعمال کنید.
3هنگام تغییر موجودی، فیدهای محصول را اضافه کنید و آنها را همگام کنید.
منابع دانش

ربات را با دانش دستی، واردات وب سایت و فیدهای محصول آموزش دهید

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

قبل از شروع
  • منبع URLs و فید محصول URLs را آماده کنید.
  • تصمیم بگیرید که کدام صفحات نباید وارد شوند، مانند صفحات مدیریت یا خصوصی.
  • برای هر موضوعی که اضافه می کنید، سؤالات تستی ایجاد کنید.
1

باز کردن دانش

Bot Builder را باز کنید و برگه Knowledge یا Data را انتخاب کنید.

نتیجه مورد انتظار: دانش دستی، واردات وب سایت و ابزارهای خوراک محصول قابل مشاهده است.
2

دانش دستی را اضافه کنید

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

نتیجه مورد انتظار: ربات یک منبع قابل اعتماد فوری برای پاسخ های با اولویت بالا دارد.
3

واردات محتوای وب سایت

وب‌سایت عمومی URL را جای‌گذاری کنید و خزیدن/وارد کردن را شروع کنید.

نتیجه مورد انتظار: نتایج خزیدن صفحات کشف شده یا وضعیت واردات را نشان می دهد.
4

نتایج را بررسی و اعمال کنید

صفحات مفید را نگه دارید، صفحات نامربوط را حذف کنید، سپس محتوای انتخاب شده را اعمال کنید.

نتیجه مورد انتظار: فقط محتوای تایید شده وب سایت وارد پایگاه دانش می شود.
5

افزودن فید محصول URLs

Google Merchant Center یا فید پشتیبانی شده URL را جای‌گذاری کنید و وارد کنید.

نتیجه مورد انتظار: محصولات، قیمت ها، در دسترس بودن و ویژگی ها در دسترس ربات قرار می گیرند.
6

فیدها را تازه یا حذف کنید

وقتی داده‌های کاتالوگ تغییر می‌کند از Refresh استفاده کنید و فیدهایی را که دیگر استفاده نمی‌شوند حذف کنید.

نتیجه مورد انتظار: ربات از داده های قدیمی یا تکراری محصول جلوگیری می کند.
7

ذخیره و همگام سازی کنید

ربات را ذخیره کنید و منتظر بمانید تا همگام سازی کامل شود.

نتیجه مورد انتظار: آخرین دانش توسط پیش نمایش و پاسخ ویجت زنده استفاده می شود.
8

سوالات تاییدیه بپرسید

به ازای هر منبعی که اضافه کردید یک سوال تستی بپرسید.

نتیجه مورد انتظار: پاسخ به محتوای به روز شده به طور دقیق اشاره می کند یا منعکس می کند.
نحوه تست کردن: درباره قیمت، بازگشت، در دسترس بودن، اطلاعات شرکت و موضوعات پشتیبانی نشده سؤال بپرسید. تأیید کنید که ربات به موضوعات شناخته شده پاسخ می دهد و جزئیات ناشناخته را اختراع نمی کند.
مشکلرفع کنید
خزنده صفحات نامربوط را وارد می کندآن صفحات را از نتایج انتخاب شده حذف کنید و دستورالعمل های دستی واضح تری اضافه کنید.
قیمت محصولات کهنه استفید را تازه کنید و تأیید کنید که فید URL حاوی مقادیر فعلی است.
ربات پاسخ ها را می سازدقاعده‌ای اضافه کنید که ربات باید بگوید مطمئن نیست و در مواقعی که دانش از دست رفته است، پشتیبانی انسانی ارائه دهد.

بعد چه باید کرد: به پیش‌نمایش برگردید، دوباره تست کنید، سپس ویجت را نصب یا به‌روزرسانی کنید.

07

صندوق ورودی، Live Support، سابقه، مخاطبین

روزانه conversations را مدیریت کنید، درخواست‌های پشتیبانی زنده را درخواست کنید، کنترل دستی به هوش مصنوعی، صادرات سابقه، مدیریت مخاطبین، و همگام‌سازی مخاطبین با SendPulse.

/inboxگردش کار مکالمه صندوق ورودی
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1فیلتر بر اساس ربات یا کانال.
2گفتگو را باز کنید و در صورت نیاز به عنوان یک انسان پاسخ دهید.
3از کنترل‌های ترجمه، حل و فصل و انتقال به دقت استفاده کنید.
/پشتیبانی زندهکنترل انتقال پشتیبانی زنده
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1درخواست تحویل در انتظار به سرعت.
2به عنوان یک نماینده پاسخ دهید یا مکالمه را به هوش مصنوعی تحویل دهید.
3زمانی را حل کنید که بازدیدکننده دیگر به کمک انسانی نیاز نداشته باشد.
/chat-historyتاریخچه گفتگو و صادرات
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1جستجو بر اساس بازدید کننده، ربات، کانال، یا تاریخ.
2رونوشت‌های کامل را برای جلسات متنی و صوتی باز کنید.
3در صورت نیاز CSV یا JSON را صادر کنید.
/ مخاطبینمخاطبین و صادرات SendPulse
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1مخاطبین را بر اساس ربات یا منبع فیلتر کنید.
2جزئیات تماس و زمینه مکالمه را باز کنید.
3مخاطبین انتخابی را به SendPulse صادر یا همگام کنید.
پاسخ صندوق ورودی

یک مکالمه را باز کنید و یک پاسخ انسانی بفرستید

این برای چیست: زمانی که اپراتور باید به مشتری از sem.chat به جای اینکه اجازه دهد هوش مصنوعی به تنهایی ادامه دهد، از این استفاده کنید.

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

صندوق ورودی را باز کنید

روی Inbox در نوار کناری کلیک کنید.

نتیجه مورد انتظار: conversations اخیر با ربات، کانال، بازدیدکننده، وضعیت و زمان ظاهر می‌شود.
2

در صورت نیاز فیلتر کنید

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

نتیجه مورد انتظار: فهرست به مجموعه گفتگوی مورد نیاز شما محدود می شود.
3

گفتگو را باز کنید

روی ردیف بازدیدکننده کلیک کنید.

نتیجه مورد انتظار: موضوع کامل، اطلاعات بازدیدکننده و کنترل‌های پاسخ قابل مشاهده است.
4

در صورت نیاز ترجمه کنید

هنگامی که زبان بازدیدکننده با زبان نماینده متفاوت است از کنترل های ترجمه استفاده کنید.

نتیجه مورد انتظار: نماینده می تواند درک کند و به طور مناسب پاسخ دهد.
5

ارسال پاسخ

پاسخ انسانی را بنویسید و ارسال کنید.

نتیجه مورد انتظار: پیام به عنوان یک پاسخ عامل/انسان به موضوع اضافه می شود.
6

حل کنید یا باز نگه دارید

در صورت کامل بودن مکالمه را حل کنید یا آن را برای پیگیری باز بگذارید.

نتیجه مورد انتظار: وضعیت صندوق ورودی با وضعیت واقعی مشتری مطابقت دارد.
نحوه تست کردن: یک پاسخ آزمایشی ایمن به یک مکالمه آزمایشی ارسال کنید و تأیید کنید که در ویجت بازدیدکننده و Chat History نشان داده شود.
مشکلرفع کنید
پاسخ ارسال نشدوضعیت شبکه، وضعیت مکالمه، و اینکه آیا پشتیبانی زنده ادعا شده است را بررسی کنید.
زبان بازدیدکننده اشتباه استقبل از پاسخ دادن از ترجمه استفاده کنید یا تنظیمات زبان ربات را به روز کنید.
مکالمه در صندوق ورودی نیستChat History را جستجو کنید و تأیید کنید که تست ویجت از ربات صحیح استفاده کرده است.

بعد چه باید کرد: از Live Support برای صف های انتقال فعال و Chat History برای ممیزی استفاده کنید.

پشتیبانی زنده

ادعا کنید، پاسخ دهید، به هوش مصنوعی بازگردانید، و یک انتقال را حل کنید

این برای چیست: زمانی که هوش مصنوعی از یک انسان یا یک بازدیدکننده صراحتاً به یک نماینده نیاز دارد، از این استفاده کنید.

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

باز کردن Live Support

روی Live Support در نوار کناری کلیک کنید.

نتیجه مورد انتظار: در حال انتظار و انتقال فعال conversations قابل مشاهده است.
2

درخواست را ادعا کنید

روی ادعای مکالمه منتظر کلیک کنید.

نتیجه مورد انتظار: سایر عوامل می توانند ببینند که مکالمه به طور فعال مدیریت می شود.
3

متن را بخوانید

قبل از پاسخ دادن، پیام ها و جزئیات بازدیدکنندگان را باز کنید.

نتیجه مورد انتظار: مامور می‌فهمد چرا این انتقال اتفاق افتاد.
4

پاسخ انسانی را ارسال کنید

واضح پاسخ دهید و موضوع را به روز نگه دارید.

نتیجه مورد انتظار: بازدید کننده یک پاسخ انسانی دریافت می کند.
5

در صورت لزوم به هوش مصنوعی برگردید

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

نتیجه مورد انتظار: هوش مصنوعی مدیریت مکالمه را از سر می گیرد.
6

پس از اتمام حل کنید

پس از اینکه بازدیدکننده دیگر به کمک نیاز نداشت، روی Resolve کلیک کنید.

نتیجه مورد انتظار: انتقال بسته شده و از صف فعال حذف می شود.
نحوه تست کردن: یک آزمایش انتقال ایجاد کنید، آن را ادعا کنید، یک بار پاسخ دهید، آن را پس دهید و تغییرات وضعیت را در Live Support و Chat History تأیید کنید.
مشکلرفع کنید
نمایندگان درخواست ها را از دست می دهندمرورگر/ایمیل/اعلان‌های فشاری را فعال کنید و فرآیندی را برای مالکیت صف اضافه کنید.
هوش مصنوعی خیلی زود به کنترل خود ادامه می دهددستورالعمل ها و قوانین انتقال را تنظیم کنید تا کنترل انسانی تا زمانی که حل و فصل نشود یا بازگردانده شود فعال بماند.
CRM خارجی همگام نیستاز وب هوک ها یا نظرسنجی از بخش دستور العمل های برنامه نویس استفاده کنید.

بعد چه باید کرد: اگر تیم‌های پشتیبانی خارج از sem.chat کار می‌کنند، CRM/hooks را وصل کنید.

تاریخچه و مخاطبین

جستجو، صادرات و استفاده از سوابق مکالمه/تماس

این برای چیست: از این برای ممیزی، بازبینی سرنخ، صادرات CSV و همگام سازی SendPulse استفاده کنید.

قبل از شروع
  • تصمیم بگیرید که به conversations، مخاطبین یا هر دو نیاز دارید.
  • قبل از صادرات، محدوده تاریخ صحیح را اعمال کنید.
  • داده های شخصی را بیش از حد نیاز صادر نکنید.
1

باز کردن Chat History

روی Chat History در نوار کناری کلیک کنید.

نتیجه مورد انتظار: فیلترهای مکالمه، آمار و فهرست رونوشت قابل مشاهده است.
2

جستجو و فیلتر کنید

بر اساس ربات، کانال، حالت، بازدیدکننده یا محدوده تاریخ فیلتر کنید.

نتیجه مورد انتظار: فقط موارد منطبق با conversations قابل مشاهده است.
3

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

برای خواندن کامل موضوع پیام، روی یک مکالمه کلیک کنید.

نتیجه مورد انتظار: متن کامل، جزئیات تماس و فراداده مکالمه قابل مشاهده است.
4

صادر کردن conversations

بر روی Export کلیک کنید و در صورت وجود فرمت مورد نیاز را انتخاب کنید.

نتیجه مورد انتظار: صادرات حاوی داده‌های مکالمه فیلتر شده است.
5

مخاطبین را باز کنید

روی مخاطبین در نوار کناری کلیک کنید.

نتیجه مورد انتظار: رکوردهای سرنخ/تماس با منبع، ربات و وضعیت ظاهر می شوند.
6

فیلتر کردن و صادرات مخاطبین

مخاطبین را جستجو کنید، رکوردهای مورد نظر را انتخاب کنید، سپس به SendPulse صادر یا همگام سازی کنید.

نتیجه مورد انتظار: مخاطبین انتخاب شده در خارج از sem.chat با توجه به اقدام انتخاب شده در دسترس هستند.
نحوه تست کردن: یک CSV فیلتر شده کوچک را صادر کنید و آن را به صورت محلی باز کنید تا تأیید کنید ستون‌ها و محدوده تاریخ درست هستند.
مشکلرفع کنید
مخاطب از مخاطبین گم شده استتأیید کنید که گرفتن سرنخ فعال است و بازدیدکننده فرم را ارسال کرده است.
صادرات خیلی زیاد استقبل از صادرات، محدوده تاریخ یا فیلتر ربات را محدود کنید.
همگام سازی SendPulse در دسترس نیستابتدا SendPulse را در Integrations وصل کنید، سپس به Contacts بازگردید.

بعد چه باید کرد: تجزیه و تحلیل را مرور کنید تا روند عملکرد را پس از اجرای عملیات درک کنید.

08

کانال ها و ادغام ها

Slack، Facebook، Instagram، WhatsApp، Telegram را از طریق BotFather، اعتبارنامه های دستی، پیوندهای جایگزین chat، ​​__SEMCHAT_0_CHAT__، و __SEMCHAT_integrations و Slack وصل کنید.

/ادغام هاکانال‌ها، CRM، و اتصالات ایمیل
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1کانال یا کارت ادغام CRM را انتخاب کنید.
2مراحل OAuth یا اعتبارنامه را برای هر ارائه دهنده دنبال کنید.
3ادغام ها را از همان صفحه قطع کنید یا دوباره آزمایش کنید.
کانال ها را وصل کنید

یک کانال پیام رسانی یا ادغام CRM را وصل کنید

این برای چیست: زمانی که sem.chat باید conversations را خارج از ویجت وب سایت دریافت کند یا مخاطبین را به ابزارهای دیگر ارسال کند، از این استفاده کنید.

قبل از شروع
  • دسترسی ادمین به پلتفرم خارجی داشته باشید.
  • بدانید کدام ربات باید پیام های کانال را دریافت کند.
  • قبل از اتصال حساب های تولید از کانال های آزمایشی استفاده کنید.
1

ادغام ها را باز کنید

روی Integrations در نوار کناری کلیک کنید.

نتیجه مورد انتظار: کانال‌های موجود، ابزارهای CRM، SendPulse و گزینه‌های ویجت وب‌سایت قابل مشاهده هستند.
2

ادغام را انتخاب کنید

روی اتصال در Slack، کانال های متا، Telegram، SendPulse، CRM، یا اطلاعات کاربری دستی کلیک کنید.

نتیجه مورد انتظار: گفتگوی تنظیم یا جریان OAuth باز می شود.
3

راه اندازی کامل ارائه دهنده

برای کانال‌های OAuth، مجوزهای درخواستی را تأیید کنید. برای کانال‌های دستی، رمز، رمز، شناسه حساب یا وب هوک URL مورد نیاز را جای‌گذاری کنید.

نتیجه مورد انتظار: sem.chat اتصال را ذخیره می کند و ادغام را به صورت متصل نشان می دهد.
4

ربات را اختصاص دهید

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

نتیجه مورد انتظار: پیام های دریافتی به دستیار صحیح می روند.
5

کانال رو تست کن

از کانال خارجی پیام آزمایشی ارسال کنید.

نتیجه مورد انتظار: پیام در Inbox یا Chat History در زیر کانال صحیح ظاهر می شود.
6

در صورت نیاز اتصال را قطع کنید

هنگامی که کانال باید متوقف شود، از قطع اتصال از کارت ادغام استفاده کنید.

نتیجه مورد انتظار: sem.chat دریافت یا ارسال از طریق آن ادغام را متوقف می کند.
نحوه تست کردن: یک پیام آزمایشی از طریق کانال متصل ارسال کنید و پاسخ ربات، ردیف صندوق ورودی و سابقه سابقه را تأیید کنید.
مشکلرفع کنید
رمز Telegram ناموفق استتوکن را در BotFather ایجاد یا تنظیم مجدد کنید و دوباره آن را جایگذاری کنید.
پیام های Slack دریافت نمی شوندمحدوده برنامه، اشتراک رویداد URL، رمز ربات، راز امضا، و عضویت کانال را بررسی کنید.
اتصال متا کانال خراب می شودتأیید کنید که حساب Facebook/Instagram/WhatsApp دارای مجوزهای سرپرست و دسترسی تجاری مورد نیاز است.
همگام سازی SendPulse ناموفق بودSendPulse را دوباره وصل کنید و تأیید کنید که فیلدهای مخاطب نگاشت شده اند.

بعد چه باید کرد: مالکیت کانال را برای تیم مستند کنید و Inbox را پس از راه‌اندازی نظارت کنید.

09

برنامه ریزی

انواع رویداد ایجاد کنید، در دسترس بودن را پیکربندی کنید، تقویم‌ها را متصل کنید، رزروها را مدیریت کنید، پیوندهای یکباره ایجاد کنید، ایمیل‌های رزرو را پیکربندی کنید، تجزیه و تحلیل‌ها را مرور کنید، رویدادهای پولی را تنظیم کنید و پیوندهای رزرو عمومی را آزمایش کنید.

/برنامه ریزیزمان بندی فضای کاری
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1از تب ها برای انواع رویداد، رزرو، تجزیه و تحلیل، پیوندهای یکباره، تقویم، ایمیل و تنظیمات استفاده کنید.
2انواع رویداد را ویرایش، کپی، جاسازی، فعال یا مکث کنید.
3پیوند عمومی را کپی کنید و آزمون رزرو خصوصی را اجرا کنید.
ویرایشگر رویدادپیکربندی نوع رویداد
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1نام، توضیحات، مدت زمان، مکان و بافرها را وارد کنید.
2در دسترس بودن، پنجره‌های رزرو، سؤالات، گزینه‌های رویداد پولی و قوانین لغو را تنظیم کنید.
3قبل از اشتراک‌گذاری پیوند، رویداد را ذخیره کنید.
/book/:username/:eventSlugصفحه رزرو عمومی
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1بازدیدکنندگان تاریخ را از صفحه رزرو عمومی انتخاب می کنند.
2بازدیدکنندگان یک بازه زمانی در دسترس را انتخاب می کنند.
3بازدیدکنندگان رزرو را تایید می کنند و ایمیل های تایید را دریافت می کنند.
نوع رویداد

یک نوع رویداد ایجاد کنید و پیوند رزرو را منتشر کنید

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

قبل از شروع
  • نام رویداد، مدت زمان، نوع جلسه و مالک را انتخاب کنید.
  • قبل از اشتراک گذاری پیوندها، منطقه زمانی و در دسترس بودن را تنظیم کنید.
  • اگر رزرو دوبار اهمیت دارد، تقویم‌ها را وصل کنید.
1

برنامه ریزی را باز کنید

روی زمان‌بندی در نوار کناری کلیک کنید.

نتیجه مورد انتظار: فضای کاری زمان‌بندی، برگه‌هایی را برای انواع رویداد، رزرو، تجزیه و تحلیل، پیوندهای یکباره، تقویم‌ها، ایمیل‌ها و تنظیمات نشان می‌دهد.
2

یک نوع رویداد ایجاد کنید

روی ایجاد کلیک کنید، سپس نام، توضیحات، مدت زمان، مکان، بافر و قوانین رزرو را اضافه کنید.

نتیجه مورد انتظار: این رویداد دارای اطلاعات عمومی کافی برای درک بازدیدکنندگان است.
3

تنظیم در دسترس بودن

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

نتیجه مورد انتظار: بازدیدکنندگان فقط زمان هایی را می بینند که شما مایل به ارائه آن هستید.
4

سوالات را اضافه کنید

سوالات مورد نیاز مانند تلفن، شرکت، وب سایت یا هدف جلسه را اضافه کنید.

نتیجه مورد انتظار: رزروها زمینه مورد نیاز تیم شما را قبل از تماس جمع آوری می کند.
5

تقویم ها را وصل کنید

تقویم‌ها را باز کنید و Google، Outlook، یا iCal را در صورت وجود وصل کنید.

نتیجه مورد انتظار: زمان‌های شلوغ را می‌توان مسدود کرد و رزروهای تأیید شده را می‌توان در تقویم نوشت.
6

ایمیل ها و یادآوری ها را تنظیم کنید

ایمیل‌ها را باز کنید و پیام‌های تأیید، یادآوری، لغو و زمان‌بندی مجدد را پیکربندی کنید.

نتیجه مورد انتظار: بازدیدکنندگان ارتباط صحیح رزرو را دریافت می کنند.
7

پیوند عمومی را به اشتراک بگذارید و آزمایش کنید

پیوند رویداد را کپی کنید، آن را در یک پنجره خصوصی باز کنید، یک اسلات را انتخاب کنید و یک رزرو آزمایشی را تکمیل کنید.

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

بعد چه باید کرد: پیوندهای رزرو را در ربات، وب‌سایت یا ایمیل‌های بعدی جاسازی کنید.

برنامه ریزی پیشرفته

از پیوندهای یکباره، تجزیه و تحلیل، جاسازی ها و رویدادهای پولی استفاده کنید

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

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

یک لینک یکباره ایجاد کنید

پیوندهای یکباره را باز کنید، اسلات یا قوانین ارائه شده را انتخاب کنید، سپس پیوند را ایجاد کنید.

نتیجه مورد انتظار: گیرنده می تواند تنها از در دسترس بودن انتخاب شده رزرو کند.
2

جاسازی زمان‌بندی

اگر جریان رزرو باید در وب سایت شما ظاهر شود، از گزینه جاسازی کارت رویداد استفاده کنید.

نتیجه مورد انتظار: رابط کاربری رزرو را می توان در صفحه ای که بازدیدکنندگان تبدیل می کنند قرار داد.
3

تحلیل های زمان بندی را مرور کنید

Analytics را در داخل Scheduling باز کنید.

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

فعال کردن رویدادهای پولی

ویرایشگر رویداد را باز کنید، قیمت، ارز و رفتار پرداخت را تنظیم کنید.

نتیجه مورد انتظار: بازدیدکنندگان باید با توجه به تنظیمات رویداد، مرحله پرداخت را تکمیل کنند.
5

رزرو حسابرسی

رزروها را باز کنید و ورودی‌های آینده، تکمیل‌شده، لغو شده و زمان‌بندی‌شده را بازبینی کنید.

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

بعد چه باید کرد: نتایج زمان‌بندی را به گزارش‌ها و تجزیه و تحلیل‌ها متصل کنید.

10

تجزیه و تحلیل و گزارش ها

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

/تحلیلداشبورد تجزیه و تحلیل
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1محدوده تاریخ یا تاریخ های سفارشی را انتخاب کنید.
2معیارهای مکالمه، رضایت، زبان، کانال و تبدیل را بخوانید.
3برای تجزیه و تحلیل آفلاین، CSV را صادر کنید.
تنظیمات / گزارش هاتنظیم گزارش ایمیل
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1آهنگ گزارش روزانه، هفتگی یا ماهانه را انتخاب کنید.
2دریافت کنندگان گزارش را اضافه کنید
3یک گزارش فوری برای تحویل آزمایشی ارسال کنید.
بررسی تجزیه و تحلیل

تجزیه و تحلیل و صادرات داده های عملکرد را بخوانید

این برای چیست: از این برای بررسی های هفتگی، بررسی های راه اندازی، بررسی کیفیت پشتیبانی و تجزیه و تحلیل تبدیل استفاده کنید.

قبل از شروع
  • قبل از خواندن معیارها، محدوده تاریخ را انتخاب کنید.
  • بدانید که کدام ربات یا کانال را ارزیابی می کنید.
  • هنگام گزارش عملکرد تولید، تاریخ آزمایش خصوصی را حذف کنید.
1

Analytics را باز کنید

روی Analytics در نوار کناری کلیک کنید.

نتیجه مورد انتظار: معیارهای داشبورد و پانل های نمودار قابل مشاهده است.
2

محدوده تاریخ را انتخاب کنید

امروز، 7 روز، 30 روز یا تاریخ های سفارشی را انتخاب کنید.

نتیجه مورد انتظار: همه نمودارها به دوره انتخابی به روز می شوند.
3

معیارهای اصلی را بخوانید

conversations، دقایق صوتی، رضایت، تبدیل، و ترکیب کانال را مرور کنید.

نتیجه مورد انتظار: شما حجم و کیفیت تعاملات مشتری را درک می کنید.
4

روندها را مرور کنید

به روند مکالمه، تغییرات رضایت، سوالات برتر و الگوهای زبان/کانال نگاه کنید.

نتیجه مورد انتظار: می‌توانید مکان‌هایی را برای بهبود دستورالعمل‌ها یا کارکنان ربات شناسایی کنید.
5

صادر کردن CSV

هنگامی که تیم به تجزیه و تحلیل صفحه گسترده نیاز دارد، از صادرات CSV استفاده کنید.

نتیجه مورد انتظار: CSV شامل محدوده تاریخ و معیارهای انتخاب شده است.
6

یافته ها را به تغییرات تبدیل کنید

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

نتیجه مورد انتظار: تجزیه و تحلیل منجر به بهبود محصول مشخص می شود.
نحوه تست کردن: یک تاریخ سفارشی کوچک CSV را صادر کنید و بررسی کنید که محدوده تاریخ و معیارها با آنچه داشبورد نشان می‌دهد مطابقت داشته باشد.
مشکلرفع کنید
معیارها خیلی بالا به نظر می رسندبررسی کنید که آیا مرحله‌بندی/تست conversations در محدوده تاریخ انتخابی گنجانده شده است یا خیر.
رضایت خالی استرتبه‌بندی‌ها را در تنظیمات ویجت فعال کنید و منتظر بمانید تا بازدیدکنندگان رتبه‌بندی را بگذارند.
دقایق صوتی با انتظارات مطابقت نداردتأیید حالت صوتی فقط در ربات های مورد نظر فعال است.

بعد چه باید کرد: گزارش های ایمیل را برای نمایان شدن مکرر برنامه ریزی کنید.

گزارش ها

پیکربندی گزارش های ایمیل تکراری و تحویل آزمایشی

این برای چیست: هنگامی که مالکان، مدیران یا مشتریان به خلاصه عملکرد خودکار نیاز دارند از این استفاده کنید.

قبل از شروع
  • تصمیم بگیرید که چه کسی باید گزارش ها را دریافت کند.
  • از آدرس های ایمیل تایید شده استفاده کنید.
  • آهنگی را انتخاب کنید که با ریتم بازبینی تجاری مطابقت داشته باشد.
1

Settings و سپس Reports را باز کنید

به تنظیمات بروید و برگه گزارش ها را انتخاب کنید یا در صورت وجود از تغییر مسیر گزارش ها استفاده کنید.

نتیجه مورد انتظار: آهنگ گزارش، گیرندگان، و سابقه قابل مشاهده است.
2

آهنگ را انتخاب کنید

گزارش های روزانه، هفتگی یا ماهانه را فعال کنید.

نتیجه مورد انتظار: برنامه زمانبندی گزارش برای فضای کاری ذخیره می شود.
3

افزودن گیرندگان

آدرس های ایمیلی را که باید گزارش دریافت کنند وارد کنید.

نتیجه مورد انتظار: گزارش ها برای ذینفعان صحیح ارسال می شود.
4

ارسال گزارش فوری

روی ارسال اکنون یا مشابه اقدام گزارش فوری کلیک کنید.

نتیجه مورد انتظار: یک ایمیل گزارش بلافاصله برای تأیید ارسال می شود.
5

بررسی تاریخچه گزارش

پس از ارسال گزارش، پانل تاریخچه را بررسی کنید.

نتیجه مورد انتظار: می توانید وضعیت و زمان تحویل را تأیید کنید.
نحوه تست کردن: یک گزارش فوری برای گیرنده آزمایش ارسال کنید و دریافت و قالب بندی را تأیید کنید.
مشکلرفع کنید
ایمیل گزارش نمی رسداملای گیرنده، پوشه هرزنامه، و وضعیت سابقه گزارش را بررسی کنید.
افراد اشتباه گزارش دریافت می کنندگیرندگان را به روز کنید و قبل از ارسال برنامه ریزی شده بعدی ذخیره کنید.
محتوای گزارش پر سر و صدا استانتظارات محدوده تاریخ را تنظیم کنید و از Analytics برای بررسی دستی عمیق تر استفاده کنید.

بعد چه باید کرد: از آهنگ گزارش به عنوان یک ریتم عملیاتی برای بهبود ربات استفاده کنید.

11

صورتحساب، تیم، امنیت، تنظیمات، وابسته

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

/صورتحساببرنامه ریزی و کنترل صورتحساب
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1طرح فعلی، وضعیت آزمایشی و محدودیت های usage را مرور کنید.
2ویژگی های طرح را قبل از ارتقا مقایسه کنید.
3پورتال صورتحساب را برای فاکتورها، روش‌های پرداخت، لغو یا فعال‌سازی مجدد باز کنید.
/تنظیماتتنظیمات، تیم و امنیت
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1از General برای نمایه و زبان استفاده کنید.
2از تیم برای دعوت ها و نقش ها استفاده کنید.
3از امنیت برای کلیدهای 2FA، API و اقدامات منطقه خطر استفاده کنید.
/وابستهکنترل برنامه های وابسته
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1برای ایجاد لینک ارجاع به برنامه بپیوندید.
2پیوند ارجاع برای کمپین ها را کپی کنید.
3ایمیل پرداخت را تنظیم کنید و پرداخت های واجد شرایط را درخواست کنید.
صورتحساب

یک طرح را شروع کنید، ارتقا دهید، لغو کنید یا دوباره فعال کنید

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

قبل از شروع
  • مالک حساب یا سرپرست صورت‌حساب باید اقدامات صورت‌حساب را انجام دهد.
  • تأیید کنید کدام ویژگی‌ها دارای پلان گیت هستند: صدا، صداهای شبیه‌سازی شده، آواتارهای سفارشی، API، تیم، CRM و کانال‌ها.
  • برای تغییر روش پرداخت و فاکتور از درگاه صورتحساب ایمن استفاده کنید.
1

صورتحساب را باز کنید

روی صورتحساب در نوار کناری کلیک کنید.

نتیجه مورد انتظار: طرح فعلی، وضعیت آزمایشی، محدودیت های usage و کارت های طرح قابل مشاهده است.
2

مقایسه طرح ها

محدودیت‌های chat، صدا، تیم، API، آواتار، ادغام، زمان‌بندی و پشتیبانی را مرور کنید.

نتیجه مورد انتظار: شما می دانید که کدام برنامه ویژگی مورد نیاز را باز می کند.
3

فاصله صورتحساب را انتخاب کنید

در صورت موجود بودن کلید، ماهانه یا سالانه را انتخاب کنید.

نتیجه مورد انتظار: به روز رسانی قیمت و پس انداز برای بازه زمانی انتخاب شده.
4

ارتقا دهید یا پرداخت را شروع کنید

طرح مورد نظر را انتخاب کنید و تسویه حساب را کامل کنید.

نتیجه مورد انتظار: اشتراک پس از تایید پرداخت فعال می شود.
5

پورتال مشتری را باز کنید

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

نتیجه مورد انتظار: اقدامات صورت‌حساب حساس در پورتال ارائه‌دهنده امن اتفاق می‌افتد.
6

دسترسی به ویژگی را تأیید کنید

به ویژگی قفل شده برگردید و برنامه را دوباره بارگیری کنید.

نتیجه مورد انتظار: در صورتی که برنامه شامل آن باشد، اکنون ویژگی قفل آن در دسترس است.
نحوه تست کردن: پس از ارتقا، ویژگی قفل شده قبلی مانند کلیدهای شبیه سازی صوتی یا API را باز کنید و تأیید کنید که قفل از بین رفته است.
مشکلرفع کنید
ویژگی پس از ارتقا قفل باقی می ماندبرنامه را بازخوانی کنید، یک لحظه صبر کنید تا اشتراک همگام شود، سپس دوباره صورتحساب را بررسی کنید.
تسویه حساب لغو شدبه Billing برگردید و دوباره پرداخت را شروع کنید. هیچ تغییری در برنامه پس از پرداخت لغو شده اتفاق نمی افتد.
نیاز به تعویض فاکتور یا کارتبه جای ویرایش جزئیات پرداخت در داخل برنامه، پورتال مشتری را باز کنید.

بعد چه باید کرد: هم تیمی ها را دعوت کنید و حساب مالک را ایمن کنید.

تیم و امنیت

هم تیمی ها را دعوت کنید، نقش ها را تنظیم کنید، نمایه را ویرایش کنید، 2FA را فعال کنید و تنظیمات را مدیریت کنید

این برای چیست: هنگامی که فضای کاری از راه اندازی انفرادی به عملیات تیمی می رود از این استفاده کنید.

قبل از شروع
  • قبل از ارسال دعوت نامه، نقش هر هم تیمی را بشناسید.
  • از دسترسی کمترین امتیاز استفاده کنید: مالک، مدیر، ویرایشگر، نمایشگر.
  • یک برنامه احراز هویت برای 2FA آماده داشته باشید.
1

تنظیمات را باز کنید

روی تنظیمات در نوار کناری کلیک کنید.

نتیجه مورد انتظار: عمومی، اعلان‌ها، تیم، گزارش‌ها، توسعه‌دهندگان، امنیت و برگه‌های مرتبط قابل مشاهده هستند.
2

پروفایل و زبان را ویرایش کنید

نام نمایشی، اطلاعات نمایه و زبان ترجیحی را به طور کلی به روز کنید.

نتیجه مورد انتظار: برنامه کاربر را به درستی شناسایی می کند و در صورت وجود از زبان انتخابی استفاده می کند.
3

اعضای تیم را دعوت کنید

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

نتیجه مورد انتظار: هم تیمی یک پیوند دعوت دریافت می کند و تا زمانی که پذیرفته شود در حالت تعلیق ظاهر می شود.
4

مجوزهای نقش را تنظیم کنید

از Owner برای کنترل کامل، Admin برای مدیریت، ویرایشگر برای تغییرات محتوا و Viewer برای دسترسی فقط خواندنی استفاده کنید.

نتیجه مورد انتظار: هر کاربر متناسب با مسئولیت خود دسترسی دارد.
5

اعلان ها را پیکربندی کنید

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

نتیجه مورد انتظار: افراد مناسب بدون سر و صدای غیر ضروری هشدار دریافت می کنند.
6

2FA را فعال کنید

امنیت را باز کنید، احراز هویت دو مرحله‌ای را فعال کنید، کد را اسکن کنید و جزئیات بازیابی را ذخیره کنید.

نتیجه مورد انتظار: حساب به فاکتور دوم بعد از ورود رمز عبور نیاز دارد.
7

از اقدامات منطقه خطر با دقت استفاده کنید

داده‌های مورد نیاز را صادر کنید و ویجت‌ها/ادغام‌های فعال را قبل از اقدامات مخرب حساب تأیید کنید.

نتیجه مورد انتظار: فضای کاری از دست دادن تصادفی داده ها جلوگیری می کند.
نحوه تست کردن: یک هم تیمی آزمایشی را دعوت کنید، دعوت را در یک مرورگر جداگانه بپذیرید و تأیید کنید که نقش فقط ویژگی های مورد نظر را نشان می دهد.
مشکلرفع کنید
ایمیل دعوت وجود نداردهرزنامه را بررسی کنید، دعوت را دوباره ارسال کنید و آدرس را تأیید کنید.
هم تیمی بیش از حد می بیندنقش آنها را پایین بیاورید و تنظیمات دسترسی ربات را بررسی کنید.
راه اندازی 2FA ناموفق استزمان دستگاه را بررسی کنید، کد QR را دوباره اسکن کنید، و جزئیات بازیابی را قبل از تکیه بر آن ذخیره کنید.

بعد چه باید کرد: کلیدهای API را فقط برای کاربران و سرویس هایی که به آنها نیاز دارند پیکربندی کنید.

وابسته

به شرکت وابسته بپیوندید، پیوند ارجاع را کپی کنید، ایمیل پرداخت را تنظیم کنید و درخواست پرداخت کنید

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

قبل از شروع
  • از حسابی استفاده کنید که باید دارای ارجاع ارجاع باشد.
  • قبل از درخواست پرداخت، ایمیل پرداخت را آماده کنید.
  • قبل از انتشار کمپین های ارجاع، قوانین برنامه را بررسی کنید.
1

Affiliate را باز کنید

روی Affiliate در نوار کناری کلیک کنید یا اگر در آنجا پیوند دارید، برگه وابسته را از تنظیمات باز کنید.

نتیجه مورد انتظار: صفحه برنامه وابسته، زمینه های پیوستن، ارجاع، پرداخت و سابقه را نشان می دهد.
2

به برنامه بپیوندید

اگر حساب کاربری هنوز به آن ملحق نشده است، روی Join کلیک کنید.

نتیجه مورد انتظار: کد ارجاع و پیوند ارجاع ایجاد می شود.
3

لینک ارجاع را کپی کنید

پیوند منحصر به فرد را کپی کنید و از آن در محتوا، کمپین ها یا پیام های شریک استفاده کنید.

نتیجه مورد انتظار: ثبت نام از طریق پیوند را می توان به حساب وابسته نسبت داد.
4

تنظیم ایمیل پرداخت

ایمیل پرداخت را وارد کرده و ذخیره کنید.

نتیجه مورد انتظار: پرداخت های واجد شرایط را می توان به درستی هدایت کرد.
5

ارجاعات و کمیسیون ها را بررسی کنید

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

نتیجه مورد انتظار: شما می دانید چه چیزی در انتظار است، واجد شرایط است یا قبلاً پرداخت شده است.
6

درخواست پرداخت

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

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

بعد چه باید کرد: در صورت لزوم از تجزیه و تحلیل و گزارش ها برای نظارت بر تأثیر مشتری ارجاع شده استفاده کنید.

12

اعلان ها و App Updates

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

/ اطلاعیه هامرکز اطلاع رسانی
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1پس از بررسی هشدارهای خوانده نشده، از علامت گذاری همه به عنوان خوانده شده استفاده کنید.
2بر اساس رویدادهای خوانده نشده، صورت‌حساب، پشتیبانی زنده یا رویدادهای سیستم فیلتر کنید.
3پس از خواندن هشدار، ویژگی مربوطه را باز کنید.
/به روز رسانی برنامهفید به‌روزرسانی‌های برنامه
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1یادداشت‌های انتشار را برای ویژگی‌ها و اصلاحات جدید بخوانید.
2قبل از تغییر روند کار، از جزئیات برای آموزش هم تیمی ها استفاده کنید.
3پس از مشاهده تغییرات UI یا رفتار، به روز رسانی ها را بررسی کنید.
اطلاعیه ها

اعلان ها را مرور کنید و بر اساس هشدارها عمل کنید

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

قبل از شروع
  • مطمئن شوید که تنظیمات برگزیده اعلان در تنظیمات تنظیم شده است.
  • در صورت فعال بودن هشدارهای انتقال، پوشش پشتیبانی زنده داشته باشید.
  • قبل از علامت گذاری به عنوان خوانده شده، هشدارهای خوانده نشده را مرور کنید.
1

اعلان ها را باز کنید

روی اعلان‌ها در نوار کناری یا ورودی اعلان هدر برنامه کلیک کنید.

نتیجه مورد انتظار: مرکز اطلاع رسانی هشدارهای اخیر را فهرست می کند.
2

فیلتر هشدارها

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

نتیجه مورد انتظار: فقط هشدارهای منطبق قابل مشاهده هستند.
3

صفحه مربوطه را باز کنید

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

نتیجه مورد انتظار: شما به جای خواندن اعلان، بر اساس آن عمل می کنید.
4

علامت گذاری به عنوان خوانده شده

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

نتیجه مورد انتظار: کاهش تعداد خوانده نشده و موارد مرور شده دیگر برجسته نمی شوند.
5

تنظیمات برگزیده را تنظیم کنید

تنظیمات، اعلان‌ها را در صورت دریافت هشدارهای خیلی زیاد یا خیلی کم باز کنید.

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

بعد چه باید کرد: وقتی رفتار تغییر می کند یا کنترل های جدید ظاهر می شود، App Updates را مرور کنید.

به روز رسانی برنامه

از به‌روزرسانی‌های برنامه برای درک تغییرات محصول استفاده کنید

این برای چیست: از این زمانی استفاده کنید که هم تیمی ها قبل از استفاده از یک ویژگی جدید باید یاد بگیرند که چه چیزی تغییر کرده است.

قبل از شروع
  • به روز رسانی ها را پس از انتشار اصلی یا زمانی که رابط کاربری تغییر می کند باز کنید.
  • یادداشت های به روز رسانی مربوطه را با کاربران پشتیبانی و فروش به اشتراک بگذارید.
  • پس از تغییرات عمده، جریان های کاری حیاتی را مجدداً آزمایش کنید.
1

باز کردن App Updates

روی App Updates در نوار کناری کلیک کنید.

نتیجه مورد انتظار: فید به‌روزرسانی ویژگی‌های جدید، اصلاحات و یادداشت‌های انتشار را نشان می‌دهد.
2

آخرین به روز رسانی را بخوانید

آخرین کارت به‌روزرسانی یا نمای جزئیات را باز کنید.

نتیجه مورد انتظار: شما می بینید که چه چیزی تغییر کرده و بر روی چه جریان کاری تأثیر می گذارد.
3

تغییر را در گردش کار خود ترسیم کنید

مشخص کنید که آیا به‌روزرسانی روی ربات‌ها، ویجت، پشتیبانی، زمان‌بندی، صورت‌حساب یا توسعه‌دهندگان تأثیر می‌گذارد یا خیر.

نتیجه مورد انتظار: اعضای تیم مناسب می دانند چه چیزی را بررسی کنند.
4

مسیرهای حیاتی را مجدداً آزمایش کنید

اگر به‌روزرسانی بر گردش کار تولید تأثیر می‌گذارد، مراحل دستی مربوطه را از این مستندات تکرار کنید.

نتیجه مورد انتظار: تیم تأیید می کند که جریان کاری تغییر یافته همچنان کار می کند.
5

داخلی به اشتراک بگذارید

خلاصه به روز رسانی را برای کاربرانی که مالک منطقه آسیب دیده هستند ارسال کنید.

نتیجه مورد انتظار: پذیرش تیم روان‌تر است و سوالات پشتیبانی کاهش می‌یابد.
نحوه تست کردن: پس از به‌روزرسانی مربوطه، راهنمای ویژگی آسیب‌دیده را تکرار کنید و تأیید کنید که اسکرین‌شات‌ها یا نام‌های مراحل همچنان مطابقت دارند.
مشکلرفع کنید
به روز رسانی به یک ویژگی قفل شده اشاره می کندبرای تأیید اینکه آیا طرح فعلی شامل آن می‌شود یا خیر، «صورت‌حساب» را باز کنید.
تیم تغییر را از دست دادمرور App Updates را به روال عملیات هفتگی یا انتشار اضافه کنید.
اسناد پس از به‌روزرسانی قدیمی به نظر می‌رسنداز راهنمای مهندس برای به روز رسانی اسکرین شات ها و مراحل استفاده کنید.

بعد چه باید کرد: با تکامل ویژگی‌ها، اسناد عمومی را در جریان نگه دارید.

13

دستور العمل های توسعه دهنده

کلیدهای API را ایجاد کنید، از احراز هویت x-api-key استفاده کنید، نقاط پایانی مبتنی بر عمل را فراخوانی کنید، پشتیبانی زنده را به CRM متصل کنید، وب‌قلاب‌ها را ثبت کنید، امضاها را تأیید کنید، و ویجت را در کد جاسازی کنید.

تنظیمات / توسعه دهندگانکلیدهای API، شروع سریع و برگه های usage
اسکرین‌شات واقعی از فضای کاری نمایشی sem.chat
1کلیدهای API را از برگه کلیدهای API ایجاد و لغو کنید.
2برای اولین نمونه های حلقه از Quick Start استفاده کنید.
3قبل از فعال کردن اتوماسیون با حجم بالا، میزان استفاده را مرور کنید.
API شروع سریع

یک کلید API ایجاد کنید و اولین تماس های API را انجام دهید

این برای چیست: از این برای گزارش اسکریپت ها، برنامه های سفارشی، پل های CRM، پشتیبانی زنده خارجی یا اتوماسیون استفاده کنید.

قبل از شروع
  • از محیط سمت سرور استفاده کنید. کلیدهای API را در مرورگر JavaScript در معرض دید قرار ندهید.
  • برای هر ادغام یک کلید جداگانه ایجاد کنید.
  • بلافاصله کلید را کپی کنید زیرا اسرار یک بار نشان داده می شوند.
1

توسعه دهندگان را باز کنید

تنظیمات را باز کرده و Developers را انتخاب کنید یا در صورت وجود از تغییر مسیر Developers استفاده کنید.

نتیجه مورد انتظار: کلیدهای API، Quick Start، اسناد و برگه‌های استفاده قابل مشاهده هستند.
2

یک کلید تولید کنید

روی Generate Key کلیک کنید، یک برچسب واضح به آن بدهید و بلافاصله آن را کپی کنید.

نتیجه مورد انتظار: کلید با sk_live_ شروع می شود و برای درخواست های سمت سرور در دسترس است.
3

هدر x-api-key را ارسال کنید

در هر درخواست عمومی API x-api-key را وارد کنید.

نتیجه مورد انتظار: عمومی API می‌تواند درخواست را احراز هویت کند و آن را به مالک اختصاص دهد.
4

لیست ربات ها

برای پیدا کردن شناسه ربات مورد نیاز خود، action=list-bots را فراخوانی کنید.

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

یک پیام chat ارسال کنید

POST اقدام chat با botId و پیام.

نتیجه مورد انتظار: پاسخ اطلاعات پاسخ، مدل و usage را برمی گرداند.
6

usage را بررسی کنید

قبل از اجرای کارهای با حجم بالا، اقدام =usage را فراخوانی کنید.

نتیجه مورد انتظار: شما از طرح فعلی و وضعیت usage قبل از اجرای اتوماسیون مطلع هستید.
7

در صورت نیاز کلیدها را بچرخانید

کلیدهای استفاده نشده را باطل کنید و کلیدهای جدیدی را برای فروشندگان یا خدمات تغییر یافته ایجاد کنید.

نتیجه مورد انتظار: سرویس های قدیمی نمی توانند به استفاده از اعتبارنامه های قدیمی ادامه دهند.
نحوه تست کردن: list-bots و chat را از ترمینال یا محیط سرور محلی اجرا کنید، سپس تأیید کنید که اگر chat ارسال شده باشد، مکالمه در Chat History نشان داده شود.
مشکلرفع کنید
401 یا پاسخ غیرمجازاملای x-api-key را بررسی کنید، کلید کامل را کپی کنید و تأیید کنید که باطل نشده است.
ربات پیدا نشددوباره از list-bots استفاده کنید و تأیید کنید که ربات متعلق به مالک کلید API است.
مشکل CORS مرورگرتماس API را به باطن خود منتقل کنید. کلیدهای API برای استفاده در سمت سرور در نظر گرفته شده اند.

بعد چه باید کرد: از /api-docs برای مرجع نقطه پایان متمرکز استفاده کنید و این صفحه را به عنوان راهنمای گردش کار نگه دارید.

لیست ربات ها
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
  -H "x-api-key: sk_live_your_key_here"
یک پیام chat ارسال کنید
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "chat",
    "botId": "YOUR_BOT_ID",
    "message": "What can you help me with?"
  }'
پل CRM پشتیبانی زنده

نظرسنجی یا ارسال درخواست های پشتیبانی زنده به CRM

این برای چیست: هنگامی که نمایندگان در سیستم دیگری کار می کنند اما sem.chat مکالمه بازدیدکننده را دریافت می کند، از این استفاده کنید.

قبل از شروع
  • یک کلید API اختصاصی به نام پل CRM ایجاد کنید.
  • تصمیم بگیرید که آیا نظرسنجی یا وب هوک ها متناسب با زیرساخت شما هستند.
  • مطمئن شوید CRM شناسه‌های مکالمه را برای پاسخ‌ها/رزولوشن‌های آینده ذخیره می‌کند.
1

لیستی از موارد انتظار

GET اقدام=live-support-list با وضعیت=درخواست یا وضعیت=همه.

نتیجه مورد انتظار: CRM conversations باز را دریافت می کند که به توجه انسان نیاز دارد.
2

واکشی پیام ها

GET اقدام=live-support-messages با conversationId.

نتیجه مورد انتظار: CRM دارای زمینه کامل رشته و جزئیات بازدیدکننده است.
3

قبل از پاسخگویی ادعا کنید

POST اقدام=live-support-claim.

نتیجه مورد انتظار: sem.chat مکالمه را به‌عنوان فعالانه مدیریت علامت‌گذاری می‌کند.
4

ارسال پاسخ نماینده

POST اقدام=live-support-reply با conversationId، پیام و نام عامل.

نتیجه مورد انتظار: بازدید کننده پاسخ انسانی و به روز رسانی موضوع را دریافت می کند.
5

حل و فصل یا دست به عقب

POST اقدام=live-support-resolve با وضوح تفکیک یا بازگرداندن دست.

نتیجه مورد انتظار: مکالمه از صف انتظار خارج می شود یا هوش مصنوعی کنترل را از سر می گیرد.
6

وضعیت گزارش در CRM

آخرین وضعیت انتقال، شناسه پیام و مُهرهای زمانی را ذخیره کنید.

نتیجه مورد انتظار: CRM و sem.chat قابل بازرسی هستند.
نحوه تست کردن: یک انتقال امن ایجاد کنید، آن را به CRM منعکس کنید، از پل پاسخ دهید و به‌روزرسانی‌های رشته بازدیدکننده را تأیید کنید.
مشکلرفع کنید
بلیط های CRM تکراریاز conversationId به عنوان کلید عدم توانایی در پل CRM خود استفاده کنید.
پاسخ ها خارج از نظم می رسندمهرهای زمانی پیام را ذخیره کنید و از پاسخ های همزمان از چندین سیستم خودداری کنید.
در حالی که عامل کار می کند هوش مصنوعی پاسخ می دهدپس از اتمام کار نماینده، ابتدا و تنها دست را پس بگیرید.

بعد چه باید کرد: اگر نظرسنجی خیلی کند یا گران است، وب هوک ها را ثبت کنید.

وب هوک ها

ثبت وب هوک ها و تأیید X-SemChat-Signature

این برای چیست: هنگامی که سیستم شما به رویدادهای بلادرنگ برای ارسال، پیام ها و به روز رسانی وضوح نیاز دارد از این استفاده کنید.

قبل از شروع
  • Webhook URL باید HTTPS باشد و از اینترنت عمومی قابل دسترسی باشد.
  • راز وب هوک را فورا ذخیره کنید. یک بار نشان داده می شود
  • قبل از پردازش رویدادها، امضاها را تأیید کنید.
1

وب هوک را ثبت کنید

عملکرد POST webhook-register با نشانی وب و رویدادها.

نتیجه مورد انتظار: پاسخ شامل جزئیات وب هوک و راز امضای یکباره است.
2

راز را ذخیره کنید

راز را در محیط سرور یا مدیر مخفی خود ذخیره کنید.

نتیجه مورد انتظار: تحویل های آینده را می توان تأیید کرد.
3

تایید امضا

X-SemChat-Signature را بخوانید و آن را با HMAC SHA-256 در متن درخواست خام مقایسه کنید.

نتیجه مورد انتظار: فقط تحویل sem.chat واقعی پذیرفته می شود.
4

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

از شناسه رویداد یا شناسه مکالمه/پیام برای جلوگیری از پردازش تکراری استفاده کنید.

نتیجه مورد انتظار: تلاش های مجدد، رکوردهای CRM تکراری ایجاد نمی کند.
5

وب هوک ها را فهرست کنید

GET اقدام webhook-list برای بازرسی نقاط پایانی پیکربندی شده.

نتیجه مورد انتظار: می‌توانید URLها، رویدادها، وضعیت فعال و وضعیت تحویل اخیر را ببینید.
6

وب هوک های قدیمی را حذف کنید

POST اقدام webhook-delete با شناسه webhook.

نتیجه مورد انتظار: نقاط پایانی قدیمی دیگر رویدادها را دریافت نمی کنند.
نحوه تست کردن: یک نقطه پایانی آزمایشی را ثبت کنید، یک رویداد پشتیبانی زنده را راه اندازی کنید، امضا را تأیید کنید و تأیید کنید که کنترل کننده شما 2xx را برمی گرداند.
مشکلرفع کنید
امضا مطابقت ندارداز متن خام، تجزیه نشده JSON استفاده کنید و راز وب هوک صحیح را تأیید کنید.
Webhook هیچ رویدادی دریافت نمی کندتأیید کنید که فهرست رویداد شامل رویدادی است که در حال آزمایش آن هستید و نقطه پایانی HTTPS است.
زمان وب هوک تمام می شودبه سرعت تصدیق کنید و کارهای طولانی را به صورت ناهمزمان پردازش کنید.

بعد چه باید کرد: برای جزئیات و مثال‌های نقطه پایانی، مهندسان را به /api-docs پیوند دهید.

ثبت وب هوک
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "webhook-register",
    "url": "https://your-crm.example.com/semchat/webhook",
    "events": ["handoff.requested", "message.user", "handoff.resolved"]
  }'
تأیید امضای وب هوک
import crypto from 'node:crypto';

function verifySemChatSignature(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature || ''),
    Buffer.from(expected)
  );
}
نقشه نقطه پایانی

از عمومی مبتنی بر عمل API به درستی استفاده کنید

این برای چیست: از این هنگام انتخاب عملکرد مناسب برای یک ویژگی استفاده کنید.

قبل از شروع
  • هر درخواست از همان تابع public-api URL استفاده می کند.
  • اقدامات GET از پارامترهای پرس و جو استفاده می کنند. عملکردهای POST از متن JSON استفاده می کنند.
  • برای همه درخواست‌ها x-api-key را ارسال کنید.
نحوه تست کردن: پس از هر تغییر کلید API یا نقطه پایانی، با usage و list-bots به عنوان تست دود تماس بگیرید.
مشکلرفع کنید
عدم تطابق روشاز روش نشان داده شده در جدول پایانی استفاده کنید. برخی از اقدامات فقط GET یا POST-فقط هستند.
مقدار لازم وجود نداردbotId، conversationId، شناسه webhook و املای عمل را بررسی کنید.

بعد چه باید کرد: برای اولین درخواست از Quick Start و سپس برای مرجع کامل از /api-docs استفاده کنید.

روشاقدامهدف
GETlist-botsفهرست همه ربات‌های موجود برای مالک کلید API.
GETget-botیک پیکربندی ربات را با شناسه ربات واکشی کنید.
POSTchatیک پیام بازدیدکننده به یک ربات بفرستید و پاسخ هوش مصنوعی را برگردانید.
GETconversationsconversations اخیر را برای یک ربات، تا 100 رکورد فهرست کنید.
GETusageطرح بازگشت، اعتبار، تعداد ربات، conversations، و کلید API usage.
GETlive-support-listفهرست conversations در انتظار یا اداره شده توسط یک عامل انسانی.
GETlive-support-messagesیک رشته انتقال با پیام‌ها و اطلاعات بازدیدکنندگان را واکشی کنید.
POSTlive-support-replyیک پاسخ عامل انسانی از یک سیستم خارجی ارسال کنید.
POSTlive-support-claimادعای یک مکالمه تحویل در انتظار.
POSTlive-support-resolveکنترل انتقال یا بازگشت به هوش مصنوعی را حل کنید.
POSTwebhook-registerیک نقطه پایانی وب هوک HTTPS ثبت کنید.
GETwebhook-listثبت نام های وب هوک را بدون بازگشت اسرار فهرست کنید.
POSTwebhook-deleteحذف ثبت وب هوک با شناسه
14

راهنمای مهندس: اضافه کردن ویژگی ها

مسیرها، پیمایش داشبورد، تنظیمات سازنده ربات، جداول/توابع/ مهاجرت Supabase، اسناد API، اسناد عمومی، بررسی های سئو و تأیید محلی را اضافه کنید.

گردش کار ویژگی برنامه

مسیر برنامه، صفحه، مورد پیمایش و ورودی اسناد را اضافه کنید

این برای چیست: هنگام افزودن ویژگی جدید داشبورد مربوط به مشتری، از این مورد استفاده کنید.

قبل از شروع
  • قبل از ویرایش یک شعبه ایجاد کنید.
  • مشخص کنید که آیا این ویژگی به مخزن برنامه تعلق دارد یا مخزن ظاهری sem.chat عمومی.
  • قبل از افزودن ساختار جدید، الگوهای مسیر، نوار کناری، i18n و تنظیمات موجود را بررسی کنید.
1

مسیر را اضافه کنید

src/App.tsx را با یک مسیر محافظت شده برای صفحات مشتری یا یک مسیر عمومی فقط زمانی که صفحه باید عمومی باشد به روز کنید.

نتیجه مورد انتظار: URL بدون زدن NotFound در برنامه حل می شود.
2

مؤلفه صفحه را ایجاد یا به روز کنید

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

نتیجه مورد انتظار: این ویژگی با داشبورد سازگار است.
3

ناوبری داشبورد را اضافه کنید

در صورت نیاز، منبع نوار کناری/ناوبری را با برچسب، نماد، مسیر و گیت‌های پلان به‌روزرسانی کنید.

نتیجه مورد انتظار: کاربران می توانند صفحه جدید را از پوسته برنامه کشف کنند.
4

برگه یا تنظیمات سازنده ربات را اضافه کنید

اگر این ویژگی متعلق به یک ربات است، آن را در برگه های Bot Builder اضافه کنید و آن را از طریق جریان های ذخیره موجود ادامه دهید.

نتیجه مورد انتظار: پیکربندی ربات خاص با ربات ذخیره می شود، نه در حالت محلی.
5

تغییرات Supabase طرح/تابع را اضافه کنید

مهاجرت برای جداول/خط مشی ها و توابع لبه برای کارهای سمت سرور ایجاد کنید.

نتیجه مورد انتظار: رفتار پایگاه داده و سرور را می توان به طور تکراری مستقر کرد.
6

شکل API را در صورت عمومی به‌روزرسانی کنید

مدیریت کنش را در supabase/functions/public-api/index.ts و رفتار x-api-key را اضافه یا گسترش دهید.

نتیجه مورد انتظار: ادغام ها می توانند با خیال راحت از این ویژگی استفاده کنند.
7

اسناد برنامه و اسناد عمومی را به روز کنید

اسناد توسعه‌دهنده درون‌برنامه و این صفحه / اسناد را با تصاویر صفحه و مراحل کلیک به کلیک به‌روزرسانی کنید.

نتیجه مورد انتظار: کاربران و مهندسان این ویژگی را در هر دو مکان مشاهده می کنند.
8

چک ها را اجرا کنید

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

نتیجه مورد انتظار: این ویژگی به صورت محلی کار می کند و سایت عمومی قابل خزیدن باقی می ماند.
نحوه تست کردن: مسیر جدید را باز کنید، از پایان به انتها ویژگی استفاده کنید، خطاهای کنسول/شبکه را بررسی کنید و هرگونه تغییر پایگاه داده را از UI بررسی کنید.
مشکلرفع کنید
Route کار می کند اما nav روشن نمی کندتطبیق مسیر نوار کناری و مسیرهای تغییر مسیر را بررسی کنید.
داده ها به صورت محلی کار می کنند اما مستقر نمی شوندمهاجرت، سیاست های RLS و متغیرهای محیط تابع لبه را تأیید کنید.
اسناد عمومی از نقشه سایت گم شده استبهینه ساز SEO را اجرا کنید و sitemap.xml را برای URL متعارف بررسی کنید.

بعد چه باید کرد: هر زمان که رابط کاربری تغییر می کند، اسکرین شات های مستند را ضبط یا بازسازی کنید.

گردش کار نگهداری اسناد

این صفحه اسناد عمومی را پس از تغییرات محصول به روز کنید

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

قبل از شروع
  • فقط از داده های آزمایشی ایمن استفاده کنید.
  • هرگز مشتریان واقعی، ایمیل‌ها، جزئیات پرداخت، کلیدهای API یا conversations خصوصی را در معرض نمایش قرار ندهید.
  • ابتدا راهنمای انگلیسی را به‌روزرسانی کنید، سپس پیش از بررسی‌های SEO هر صفحه مستندات بومی‌سازی‌شده را تازه‌سازی کنید.
1

مسیر تغییر یافته را بررسی کنید

مسیر برنامه را باز کنید و تشخیص دهید که چه چیزی از نظر بصری و رویه ای تغییر کرده است.

نتیجه مورد انتظار: می‌دانید که کدام ردیف‌های راهنما، عکس صفحه و عیب‌یابی نیاز به ویرایش دارند.
2

یک اسکرین شات امن بگیرید یا ایجاد کنید

قبل از ذخیره دارایی های WebP در زیر دارایی ها/اسناد، از یک فضای کاری آزمایشی استفاده کنید و اسرار را پنهان کنید.

نتیجه مورد انتظار: اسکرین شات دقیق و ایمن برای انتشار است.
3

راهنما را به روز کنید

بخش‌های مربوطه را ویرایش کنید، قبل از شروع، مراحل، نتایج مورد انتظار، تست، عیب‌یابی و بعدی.

نتیجه مورد انتظار: راهنما به کاربران می گوید که چه چیزی را کلیک کنند و بعد از هر کلیک چه اتفاقی باید بیفتد.
4

در صورت نیاز، ناوبری را به روز کنید

اگر یک صفحه اصلی است، بخش را به TOC چسبنده، انتخابگر بخش تلفن همراه و فهرست بصری اضافه کنید.

نتیجه مورد انتظار: خوانندگان می توانند مطالب جدید را به سرعت پیدا کنند.
5

ابزار سئو را اجرا کنید

node tools/seo-optimize-static-pages.js و node tools/seo-optimize-static-pages.js --را اجرا کنید.

نتیجه مورد انتظار: خروجی Canonical، Metadata، Sitemap و Robots درست باقی می مانند.
6

بررسی های پاکسازی و تفاوت را اجرا کنید

ابزار node/static-translation-cleanup.js --audit و git diff را اجرا کنید --بررسی کنید.

نتیجه مورد انتظار: ترجمه های ایستا و فضای خالی تمیز هستند.
7

بررسی مرورگر

سایت را به صورت محلی ارائه دهید و / اسناد را روی دسکتاپ و موبایل آزمایش کنید.

نتیجه مورد انتظار: تصاویر بارگیری می‌شوند، جستجو کار می‌کند، دکمه‌های کپی کار می‌کنند، موارد برجسته TOC، و طرح‌بندی با بنر کوکی همپوشانی ندارد.
نحوه تست کردن: نام ویژگی تغییر یافته را در /documentation جستجو کنید و تأیید کنید که بلوک راهنمای صحیح ظاهر می شود.
مشکلرفع کنید
نشانگرهای اسکرین شات در موبایل جابجا می شوندنشانگرها را در داخل تصویر اسکرین شات نگه دارید یا از مختصات نشانگر پاسخگو استفاده کنید.
جستجو راهنمای جدید را از دست می دهدکلمات کلیدی مفیدی را به عنوان داده اضافه کنید و عبارات دقیق محصولی را که کاربران جستجو می‌کنند درج کنید.
مستندات بومی‌سازی‌شده قدیمی می‌شوندپس از ویرایش راهنمای انگلیسی، هر صفحه مستندات بومی‌سازی‌شده را تازه‌سازی کنید، بهینه‌ساز SEO را دوباره اجرا کنید و تأیید کنید که sitemap.xml شامل همه URLهای مستندات است.

بعد چه باید کرد: تغییرات صفحه اسناد، دارایی‌ها، پیوندهای سرصفحه/پانویس، htaccess. و نقشه سایت را با هم انجام دهید.

به مرجع API متمرکز نیاز دارید؟

صفحه قدیمی /api-docs برای جزئیات API سطح پایانی در دسترس باقی می ماند.

API Docs را باز کنید