مستندات پشتیبانی

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

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

ویجت وب

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

<script src="YOUR_APP_URL/widget.js" data-kianhoosh-key="PUBLIC_KEY" data-api="YOUR_API_URL" async></script>

برای محدودکردن سوءاستفاده، دامنه سایت را در «راه‌اندازی پشتیبانی ← دامنه‌های مجاز» ثبت کنید.

API تیکت

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

curl -X POST "YOUR_API_URL/api/v1/support/public/tickets" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_SECRET_API_KEY" \
  -d '{
    "subject": "پیگیری درخواست",
    "message": "لطفاً وضعیت درخواست من را بررسی کنید.",
    "requester_name": "مریم احمدی",
    "requester_email": "maryam@example.com",
    "external_id": "order-1842",
    "priority": "normal"
  }'

GET /api/v1/support/public/tickets/{ticket_id} با همان هدر X-API-Key، وضعیت و همه پیام‌های تیکت را برمی‌گرداند.

پیام صوتی ویجت

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

افزونه وردپرس

پوشه kianhoosh-wp-support را ZIP و از «افزونه‌ها ← افزودن» نصب کنید. در تنظیمات افزونه، نشانی API، کلید عمومی ویجت و در صورت استفاده از فرم تیکت، کلید محرمانه را وارد کنید.

1. ۱. افزونه را فعال کنید.
2. ۲. از «تنظیمات ← پشتیبانی کیان هوش» اتصال را آزمایش و ذخیره کنید.
3. ۳. ویجت خودکار در سایت نمایش داده می‌شود.
4. ۴. شورت‌کد [kianhoosh_support_ticket] فرم ثبت تیکت را در هر برگه قرار می‌دهد.