← بازگشت به راهنما

راهنمای اتصال ویجت چت به سایت

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

1) اتصال ویجت چطور انجام می‌شود؟

در پنل به مسیر `workspace/widgets` بروید و ویجت بسازید.
از صفحه جزئیات ویجت، کد embed را کپی کنید.
اسکریپت را قبل از `</body>` در سایت مشتری قرار دهید.
مقادیر `data-api-base` و `data-embed-token` به‌صورت خودکار در پنل صادر می‌شوند.

2) API کجا باید گذاشته شود؟

ویجت مرورگر به endpoint زیر در ai-core درخواست می‌زند:

POST /embed/chat

هدر لازم:

X-Embed-Token: <your-embed-token>

اگر هنوز منتشر نکرده‌اید، موقتاً می‌توانید `data-api-base` را روی `http://localhost:3100` بگذارید.

3) ظاهر ویجت چطور تعیین می‌شود؟

در پنل ویجت می‌توانید پیام خوش‌آمد، رنگ، موقعیت، فعال/غیرفعال و حالت رفتاری را تنظیم کنید.
presetهای آماده دارید: فروشگاهی، آموزشی، تحلیلی و ترکیبی.
هر preset همزمان UI و brain (لحن/هدف/فوکوس فروش) را مقداردهی اولیه می‌کند.

4) جای ویجت در سایت مشتری چگونه مشخص می‌شود؟

در پنل خود مشتری، تنظیم `position` برای ویجت انجام می‌شود.
همچنین دامنه‌های مجاز را در همان پنل تعریف می‌کند.
در حال حاضر جایگذاری گوشه راست/چپ فعال است و قابل توسعه برای inline/full-width است.

5) الان ویجت به سایت‌های خودت چطور وصل می‌شود؟

از پنل `workspace/widgets/[id]` اسکریپت embed تولید می‌شود.
این اسکریپت را در سایتت قرار می‌دهی.
embed token و tenant ویجت به‌صورت خودکار در ai-core sync می‌شوند.
در صورت نیاز می‌توانی از همان پنل توکن را rotate کنی.

وضعیت فعلی سرویس (صادقانه)

API و مسیر embed آماده است، حتی اگر هنوز سرویس منتشر نشده باشد.
برای محیط production باید ai-core روی دامنه واقعی بالا بیاید.
اتصال به providerهای AI هم با env انجام می‌شود و می‌تواند بعداً فعال شود.
پس الان می‌توانید end-to-end را روی staging/local تست کنید.

نمونه کد embed

<script
  src="https://api.your-domain.com/embed/widget.js"
  data-widget-id="widget-id"
  data-tenant="tenant-slug"
  data-api-base="https://api.your-domain.com"
  data-embed-token="emb_xxx"
  async
></script>