افزونه وردپرس آیوا: نصب و همگام‌سازی خودکار نوشته‌ها
آموزش نصب افزونه وردپرس آیوا: دانلود از داشبورد، واردکردن سه مقدار تنظیمات، نمایش خودکار ویجت چت در همه صفحه‌ها و همگام‌سازی نوشته‌ها با پایگاه دانش.
اگر سایتتان وردپرسی است، برای راه‌اندازی چت‌بات معمولاً دو دغدغه دارید. اول اینکه کد ویجت را کجای قالب بگذارید که با به‌روزرسانی قالب پاک نشود. دوم اینکه هر بار نوشته تازه‌ای منتشر می‌کنید یا نوشته قدیمی را اصلاح می‌کنید، دانش چت‌بات هم به‌روز شود و از روی مطلب کهنه جواب ندهد.
افزونه وردپرس آیوا هر دو کار را انجام می‌دهد. ویجت چت را خودکار در همه صفحه‌های سایت نمایش می‌دهد و نوشته‌های منتشرشده را به پایگاه دانش دستیار می‌فرستد؛ بعد از آن هم هر انتشار، ویرایش یا حذف را خودش همگام می‌کند.
در این راهنما نصب افزونه را قدم‌به‌قدم می‌بینید، از دانلود در داشبورد آیوا تا بررسی نهایی. افزونه وردپرس از پلن آیوا هوشمند به بالا در دسترس است.
افزونه وردپرس آیوا چه کارهایی انجام می‌دهد؟
- نمایش ویجت در همه صفحه‌ها: ویجت چت را در پانویس همه صفحه‌های سایت قرار می‌دهد، بدون اینکه به فایل‌های قالب دست بزنید.
- همگام‌سازی نوشته‌ها: هنگام فعال‌سازی، نوشته‌های منتشرشده را به پایگاه دانش می‌فرستد. بعد از آن، انتشار، ویرایش، انتقال به زباله‌دان و حذف هر نوشته را خودکار اعمال می‌کند. اگر نوشته‌ای را از زباله‌دان برگردانید، دوباره به پایگاه دانش اضافه می‌شود.
- سفارش‌های مشتری واردشده: در فروشگاه‌های ووکامرسی که اتصال ووکامرس آیوا را هم راه انداخته‌اند، مشتری‌ای که وارد حساب کاربری‌اش شده، می‌تواند سفارش‌های خودش را در چت بپرسد، بدون اینکه شماره سفارش و ایمیل بدهد.
پیش‌نیازها
- پلن آیوا هوشمند یا آیوا ژرف
- وردپرس نسخه ۵٫۹ یا بالاتر و PHP نسخه ۷٫۴ یا بالاتر
- دسترسی مدیر به پیشخوان وردپرس برای نصب افزونه
- دستیاری که در آیوا ساخته‌اید و پایگاه دانش اولیه‌اش آماده است؛ اگر هنوز دستیاری ندارید، آموزش ساخت چت‌بات با آیوا را ببینید.
قدم اول: دانلود افزونه از داشبورد آیوا
به مرحله آخر ساخت دستیار بروید؛ همان صفحه‌ای که با عنوان «تبریک! دستیار شما آماده است» باز می‌شود. در بخش «نصب در سایت» سه گزینه می‌بینید: HTML/JS برای اکثر سایت‌ها، «API / ویجت» برای توسعه‌دهندگان و PLUGIN برای سایت‌های وردپرسی. گزینه سوم را انتخاب کنید و دکمه «دانلود» را بزنید تا فایل zip افزونه دریافت شود.
در همین بخش سه مقدار با دکمه کپی نمایش داده می‌شود: BaseUrl، Uuid و Secret. این صفحه را باز نگه دارید؛ در قدم سوم به هر سه نیاز دارید. اگر بعداً خواستید به این صفحه برگردید، از میزکار به «مدیریت چت‌بات» بروید، از منوی دستیار «ویرایش» را بزنید و به مرحله انتشار بروید. در پلن‌های پایین‌تر، این بخش غیرفعال است و عبارت «در پلن آیوا هوشمند فعال است» را می‌بینید.
قدم دوم: نصب افزونه در وردپرس
- در پیشخوان وردپرس به منوی افزونه‌ها بروید و گزینه افزودن را بزنید.
- بارگذاری افزونه را انتخاب کنید، فایل zip دریافت‌شده را بدهید و نصب کنید.
- افزونه را فعال کنید. نام افزونه در فهرست افزونه‌های وردپرس Aiva است.
قدم سوم: واردکردن تنظیمات
در پیشخوان وردپرس به «تنظیمات ← Aiva» بروید و سه مقداری را که در داشبورد آیوا دیدید، این‌طور وارد کنید:
| مقدار در داشبورد آیوا | فیلد در تنظیمات افزونه | کاربرد |
|---|---|---|
BaseUrl |
API URL |
نشانی سرور آیوا که ویجت و همگام‌سازی از آن استفاده می‌کنند |
Uuid |
Bot UUID |
شناسه دستیار شما |
Secret |
Webhook Secret |
رمزی که نشان می‌دهد پیام‌های همگام‌سازی واقعاً از سایت شما آمده‌اند |
بعد تغییرات را ذخیره کنید. Webhook Secret را مثل رمز عبور محرمانه نگه دارید و جایی منتشر نکنید.
در همین صفحه دو فیلد دیگر هم برای کلیدهای ووکامرس (WC Consumer Key و WC Consumer Secret) می‌بینید. ابزارهای فروشگاهی دستیار با کلیدهایی کار می‌کنند که در کارت «ووکامرس» داشبورد آیوا ثبت می‌کنید؛ روش ساختن و ثبت آن‌ها را در چت‌بات هوشمند ووکامرس توضیح داده‌ایم.
قدم چهارم: همگام‌سازی اولیه نوشته‌ها
همگام‌سازی اولیه، یعنی فرستادن همه نوشته‌های منتشرشده، در لحظه فعال شدن افزونه اجرا می‌شود و برای این کار به همان سه مقدار تنظیمات نیاز دارد. چون معمولاً تنظیمات را بعد از فعال‌سازی وارد می‌کنید، بعد از ذخیره تنظیمات یک بار افزونه را غیرفعال و دوباره فعال کنید تا نوشته‌های قبلی هم فرستاده شوند. از آن به بعد، هر نوشته تازه یا ویرایش‌شده خودکار به پایگاه دانش می‌رود.
چند نکته درباره همگام‌سازی:
- فقط نوشته‌های منتشرشده فرستاده می‌شوند، نه پیش‌نویس‌ها.
- همگام‌سازی اولیه فقط نوشته‌ها را شامل می‌شود، نه برگه‌ها. برای برگه‌های مهمی مثل «درباره ما» یا «شرایط ارسال»، از «افزودن لینک وب‌سایت» یا بارگذاری فایل در پایگاه دانش استفاده کنید؛ جزئیات را در آموزش پایگاه دانش آیوا ببینید.
- نوشته‌های همگام‌شده در فهرست فایل‌های پایگاه دانش دیده نمی‌شوند. برای اطمینان، از دستیار سؤالی بپرسید که جوابش فقط در یکی از نوشته‌هاست.
نکته: نوشته‌های همگام‌شده هم از سهمیه کاراکتر پایگاه دانش کم می‌کنند؛ سهمیه پلن آیوا هوشمند ۳ میلیون کاراکتر است. اگر سهمیه پر شود، نوشته‌های تازه به پایگاه دانش اضافه نمی‌شوند. پس فایل‌ها و محتوای قدیمی و بی‌استفاده را از پایگاه دانش پاک کنید تا جا برای مطالب تازه بماند.
قدم پنجم: بررسی نصب
- سایت را در یک پنجره ناشناس مرورگر باز کنید. دکمه ویجت باید در گوشه پایین صفحه، همان سمتی که در تنظیمات ظاهری انتخاب کرده‌اید، دیده شود.
- اگر ویجت را نمی‌بینید، اول مقدارهای تنظیمات را دوباره بررسی کنید که فاصله یا نویسه اضافه نداشته باشند. اگر افزونه کش یا شبکه توزیع محتوا دارید، کش را پاک کنید و چند دقیقه صبر کنید.
- لازم نیست کد HTML ویجت را جداگانه در قالب بگذارید؛ افزونه این کار را انجام می‌دهد. اگر قبلاً کد را دستی اضافه کرده‌اید، آن را بردارید.
- درباره موضوع یکی از نوشته‌های اخیر سؤال بپرسید تا مطمئن شوید همگام‌سازی کار می‌کند.
نوشته‌ها را طوری بنویسید که دستیار هم خوب بفهمد
وقتی نوشته‌های سایت منبع جواب‌های دستیار می‌شوند، کیفیت هر نوشته مستقیم روی کیفیت جواب اثر می‌گذارد. دستیار برای جواب دادن کل نوشته را یک‌جا نمی‌خواند؛ بخش‌های مرتبط با سؤال را پیدا می‌کند و از روی همان‌ها جواب می‌نویسد. چند عادت ساده کمک می‌کند:
- برای هر بخش تیتر روشن بگذارید؛ «هزینه ارسال به شهرستان» بهتر از «نکته مهم» است.
- قیمت، زمان و شرایط را صریح و با واحد بنویسید؛ «۳ روز کاری»، نه «چند روز».
- اگر قانونی عوض شد، همان نوشته قبلی را ویرایش کنید، نه اینکه نوشته تازه‌ای با اطلاعات متناقض منتشر کنید. با ویرایش، نسخه قبلی از پایگاه دانش برداشته و نسخه تازه جایگزینش می‌شود.
فهرست کامل این نکته‌ها را در چک‌لیست آماده‌سازی محتوا برای آموزش چت‌بات آورده‌ایم.
سفارش‌های مشتری واردشده در ووکامرس
اگر فروشگاه ووکامرسی دارید و اتصال ووکامرس را در داشبورد آیوا راه انداخته‌اید، افزونه برای هر مشتری واردشده یک شناسه امضاشده و کوتاه‌مدت می‌سازد. دستیار با این شناسه می‌فهمد مشتری کیست و وقتی بپرسد «سفارش‌هایم چه شد؟»، سفارش‌های اخیر خود او را نشان می‌دهد؛ بدون پرسیدن شماره سفارش و ایمیل. مشتری‌های مهمان همچنان با شماره سفارش و ایمیل، سفارششان را پیگیری می‌کنند.
سؤالات متداول
افزونه بدون ووکامرس هم کار می‌کند؟
بله. بدون ووکامرس هم ویجت نمایش داده می‌شود و نوشته‌ها همگام می‌شوند. فقط بخش سفارش‌های مشتری واردشده به ووکامرس نیاز دارد.
اگر نوشته‌ای را حذف کنم، دستیار هنوز از روی آن جواب می‌دهد؟
نه. وقتی نوشته‌ای را به زباله‌دان ببرید یا حذف کنید، از پایگاه دانش هم برداشته می‌شود. این یکی از مزیت‌های همگام‌سازی خودکار است؛ درباره اهمیتش در به‌روز نگه داشتن چت‌بات بیشتر نوشته‌ایم.
می‌توانم ویجت را فقط در بعضی صفحه‌ها نشان دهم؟
افزونه ویجت را در همه صفحه‌ها نمایش می‌دهد. اگر ویجت را فقط در صفحه‌های خاصی می‌خواهید، به‌جای افزونه کد ویجت را در همان صفحه‌ها بگذارید؛ روشش در نصب چت‌بات روی سایت با یک خط کد آمده است. در این حالت همگام‌سازی خودکار نوشته‌ها را نخواهید داشت.
نوشته تازه‌ای منتشر کردم، اما دستیار هنوز از آن جواب نمی‌دهد. چرا؟
چند دقیقه صبر کنید؛ پردازش نوشته کمی زمان می‌برد. اگر باز هم جواب نداد، سه چیز را بررسی کنید: مقدارهای تنظیمات افزونه درست باشند، اشتراک دستیار روی آیوا هوشمند یا بالاتر فعال باشد و سهمیه کاراکتر پایگاه دانش پر نشده باشد.
همگام‌سازی تا کی ادامه دارد؟
تا وقتی اشتراک دستیار روی پلن آیوا هوشمند یا آیوا ژرف فعال است. اگر اشتراک تمام شود، همگام‌سازی نوشته‌های تازه هم متوقف می‌شود.
جمع‌بندی
افزونه وردپرس آیوا دو کار تکراری را از دوش شما برمی‌دارد: نصب ویجت در قالب و به‌روز نگه داشتن دانش دستیار با هر نوشته تازه. کافی است افزونه را از داشبورد دانلود کنید، سه مقدار BaseUrl، Uuid و Secret را در تنظیمات وارد کنید و یک بار افزونه را دوباره فعال کنید تا نوشته‌های قبلی هم فرستاده شوند.
اگر هنوز دستیاری نساخته‌اید، ساخت دستیار را رایگان در آیوا شروع کنید؛ پایگاه دانش را در دوره آزمایشی آماده کنید و برای نصب افزونه، پلن آیوا هوشمند را فعال کنید.