العودة إلى لوحة التحكم

التوثيق

تعلّم كيفية استخدام Asyntai

الدردشة المضمّنة

اعرض أداة الدردشة مضمّنة في صفحتك بدلاً من فقاعة عائمة

الحصول على كود التضمين
جميع الخطط

نظرة عامة

بشكل افتراضي، تظهر أداة محادثة Asyntai كفقاعة عائمة في زاوية موقعك الإلكتروني. مع المحادثة المضمنة، يمكنك أيضاً عرض المحادثة مباشرة على صفحتك — على سبيل المثال، في قسم "تحدث معنا" على صفحتك الرئيسية.

تستمر الفقاعة العائمة في العمل بجانب المحادثة المضمنة. يمكن للزوار الذين لا يمررون إلى القسم المضمن الاستمرار في استخدام الفقاعة. كلاهما يشتركان في نفس المحادثة.

كيف يعمل

1
أضف وسم script واحد ضعه في أي مكان تريد أن تظهر فيه المحادثة في HTML الخاص بك
2
تُعرض المحادثة ضمن الصفحة تظهر الأداة في ذلك الموضع، مرئية دائماً، بنفس حجم المحادثة العادية
3
تبقى الفقاعة نشطة تبقى الفقاعة العائمة في الزاوية للزوار الذين لا يرون المحادثة المضمنة
4
محادثة مشتركة تتزامن الرسائل بين المحادثة المضمنة والأداة العائمة في الوقت الفعلي

الإعداد

أضف هذا السطر الواحد من HTML في أي مكان تريد أن تظهر فيه المحادثة على صفحتك:

<script src="https://asyntai.com/static/js/chat-embed.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

استبدل YOUR_WIDGET_ID بمعرف الأداة الخاص بك. يمكنك العثور على كود التضمين مع معرفك المعبأ مسبقاً في صفحة إعداد المحادثة المضمنة.

ملاحظة: يجب أن يكون سكربت chat-widget.js الرئيسي موجوداً أيضاً على الصفحة. إذا كنت قد ثبّت أداة Asyntai على موقعك بالفعل، فهذا الأمر تم الاهتمام به.

مثال

إليك كيف يمكنك استخدامه على الصفحة الرئيسية:

<section style="max-width: 500px; margin: 0 auto;">
    <h2>Chat with us</h2>
    <p>Ask us anything — our AI assistant is here to help.</p>

    <!-- The chat will appear right here -->
    <script src="https://asyntai.com/static/js/chat-embed.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</section>

التفاصيل

الحجم

تُعرض المحادثة المضمنة بنفس حجم الأداة العائمة: 400 بكسل عرضاً و650 بكسل ارتفاعاً على سطح المكتب، وبعرض كامل و550 بكسل ارتفاعاً على الهاتف المحمول. يمكنك التحكم في موضعها عن طريق تنسيق الحاوية الأصلية.

سلوك الفقاعة العائمة

عندما تكون المحادثة المضمنة مرئية على الشاشة وينقر الزائر على الفقاعة العائمة، يتم التمرير إلى المحادثة المضمنة. إذا لم تكن المحادثة المضمنة في مجال الرؤية، تفتح الفقاعة نافذة المحادثة العائمة العادية.

مزامنة الرسائل

تشترك كل من المحادثة المضمنة والعائمة في نفس المحادثة. تظهر الرسائل المرسلة من أي منهما في كليهما. يتم استخدام نفس الجلسة وسياق الذكاء الاصطناعي وسجل المحادثة.

صفحات متعددة

يمكنك استخدام المحادثة المضمنة في بعض الصفحات والأداة العائمة العادية في صفحات أخرى. فقط أدرج سكربت التضمين في الصفحات التي تريد فيها المحادثة المضمنة. تنتقل المحادثة بين الصفحات كالمعتاد.

معاينة مباشرة

إليك محادثة مضمنة مباشرة لتتمكن من رؤية كيف تبدو:

المتطلبات

يجب تثبيت أداة محادثة Asyntai الرئيسية (chat-widget.js) على الصفحة
تعمل على جميع الخطط — لا حاجة للترقية
متوافقة مع جميع المتصفحات التي تدعم Shadow DOM (جميع المتصفحات الحديثة)

نصيحة: اختبر المحادثة المضمنة بوضعها على صفحة تجريبية أولاً. تأكد من أنها تبدو صحيحة ضمن تخطيط صفحتك قبل النشر على الإنتاج.