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

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

مستندات AnyBot
القنوات

أداة الدردشة على الويب

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

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

قبل أن تبدأ

  • يحتاج الوكيل إلى تفعيل قناة Web Chat (وهي في علامة تبويب التكاملات لدى الوكيل).
  • احرص على امتلاك صلاحية تعديل HTML موقعك، إذ ستلصق وسم <script> واحدًا قبل </body>.
  • قرّر منذ البداية ما إذا كنت تريد قصر التضمين على نطاقات بعينها، وما إذا كنت تريد سؤال الزوّار عن وسيلة تواصل قبل الدردشة.

أضفها إلى موقعك

  1. افتح الوكيل، واذهب إلى التكاملات، وابحث عن بطاقة Web Chat.
  2. انقر تضمين في الموقع لفتح نافذة التضمين.
  3. انقر نسخ الكود والصق المقتطف قبل وسم </body> الختامي مباشرةً في كل صفحة ينبغي أن تظهر فيها الأداة.

المقتطف وسم واحد فقط. تملأ لوحة التحكّم مُعرّف وكيلك (BOT_UID) ومضيف AnyBot الصحيح، لذا انسخه حرفيًا:

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

يحمّل هذا الوسم أداة AnyBot التي تضيف إلى الصفحة زرّ إطلاق عائمًا؛ والنقر عليه يفتح الدردشة (بملء الشاشة على الهواتف، ويغلقها مفتاح Escape). تقدّم AnyBot كود الأداة بدلًا من لصقه في صفحتك، فتصل الإصلاحات وإعدادات المظهر الخاصة بك إلى موقعك دون إعادة لصق. وإذا اخترت سمةً في نافذة التضمين، يحمل الوسم أيضًا الخاصية data-theme؛ وتغيير السمة لاحقًا هو التغيير الوحيد الذي يتطلّب نسخ الوسم من جديد.

نافذة التضمين في الموقع مع مقتطف نسخ الكود

افتح الدردشة من أزرارك الخاصة

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

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

ومن كود JavaScript الخاص بك، توفّر الأداة أيضًا window.AnyBotWidget.open() وclose() وtoggle().

خصّص الأداة

يأتي المظهر والسلوك من إعدادات قناة Web Chat، ويُقدَّمان عبر نقطة معلومات الوكيل العمومية التي تجلبها الأداة. الحقول القابلة للتعديل:

الإعدادما الذي يتحكّم فيه
theme_colorلون زرّ الإطلاق واللون المميّز
launcher_positionbottom-right أو bottom-left
launcher_icon_urlأيقونة إطلاق مخصّصة (الافتراضي رمز دردشة)
header_titleالعنوان الظاهر أعلى لوحة الدردشة
welcome_bubbleفقاعة ترحيب تشويقية فوق زرّ الإطلاق
input_placeholderالنص التوضيحي في حقل الرسالة
show_brandingمفتاح إظهار عبارة «Powered by»

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

قيّد أماكن تضمينها

أضف قائمة النطاقات المسموح بها إلى القناة، فلا يستطيع تحميل الأداة سوى تلك المواقع، ويُرفض أي طلب من نطاق آخر (403). ويُفرَض ذلك على الخادم في كل طلب ضيف (بفحص Origin/Referer)، فلا يمكن الالتفاف عليه بتعديل المقتطف. والقائمة الفارغة تعني بلا قيود. أما أصل لوحة تحكّم AnyBot الخاصة بك فمسموح به دائمًا، فلا تُحجب معاينة المالك أبدًا.

التقط جهة اتصال قبل الدردشة

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

على هذه القناة

  • يستقبل: الرسائل المكتوبة من الزوّار الضيوف.
  • يرسل: ردودًا نصية متدفّقة، مع خطوات استدعاء الأدوات وتقييم 👍/👎؛ والصور التي يولّدها الوكيل تُعرض ضمن المحادثة.
  • الجلسات: يحتفظ الضيوف بمحادثتهم عبر إعادة تحميل الصفحة على الجهاز نفسه.

الخصوصية بحكم التصميم

لا يشغّل الزوّار الضيوف سوى الأدوات الآمنة للعموم، وهي حاليًا 27 من قدرات المنصّة. فلا يستطيع زائر أن يجعل الوكيل يقرأ صندوق الوارد أو نظام CRM أو بياناتك المالية أبدًا. وثمة مجموعة فرعية صغيرة ومقصودة من الأدوات الآمنة للعموم هي عمليات كتابة (التقاط العملاء المحتملين وحجز المواعيد)، أما كل ما هو حسّاس فيبقى خاصًّا بالمالك. راجع الأمان.

حلّ المشكلات

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

الأسئلة الشائعة

هل أحتاج إلى مفتاح API؟ لا، بلا أي إعداد. يحمل الوسم مُعرّف وكيلك ولا شيء غيره.

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

هل يمكنني تحديد المواقع التي تضمّنها؟ نعم، عبر قائمة النطاقات المسموح بها؛ والقائمة الفارغة تعني أي موقع.

هل يعطّل تعديل الإعدادات التضمين؟ لا، تضبط الأداة نفسها بنفسها عند كل تحميل، فيتحدّث اللون والأيقونة ورسالة الترحيب دون المساس بالمقتطف.

هل يمكن لزرّي الخاص أن يفتح الدردشة؟ نعم. أضف data-anybot-open إلى أي زرّ أو رابط، أو استدعِ window.AnyBotWidget.open().

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

  • إعدادات القنوات، رسالة الترحيب وساعات العمل ورسالة خارج ساعات العمل
  • كل القنوات، اربط WhatsApp وTelegram والبريد الإلكتروني وغيرها
  • القدرات، ما الأدوات الآمنة للعموم التي يستطيع وكيلك تشغيلها
  • الأمان، نموذج «خاصة بالمالك» مقابل «آمنة للعموم»