راهاندازی API چتبات
اتصال بات آموزشدیده به اپلیکیشن، سایت سفارشی یا بکاند — با REST API و توکن احراز هویت.
زمان تقریبی راهاندازی: ۲۰ دقیقه
مراحل مشترک (صفر تا صد)
ثبتنام، کیف پول، ساخت بات و … — کلیک برای نمایش
مراحل مشترک (صفر تا صد)
ثبتنام، کیف پول، ساخت بات و … — کلیک برای نمایش
ثبتنام و ورود به پنل
در شاپ پیلوت ثبتنام کنید یا وارد حساب شوید. پس از ورود به داشبورد دسترسی به همه بخشها خواهید داشت.
شارژ کیف پول
برای خرید سرویس ماهانه یا فعالسازی Pay as you go، ابتدا کیف پول را شارژ کنید. حداقل مبلغ شارژ در صفحه کیف پول نمایش داده میشود.
خرید سرویس مناسب
از بخش «خرید سرویس» نوع سرویس (وردپرس، فروش اجتماعی، وبسایت هوشمند یا API) و روش پرداخت (ماهانه یا Pay as you go) را انتخاب کنید.
ساخت بات
از منوی «باتها → ایجاد بات» یک بات جدید بسازید. بات در ابتدا با وضعیت «منتظر آموزش» ایجاد میشود.
آموزش بات
هویت، لحن و دانش فروشگاه را در بخش «آموزش بات» تعریف کنید. اسکیلهای فروش (معرفی محصول، پیگیری سفارش و …) را فعال کنید. پس از ذخیره، بات فعال میشود.
اتصال بات به سرویس
در «سرویسهای من» بات ساختهشده را به سرویس خریداریشده متصل کنید. هر سرویس فقط یک بات فعال دارد.
شخصیسازی ظاهر ویجت
رنگها، آواتار، پیام خوشآمد و هدر چت را از بخش «استایل بات» تنظیم کنید تا با برند شما هماهنگ شود.
راهاندازی نهایی سرویس
بسته به نوع سرویس: افزونه وردپرس را نصب کنید، محصولات را اضافه کنید، ویجت را embed کنید یا API را فراخوانی کنید. راهنمای اختصاصی هر سرویس را در ادامه ببینید.
تست و بهرهبرداری
با «مکالمه آزمایشی» یا بازدید از سایت خود، چند سؤال نمونه بپرسید. مکالمات را از بخش «گفتوگوها» پیگیری کنید.
این سرویس برای چه کسانی است؟
توسعهدهندگان و استارتاپها
اگر سایت شما Laravel، React، موبایل یا هر پلتفرم سفارشی است و میخواهید چت هوشمند را در UI خود داشته باشید.
تفاوت با ویجت embed
ویجت embed برای نمایش سریع iframe است. API برای کنترل کامل UI، ذخیره تاریخچه در سیستم خود و یکپارچهسازی عمیق مناسب است.
مراحل راهاندازی
دریافت bot_uid و API Token
bot_uid از لیست باتها و api_key (توکن API) از تنظیمات پروفایل. هر دو در «سرویسهای من» برای سرویس API نمایش داده میشوند.
فراخوانی API
ارسال پیام
درخواست POST به /chat/template با فیلدهای text، bot_uid و api_key. پاسخ JSON شامل text، suggest و action است.
نمونه درخواست
نمونه curl:
curl -X POST http://localhost:8000/chat/template \
-H "Content-Type: application/json" \
-d '{
"text": "سلام، چه محصولاتی دارید؟",
"bot_uid": "YOUR_BOT_UID",
"api_key": "YOUR_API_TOKEN",
"guest_key": "optional-guest-id"
}'نکات یکپارچهسازی
guest_key
برای حفظ تاریخچه مکالمه هر کاربر، یک شناسه یکتا (UUID) به عنوان guest_key ارسال کنید.
پاسخ HTML
فیلد text ممکن است شامل HTML باشد. در UI خود آن را sanitize و render کنید.
پیشنهادها (suggest)
آرایه suggest دکمههای پیشنهادی بعدی را برمیگرداند — میتوانید به عنوان quick reply نمایش دهید.
نکات کاربردی
- API Token را فقط در سمت سرور نگه دارید — هرگز در کد فرانتاند عمومی قرار ندهید.
- برای توسعه از Pay as you go استفاده کنید تا فقط به ازای مصرف هزینه پرداخت کنید.
- مستندات کامل endpointها در صفحه مستندات API موجود است.
سایر راهنماها
راهاندازی چتبات فروش وردپرس
راهنمای گامبهگام اتصال فروشگاه ووکامرس به شاپ پیلوت — از خرید سرویس تا نمایش ویجت چت و ثبت سفارش از گفتگو.
مشاهده آموزشراهاندازی چتبات فروش اجتماعی
فروش در اینستاگرام و شبکههای اجتماعی بدون وبسایت — لینک چت اختصاصی، محصولات دستی و ویجت embed.
مشاهده آموزشسفارش وبسایت هوشمند
پیادهسازی اختصاصی وبسایت مجهز به هوش مصنوعی — مثل طراحی سایت. فقط از طریق تماس با پشتیبانی قابل سفارش است؛ کارشناس جزئیات را میگیرد و تیم اجرا میکند.
مشاهده آموزشآماده فعالسازی API چتبات — اتصال به سایت سفارشی هستید؟
وارد پنل شوید، سرویس را بخرید و طبق این راهنما راهاندازی کنید.
پشتیبانی در تمام مراحل
