تضمين الموقع

سطر واحد من script يضع نافذة الدردشة على موقعك، مع الطرق وقواعد اللغة القابلة للاستدعاء على الصفحة.

يشير {API} في ما يلي إلى عنوان الخدمة، ويمكنك رؤيته في صفحة «التكامل» بلوحة التحكم.

<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>
  • data-key هو المفتاح العام (Key)، انسخه من صفحة «التكامل» في لوحة التحكم.
  • سجّل في صفحة «التكامل» المواقع المسموح بتضمينها (مثل https://shop.example.com)؛ لن تتمكن مواقع أخرى من استخدام المفتاح العام الخاص بك حتى لو حصلت عليه. احرص على تعبئته قبل النشر.
  • اختياري: data-theme="dark" لاستخدام النمط الداكن.
  • اختياري: data-language="de": عندما يكون موقعك متعدد اللغات، مرّر لغة الصفحة الحالية ليستخدمها الدعم افتراضيًا (يبقى بإمكان الزائر التبديل). راجع نظرة عامة على API العام للحصول على رموز اللغات المدعومة.
  • اختياري: data-language="auto": يأخذ <html lang> في الصفحة كلغة افتراضية، وبعدها عند تبديل الصفحة للغة (بتغيير سمة lang، حتى دون إعادة تحميل في تطبيق أحادي الصفحة) تتبدّل نافذة خدمة العملاء تلقائيًا معها.

يمكن استدعاء ما يلي من الصفحة:

الطريقةالوظيفة
AICS.open() / AICS.close() / AICS.toggle()فتح نافذة خدمة العملاء أو إغلاقها أو تبديلها، مثلًا عند ربطها بزر «تواصل مع الدعم»
AICS.identify(userToken)إخبار خدمة العملاء بمن هو العميل بعد تسجيل الدخول (راجع تحديد هوية العملاء المسجّلين)
AICS.setLanguage(code)يُستدعى عند تبديل لغة الموقع، فتتبدّل نافذة خدمة العملاء والردود اللاحقة معها، مثل AICS.setLanguage("ja")؛ ويقبل أيضًا صيغًا مثل zh-Hans وpt-BR
AICS.reset()يُستدعى عند تسجيل خروج العميل: إلغاء تحميل نافذة خدمة العملاء والتخلّص من الجلسة الحالية؛ وإعادة تحميل السكربت مرة أخرى تعطيك نافذة جديدة مجهولة، ولن يرى الشخص التالي محادثة الشخص السابق

اللغة

  • تعرض نافذة خدمة العملاء اللغة المناسبة حسب موقع الزائر (IP)، بما في ذلك نصوص الواجهة ورسالة الترحيب؛ وعند ضبط data-language تُمنح الأولوية للغة الصفحة. وإذا تعذّر تحديد الموقع، تُستخدم «اللغة الافتراضية» المضبوطة في لوحة التحكم.
  • يجيب AI باللغة التي يستخدمها العميل؛ وإذا تعذّر استنتاج اللغة من محتوى العميل (رموز تعبيرية، رقم طلب)، تُستخدم اللغة التي حُدّدت أعلاه.
  • يمكن للعميل التبديل من قائمة اللغات في أعلى النافذة، أو أن يطلب من AI مباشرة «أجب بالإنجليزية». بعد ذلك يظل AI يستخدم هذه اللغة حتى لو كتب العميل بلغة أخرى.
  • يُعدّ تبديل لغة الموقع (AICS.setLanguage أو تغيير <html lang> عند استخدام data-language="auto") اختيارًا من العميل أيضًا، وتُعتمد آخر طريقة من الطرق المذكورة أعلاه؛ أما اللغة الافتراضية المرفقة عند فتح الصفحة فلا تلغي اللغة التي اختارها العميل.
  • يمكنك من «إعدادات الروبوت → اللغة» في لوحة التحكم إيقاف التحديد حسب IP، وتغيير اللغة الافتراضية، وتحديد اللغات المتاحة.
  • عند النشر خلف وكيل عكسي أو CDN، تحتاج إلى ضبط TRUSTED_PROXIES أو COUNTRY_HEADER على الخادم، وإلا لن تحصل على IP الحقيقي للزائر.

هل كانت هذه الصفحة مفيدة؟

آخر تحديث: