تخطَّ إلى المحتوى

جاهز للبناء مع AnyBot؟

مستندات AnyBot

ضمّن الدردشة على الويب في موقعك

أضف أداة دردشة ذكية إلى موقعك خلال دقائق, فعّل قناة الدردشة على الويب، وانسخ وسم نص برمجي واحدًا، وضعه في موقعك، وجرّب المشغّل المباشر.

أداة الدردشة على الويب هي أسرع قناة للانطلاق: بلا أي إعداد، ولا رموز، ولا مفاتيح API. تفعّل قناة واحدة، وتنسخ وسم نصّ برمجي من لوحة التحكم، وتلصقه قبل وسم إغلاق الجسم، فيظهر مشغّل بألوان علامتك في موقعك. وهذه الصفحة هي الخطوات نقرةً نقرة. وللاطّلاع على بنية الأداة كاملةً وكل إعدادات المظهر ونموذج الخصوصية، راجع مرجع قناة الدردشة على الويب.

ما الذي ستبنيه

مشغّل دردشة AnyBot حيًّا على موقعك، موصولًا بوكيل اختبرته أصلًا. ويتحدّث الزوّار كضيوف, بلا تسجيل دخول, وتتدفّق الردود مباشرةً، ولا يمكن الوصول إلى أي شيء خاص إطلاقًا. ويستغرق ذلك نحو خمس دقائق بعد وجود وكيلك.

قبل أن تبدأ

  • وكيل يجيب جيدًا أصلًا. جديد هنا؟ وكيلك الأول في 10 دقائق.
  • إمكانية تحرير HTML لموقعك, فستلصق وسم <script> واحدًا.
  • قرارات اختيارية: هل تقيّد النطاقات التي يمكنها تحميل الأداة، وهل تطلب من الزوّار بيانات تواصل قبل الدردشة.

الخطوات

1. اختر الوكيل أو أنشئه

افتح الوكلاء الأذكياء في الشريط الجانبي وافتح الوكيل الذي تريده في موقعك. فالأداة تقدّم بالضبط ما يجيب به ذلك الوكيل، ولذلك ينبغي أن يكون قد اجتاز دردشة تجريبية أصلًا. تبدأ من الصفر؟ ابنِ واحدًا واختبره أولًا عبر وكيلك الأول.

النتيجة المتوقّعة: محرّر الوكيل مفتوح على تبويباته.

2. فعّل قناة الدردشة على الويب

اذهب إلى تبويب التكاملات في الوكيل وفعّل بطاقة الدردشة على الويب. وهذا يشغّل التضمين ويفعّل لوحة اختبار الدردشة مع الوكيل المدمجة معًا.

النتيجة المتوقّعة: تظهر بطاقة الدردشة على الويب مفعّلة، وتتوفّر لوحة الدردشة بجوار المحرّر (لوحة جانبية على الشاشات العريضة، وزرّ دردشة على الأصغر).

تبويب التكاملات مع تفعيل بطاقة الدردشة على الويب

3. جرّبها في اللوحة قبل التضمين

افتح لوحة الدردشة مع الوكيل وبدّلها إلى وضع الاختبار (فهي تُفتَح في وضع التدريب افتراضيًا), إذ يُسقط وضع الاختبار سياق المسؤول، فترى ما يراه زائر موقع حقيقي. اسأل سؤالًا ينبغي أن تغطّيه معرفتك؛ فتتدفّق الردود رمزًا رمزًا وتظهر كل خطوة أداة. صحّح النبرة أو أضف معرفة الآن؛ راجع اختبار وكيلك.

النتيجة المتوقّعة: ردّ مؤسَّس ومتدفّق يطابق محتواك.

4. انسخ مقتطف التضمين

على بطاقة الدردشة على الويب، انقر التضمين في موقع الويب، ثم نسخ الشيفرة. والمقتطف وسم واحد يحمل مُعرّف وكيلك؛ انسخه حرفيًا، فلا مفتاح تضيفه.

النتيجة المتوقّعة: وسم من سطر واحد في حافظتك، مثل هذا الوسم، مع مُعرّف وكيلك مكان BOT_UID:

<script src="https://app.any.bot/widget.js" data-anybot="BOT_UID" async></script>

إذا كان موقعك لا يزال يحتوي على المقتطف الأقدم متعدّد الأسطر (يبدأ بـ<!-- AnyBot Chat Widget -->)، فاستبدل الكتلة كاملةً بهذا الوسم: فالمقتطف القديم لم يعد يلتقط أيقونتك وألوانك. ويشرح مرجع القناة الوسم بالتفصيل.

مربّع حوار التضمين في موقع الويب مع مقتطف نسخ الشيفرة

5. الصقها في موقعك

الصق الوسم قبل وسم </body> مباشرةً في كل صفحة ينبغي أن تظهر فيها الأداة، ثم انشر. وعند التحميل يعرض مشغّلًا عائمًا؛ والنقر عليه يفتح الدردشة.

النتيجة المتوقّعة: يظهر زرّ مشغّل في زاوية صفحتك المنشورة.

6. (اختياري) افتح الدردشة من زرّك الخاص

أضف data-anybot-open إلى أي زرّ أو رابط في صفحتك، مثل زرّ «تحدّث معنا» في ترويسة موقعك، فيفتح النقر عليه الدردشة:

<button type="button" data-anybot-open>Chat with us</button>

النتيجة المتوقّعة: النقر على زرّك يفتح لوحة الدردشة نفسها التي يفتحها المشغّل.

7. (اختياري) أحكِم إغلاقها والتقط جهات الاتصال

عد إلى إعدادات قناة الدردشة على الويب:

  • النطاقات المسموح بها، اسرد المواقع المسموح لها بتحميل الأداة. وأي مصدر آخر يُرفَض من جهة الخادم بـ403، فلا يمكن تجاوزه بتحرير المقتطف. والقائمة الفارغة تعني بلا قيود، ومصدر لوحة التحكم الخاص بك مسموح دائمًا.
  • الالتقاط قبل الدردشة، اطلب أيًّا من الاسم أو البريد الإلكتروني أو الهاتف قبل الرسالة الأولى؛ فتُغذّي القيم جهة الاتصال. وهي إحدى عمليات الكتابة الآمنة للعموم المقصودة.

ويسري كلاهما دون إعادة لصق الوسم.

8. جرّب الأداة الحيّة

افتح صفحتك المنشورة في متصفّح جديد (أو نافذة تصفّح خفي) لتكون زائرًا مجهولًا، وانقر المشغّل، وأرسل رسالة.

النتيجة المتوقّعة: تُفتَح اللوحة، وتُرسَل رسالتك، ويتدفّق ردّ الوكيل, كضيف، وبلا تسجيل دخول.

تأكّد أنه يعمل

  • قناة الدردشة على الويب مفعّلة على الوكيل.
  • زرّ المشغّل يظهر في صفحتك المنشورة.
  • النقر عليه يفتح الدردشة وتحصل رسالة تجريبية على ردّ متدفّق.
  • إن ضبطت نطاقات مسموحًا بها، تُحمَّل الأداة عليها وتُرفَض في غيرها.

استكشاف الأخطاء

  • المشغّل لا يظهر، تأكّد من أن <script> قبل </body> وأن قناة الدردشة على الويب مفعّلة لهذا الوكيل.
  • 403 عند تحميل الأداة، نطاق الصفحة ليس في قائمة النطاقات المسموح بها؛ أضفه، أو أفرغ القائمة للانتقال إلى بلا قيود.
  • المشغّل يعرض اللون والأيقونة الافتراضيين، ما زالت الصفحة تحتوي على المقتطف الأقدم متعدّد الأسطر؛ استبدله بالوسم ذي السطر الواحد من نسخ الشيفرة.
  • تغييرات النمط أو الترحيب لم تظهر، تقرأ الأداة الإعدادات عند كل تحميل؛ حدّث الصفحة تحديثًا قسريًا. ولا تحتاج إلى إعادة لصق الوسم، إلا بعد تغيير السمة.
  • الزوّار عالقون عند نموذج، الالتقاط قبل الدردشة مفعّل؛ وكل حقل مدرَج مطلوب قبل بدء الدردشة.

ما التالي