RonakAI
راهنمای فروشنده

نصب و یکپارچه‌سازی

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

وردپرسسایت اختصاصی
ووکامرس

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

برای فروشگاه‌های ووکامرس، افزونه همگام‌سازی کاتالوگ، Handshake امن و بارگذاری async ویجت را انجام می‌دهد.

  1. 1فایل zip را دانلود کنید.
  2. 2در پیشخوان وردپرس: افزونه‌ها → افزودن → بارگذاری افزونه.
  3. 3افزونه RonakAI را فعال کنید.
  4. 4از داشبورد فروشنده کلید API بسازید و در تنظیمات افزونه وارد کنید تا Handshake و همگام‌سازی شروع شود.

دانلود ronak-ai.zip

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

دانلود افزونه

هنوز حساب ندارید؟ شروع رایگان

غیر وردپرس

یکپارچه‌سازی سایت اختصاصی

روی فروشگاه سفارشی دو لایه دارید: ویجت گفتگو در مرورگر، و همگام‌سازی سرور‌به‌سرور با امضای HMAC.

۱) Embed ویجت گفتگو

اسکریپت را async/defer بارگذاری کنید. data-tenant الزامی است؛ data-api پایهٔ API را مشخص می‌کند. دامنه فروشگاه باید در داشبورد ثبت شده باشد (CORS).

<script
  src="https://cdn.ronak.ai/embed.js"
  data-tenant="YOUR_TENANT_ID"
  data-api="https://api.ronak.ai"
  defer
></script>

  • GET /v1/widget/config

    پیکربندی عمومی ویجت

  • POST /v1/chat/sessions

    شروع گفتگو

  • POST /v1/chat/messages

    پیام + پاسخ SSE

چت با احراز هویت ویجت است (نه HMAC): هدر X-Ronak-Tenant یا Bearer کوتاه‌عمر ویجت. پاسخ پیام‌ها به‌صورت SSE است.

۲) همگام‌سازی کاتالوگ با HMAC

از داشبورد یک کلید API با دامنهٔ فروشگاه بسازید. سرور شما هر درخواست را با HMAC-SHA256 امضا می‌کند؛ پنجرهٔ زمانی ±۵ دقیقه و nonce یک‌بارمصرف الزامی است.

X-Ronak-Key-IdX-Ronak-TimestampX-Ronak-NonceX-Ronak-SignatureX-Ronak-Shop-Domain
canonical = `${timestamp}.${METHOD}.${pathWithQuery}.${rawBody}`
signature = hex(HMAC_SHA256(secret, canonical))
متدمسیر
POST/v1/plugin/handshake
GET/v1/plugin/health
POST/v1/catalog/sync/sessions
POST/v1/catalog/products/batch
POST/v1/catalog/categories/batch
POST/v1/catalog/tags/batch
POST/v1/catalog/sync/sessions/:id/complete

جزئیات قرارداد، کدهای خطا و شکل batch در مستندات داخلی معماری (docs/architecture/API_CONTRACTS.md و SECURITY.md) آمده است. برای شروع عملی: ثبت‌نام → دامنه → ساخت کلید → Handshake → batch محصولات.

ساخت حساب و کلید APIسؤال فنی؟ تماس بگیرید
نصب و یکپارچه‌سازی | RonakAI