الأداة

الأداة هي أسرع وسيلة لوضع المساعد في منتجك. إنها سكربت واحد يركّب مشغّل دردشة، معزولًا عن صفحتك كي لا يتعارض شيء.

التضمين

أضِف وسم سكربت واحدًا بمفتاحك القابل للنشر. ويمكنك أيضًا تثبيتها من npm أو استضافة السكربت بنفسك إن فضّلت.

<script
  type="module"
  src="https://cdn.syncanix.com/widget.js"
  data-key="pk_live_..."
  data-position="bottom-right"
></script>

يجب تحميل السكربت بصفة type="module". هذا هو الشرط الوحيد.

كيف تُحمَّل

يُقلِع السكربت مشغّلًا صغيرًا فورًا، ولا يحمّل الدردشة نفسها إلا عندما يفتحها مستخدم، فلا تكاد تكلّف صفحتك شيئًا مقدّمًا. وتعمل الدردشة داخل Shadow DOM، فلا تتأثّر أنماطك وأنماط الأداة ببعضها أبدًا.

آمنة افتراضيًا

إن كان المفتاح أو أحد السمات خاطئًا، فلا ترمي الأداة خطأً في صفحتك أبدًا — بل تسجّل تحذيرًا ولا تعرض شيئًا، ويُحجَب مفتاحك في أي رسالة. فالتضمين المعطوب لا يمكن أن يعطّل تطبيقك.

ما الذي يمكن للودجت الوصول إليه وما لا يمكنه

الودجت معزول عمدًا عن الصفحة التي يعيش فيها. عمليًا:

• يعمل داخل Shadow DOM، فلا يمكن لأنماطه وأنماط صفحتك أن يؤثّر أحدها في الآخر أبدًا.
• لا يقرأ محتوى صفحتك ولا ملفات تعريف الارتباط ولا التخزين المحلي ولا السكربتات الأخرى — بل يعمل بما تسلّمه إليه صراحةً فقط.
• يستخدم مفتاحًا قابلًا للنشر آمنًا للتضمين في مصدر صفحتك: يمكنه بدء محادثة لمساحة عملك ولا شيء غير ذلك.
• لا يمكنه أبدًا فعل شيء لا يستطيع المستخدم المسجَّل دخوله فعله بنفسه — كل إجراء يُنفَّذ بهويته وصلاحياته.

الخطوات التالية