HyoNovaالتوثيق

أداة دردشة الموقع

أضف دردشة HyoNova للدعم إلى موقعك — ما يراه الزوار، ومحرّر الأداة، والمسودات والنسخ، وقواعد الصفحات، ومقالات المساعدة، والنطاقات المسموح بها، ومقتطف التثبيت، والخصوصية.

تجريبييعمل اليوم في مساحات العمل ضمن الوصول المبكر. قد يتغير السلوك والحدود.دليللمن: المالكون، المديرون العامون، تقنية المعلومات والأمان، المطورونآخر تحديث: أُضيفت في:
في هذه الصفحة

تضع أداة دردشة الموقع زر دردشة على موقعك. تصل رسائل الزوار إلى صندوق وارد HyoNova للدعم، وتظهر ردود وكلائك في الدردشة. وهي تعمل دون أي خدمة خارجية: لا شيء يحتاج HyoNova إلى إعداده أولاً.

تمنحك الأداة ثلاث طرق لتقديم الدردشة:

الطريقةما هيأين تعمل
مقتطف التثبيتزر دردشة على كل صفحة من موقعكعلى النطاقات التي تسمح بها فقط
رابط الدردشة المباشردردشة بملء الصفحة على عنوان دردشة HyoNova، chat.hyonova.com، يمكنك مشاركتها بالبريد أو على وسائل التواصل أو في رمز QRفي أي مكان؛ ويمكنك إيقافه
رابط التضمينالدردشة نفسها كصفحة تضعها داخل إطار <iframe> عادي في صفحتكداخل إطار على النطاقات التي تسمح بها فقط

ما يراه الزوار#

للدردشة حتى أربع واجهات. تختار ما تقدّمه الأداة منها في خطوة التجربة.

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

من يرد#

يوضّح أعلى الدردشة وسطر الحالة دائماً من يتولى المحادثة. ولا تعرض الدردشة أبداً وقت انتظار تخمينياً.

ما يراه الزائرمتى
الفريق متصل الآن أو سنرد في أقرب وقتقبل بدء المحادثة: هل يوجد من يستطيع الرد الآن
بانتظار الفريق — محادثتك الآن لدى الفريق. سيرد عليك أحد الموظفين هنا، ولا حاجة لإعادة كتابة طلبك.لم يستلم أحد المحادثة بعد، والفريق متاح
الفريق خارج الدوام — الفريق غير متواجد الآن. رسالتك محفوظة وسيرد عليك هنا عند عودته.لم يستلم أحد المحادثة، والفريق خارج ساعات عمله أو لا أحد بحالة متاح
الاسم الأول للوكيل، مع صورته في الدعم أو الأحرف الأولى من اسمه، وسطر فريق علامتك التجاريةيتولى وكيل المحادثة. وعند استلامه لها تخبر الدردشة الزائر بأنه استلم المحادثة

وأثناء المحادثة:

  • إشعارات القراءة. تعرض كل رسالة أرسلها الزائر جارٍ الإرسال… ثم أُرسلت ثم قُرئت بعد أن يفتح المحادثةَ عضو في الفريق يستطيع الرد أو يرد عليها. والرسالة التي تعذّر إرسالها تعرض لم تُرسل مع أعد المحاولة.
  • الكتابة. حين يكون مؤشر الكتابة مفعّلاً يرى الزائر أن وكيلاً يكتب رداً، ويرى الوكيل العميل يكتب…. راجع مؤشر الكتابة ومعاينة الكتابة.
  • ممن يستطيع الرد فقط. الزميل الذي يستطيع قراءة المحادثة دون الرد عليها لا يُظهر في الدردشة قُرئت ولا إشارة كتابة أبداً.
  • الرسائل الجديدة. الزائر الذي صعد ليقرأ لا يُسحب إلى الأسفل أبداً عند وصول رد؛ ويأخذه زر رسائل جديدة إليه.
  • الرسائل الأقدم. تحمّل الدردشة آخر 50 رسالة؛ وعرض الرسائل الأقدم يحمّل ما قبلها.
  • الردود غير المقروءة. يعرض زر الدردشة عدد الردود التي لم يقرأها الزائر بعد — 9+ لما فوق التسعة — ولا شيء غير ذلك.

الأزرار والبطاقات في الرد#

يمكن أن يحمل رد فريقك واحداً من هذه العناصر تحت نصه. والنص موجود دائماً أيضاً، فلا يضيع شيء حيث لا يمكن عرض زر.

ما يراه الزائرما يحدث
ردود سريعة — حتى أربع إجابات قصيرة على شكل أزرارالنقر على أحدها يرسل نصه كرسالة من الزائر نفسه. ولا تُعرض إلا تحت أحدث رسالة في محادثة ما زال الزائر يستطيع الكتابة فيها؛ وتختفي بوصول رسالة أحدث
بطاقات مقالات المساعدة — حتى ثلاث، ولكل منها عنوان المقالةالنقر على إحداها يفتح المقالة داخل الدردشة، وزر رجوع يعيد إلى المحادثة. وتعمل البطاقة حتى حين تكون مقالات المساعدة متوقفة في الأداة، لكن للمقالة التي أُرسلت إلى هذا الزائر فقط
أزرار الروابط — حتى ثلاثةيعرض كل زر النص الذي كتبه وكيلك، وتحته اسم الموقع الذي يقود إليه الرابط فعلاً. ويُفتح في تبويب جديد. ولا تُعرض إلا العناوين التي تبدأ بـ https://
جلسة دعم مباشرة — بطاقة دعوةيدعوك موظف الدعم إلى غرفة صوت وفيديو تُفتح في تبويب جديد. لا يُشارَك الميكروفون أو الكاميرا أو الشاشة إلا إذا سمحت بذلك هناك. يختار الزائر انضم إلى الجلسة؛ ولا يبدأ شيء من تلقاء نفسه. وبعد انتهاء صلاحيتها تقول البطاقة انتهت صلاحية هذه الدعوة. اطلب من الموظف دعوة جديدة.

يضيف الوكلاء الردود السريعة وبطاقات المقالات وأزرار الروابط بزر إضافة إلى الرد. وتُرسل بطاقة الدعوة حين يبدأ وكيل دعماً مباشراً ويدعو العميل. راجع إضافة إلى الرد والدعم المباشر من تذكرة.

على الهواتف#

على الشاشة الضيقة (أقل من 520 بكسل عرضاً) تملأ الدردشة المفتوحة الشاشة. ويُضبط حجمها على الجزء الذي يبقى ظاهراً فوق لوحة المفاتيح، فلا يختفي حقل الرسالة خلفها أبداً. ولا تتحرك الصفحة التي خلف الدردشة ما دامت مفتوحة، ويبتعد زر الدردشة عن الحافة السفلية للهاتف. ويمكنك إعطاء الزر شكلاً وحجماً ومسافة مختلفة على الهواتف. راجع زر الفتح.

إنشاء أداة#

تحتاج إلى صلاحية إدارة الدعم. افتراضياً يملكها المالك والمدير العام. وتسمّي الواجهة العربية الأداة «ودجة».

  1. افتح الأدوات. اذهب إلى إدارة الشركة › الدعم › ودجات دردشة الموقع واختر ودجة جديدة. للمحرّر ست خطوات في صفحة واحدة، بجانب معاينة مباشرة.
  2. الهوية. أعطِ الأداة الاسم — وهو داخلي؛ فالزوار يرون اسم العلامة التجارية — واختر اللون المميز والسمة واللغة. راجع الهوية.
  3. زر الفتح. اختر مكان الزر وشكله على الحاسوب وعلى الجوال. راجع زر الفتح.
  4. التجربة. فعّل الشاشة الرئيسية ومقالات المساعدة والمحادثات السابقة أو أوقفها، واكتب ترحيبك واقتراحات بدء المحادثة، وامنح بعض الصفحات بداية خاصة بها عبر قواعد الصفحات، وقرّر ما يحدث قبل الدردشة وحين لا يوجد من يرد. راجع الشاشة الرئيسية والمساعدة والاقتراحات ونموذج ما قبل الدردشة والاتصال وعدم الاتصال.
  5. التشغيل. اختر أين تذهب المحادثات: صندوق الوارد والطابور، وساعات العمل إن أردت. وإن لم تختر تُستخدم القيم الافتراضية للشركة وتُعدّ الأداة مفتوحة دائماً.
  6. الخصوصية والميزات. قرّر هل يستطيع الزوار إرفاق ملفات، وما يظهر أثناء الكتابة، وأضف رابطي سياسة الخصوصية والشروط. راجع خيارات أخرى للأداة.
  7. النشر. أبقِ الحالة على فعّالة، وأضف كل موقع في النطاقات المسموح بها ثم اختر حفظ. راجع النطاقات المسموح بها.

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

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

الهوية#

الإعدادما يفعله
الاسمالاسم الداخلي للأداة. لا يراه الزوار أبداً
اسم العلامة التجاريةيظهر في أعلى الدردشة
اللون المميزلون الأزرار وعناصر التمييز. تبدأ الأدوات الجديدة باللون #0f7a52؛ والأداة التي أنشأتها سابقاً تحتفظ بلونها. وإن كان اللون المميز أفتح من أن يُقرأ نصاً، تبقيه الدردشة للأزرار وتكتب النص بلون النص العادي
السمةفاتحة أو داكنة أو تتبع جهاز الزائر
اللغةلغة الزائر أو الإنجليزية أو العربية. راجع اللغة

يمكن إضافة صور العلامة التجارية بعد حفظ الأداة لأول مرة. كل صورة بصيغة PNG أو JPEG أو WebP وبحجم حتى 1 ميغابايت وبأبعاد لا تتجاوز 2048 × 2048 بكسل، وتُحفظ فور رفعها، بمعزل عن زر حفظ. والصور ليست جزءاً من المسودات ولا من النسخ.

تُزال المعلومات المخفية. عند رفع صورة يزيل HyoNova المعلومات المخفية داخل الملف: مكان التقاطها ووقته، والجهاز، والصورة المصغّرة المضمّنة، والتعليقات. أما الصورة نفسها فلا تتغيّر وتحتفظ باتجاهها. وصورة PNG المتحركة تصبح صورة ثابتة. وينطبق ذلك على صور الدعم للوكلاء أيضاً.

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

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

وحيث لا يوجد شعار أو صورة تعرض الدردشة الأحرف الأولى. ولا تختلق صورة أبداً.

زر الفتح#

زر الفتح هو الزر الذي يفتح الدردشة في موقعك.

الإعدادما يفعله
الموضعنهاية الصفحة (اليمين بالإنجليزية) أو بداية الصفحة (اليسار بالإنجليزية)
الشكلمستطيل مستدير مع نص أو دائري، أيقونة فقط
الحجمعادي أو كبير
البعد عن الجانب (بكسل) والبعد عن الأسفل (بكسل)من 0 إلى 240 بكسل؛ و16 ما لم تغيّرها
لون الزرفارغ: يتبع اللون المميز
لون النص والأيقونةفارغ: يُختار الأسود أو الأبيض تلقائياً
النص (بالإنجليزية) والنص (بالعربية)النص على الزر المستطيل، حتى 40 حرفاً، للزوار الذين يرون الدردشة بتلك اللغة
النص الاحتياطييُستخدم حين يكون نص لغة الزائر فارغاً. وإن كان فارغاً هو أيضاً يعرض الزر تحدث معنا
الأيقونةفقاعة دردشة أو صورتك — أي أيقونة زر الفتح التي رفعتها. وإلى أن ترفع واحدة تظهر فقاعة الدردشة
  • الحاسوب والجوال يُضبطان كلٌّ على حدة. لكل من الزر على الحاسوب والزر على الجوال شكله وحجمه ومسافاته. وتستخدم الأداة الجديدة مستطيلاً مستديراً مع نص على الحاسوب وزراً دائرياً على الجوال.
  • وضوح الزر. يقيس المحرّر التباين بين النص ولون الزر ويخبرك بالنتيجة: سهل القراءة، أو مقروء بحجم الزر لكنه أضعف من 4.5:1 الموصى به للنصوص، أو أضعف من أن يُقرأ. وإن كان لون النص الذي اخترته لا يُقرأ على الزر، تستخدم الدردشة الأسود أو الأبيض بدلاً منه.
  • الزر الدائري لا يعرض نصاً، لكن قارئات الشاشة تقرؤه.
  • إعادة زر الفتح إلى الإعدادات الافتراضية تعيد الزر القياسي.

الشاشة الرئيسية والمساعدة والاقتراحات#

هذه الإعدادات في خطوة التجربة.

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

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

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

قواعد الصفحات#

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

الحقلما يفعله
عنوان الصفحة يحتوي علىجزء من العنوان، مثل /pricing. حروف إنجليزية وأرقام و/ - _ . فقط، حتى 80 حرفاً
الترحيب (بالإنجليزية) والترحيب (بالعربية)يحلّان محل الترحيب العام في الصفحات المطابقة، حتى 80 حرفاً
المقدمة (بالإنجليزية) والمقدمة (بالعربية)تحلّان محل المقدمة العامة في الصفحات المطابقة، حتى 160 حرفاً
الاقتراحات في هذه الصفحاتحدّد اقتراحات بدء المحادثة التي تظهر في هذه الصفحات، ورتّب ما حدّدته
  • ما الذي يُقارَن. مسار عنوان الصفحة فقط — أي ما بعد النطاق. ولا يُنظر إلى النطاق ولا إلى ما بعد ? أو #، ولا فرق بين الحروف الكبيرة والصغيرة. فالقاعدة /pricing تطابق https://example.com/en/pricing/plans.
  • أول قاعدة مطابقة هي المعتمدة. تُفحص القواعد من الأعلى. استخدم نقل للأعلى ونقل للأسفل لترتيبها.
  • الحقول الفارغة تعود إلى النص العام. الترحيب الفارغ أو المقدمة الفارغة يستخدمان النص العام. وإن لم تحدّد أي اقتراح ظهرت كل الاقتراحات.
  • لا تفتح الدردشة أبداً. القاعدة تغيّر ما تقوله الشاشة الرئيسية حين يفتح الزائر الدردشة في صفحة مطابقة. ولا تفتح الدردشة من تلقاء نفسها.
  • من أين يأتي العنوان. مع مقتطف التثبيت هو عنوان الصفحة التي تعرض زر الدردشة. وفي رابط الدردشة المباشر هو عنوان الصفحة التي جاء منها الزائر، حين يبلّغ عنه المتصفح. أما رابط التضمين فلا عنوان صفحة له، فيبدأ دائماً بالنص العام.

وبدون قواعد يقول المحرّر لا توجد قواعد صفحات: تبدأ الدردشة بالطريقة نفسها في كل الصفحات.

اللغة#

الدردشة بالإنجليزية أو العربية. وتختار اللغة بهذا الترتيب:

  1. إعداد اللغة في الأداة، حين يكون الإنجليزية أو العربية. اللغة الثابتة نهائية ولا يظهر معها زر تبديل.
  2. اختيار الزائر نفسه. حين تكون اللغة في الأداة لغة الزائر، يوجد في أسفل الدردشة زر لتبديل اللغة. ويُحفظ الاختيار في ذلك المتصفح.
  3. لغة صفحتك — خاصية lang في وسم <html> فيها.
  4. لغة المتصفح.

تُختار العربية حين تكون اللغة التي وُجدت هي العربية؛ وأي لغة أخرى تعطي الإنجليزية. وللترحيب والاقتراحات ونصوص الزر حقل بالإنجليزية وحقل بالعربية ليقرأ كل زائر صياغتك أنت.

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

يعرض المحرّر معاينة مباشرة بجانب النموذج: الدردشة الحقيقية مع محادثات نموذجية. ولا يُرسَل أي شيء يُكتب فيها.

  • ما يُعرض — مغلقة: زر الفتح أو الشاشة الرئيسية أو موظف الذكاء الاصطناعي يرد أو بانتظار الفريق أو الفريق غير متاح أو وكيل يرد أو مقالات المساعدة أو لا أحد متاح.
  • الجهاز — الحاسوب أو الجوال.
  • لغة الدردشة — الإنجليزية أو العربية.
  • معاينة كصفحة — تظهر حين تكون للأداة قواعد صفحات. اختر قاعدة لترى الشاشة الرئيسية كما يراها زائر في صفحة مطابقة، أو اختر صفحة بلا قاعدة.

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

المسودات والنشر والنسخ#

ما يراه الزوار هو الإعدادات المنشورة للأداة. وفي محرّر الأداة الموجودة مسبقاً زرّان:

الزرما يفعله
حفظينشر تغييراتك للزوار فوراً ويغلق المحرّر. وإن كانت هناك مسودة تنتظر حلّ محلها ما نشرته للتو
حفظ كمسودةيحتفظ بتغييراتك في المحرّر دون تغيير ما يراه الزوار. ويجيب المحرّر حُفظت المسودة. ما زال الزوار يرون الإعدادات المنشورة.

تُفحص المسودة كما يُفحص النشر، فالنموذج الذي فيه مشكلة لا يمكن حفظه كمسودة أيضاً. وليست للأداة الجديدة مسودة: أول حفظ ينشئها وينشرها.

ما دامت المسودة تنتظر:

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

للأداة مسودة واحدة يشترك فيها كل من يستطيع تعديلها.

النسخ#

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

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

تثبيت المقتطف#

انسخ شيفرة التثبيت من خطوة النشر في الأداة، أو من بطاقتها في ودجات دردشة الموقع، والصقها في HTML موقعك، قبل وسم الإغلاق </body> مباشرة في كل صفحة يجب أن تعرض الدردشة — أو مرة واحدة في القالب أو التخطيط المشترك لموقعك.

تبدو هكذا:

html
<script async src="https://chat.hyonova.com/chat/widget.js" data-widget-id="w_YOUR_WIDGET_ID"></script>

انسخ دائماً المقتطف الحقيقي من ودجات دردشة الموقع؛ فهو يحتوي معرّف أداتك. المعرّف علني — يسمّي الأداة وليس كلمة مرور. وما يحمي أداتك هو قائمة النطاقات المسموح بها.

تُقدَّم الدردشة من عنوان خاص بها، chat.hyonova.com، وشيفرة التثبيت التي تنسخها تستخدمه. أما شيفرة التثبيت التي نسختها سابقاً فتشير إلى عنوان الدردشة السابق لدى HyoNova. وهي ما زالت تعمل ولا تحتاج إلى استبدال.

  • يُحمَّل السكربت بخاصية async، فلا يبطئ صفحتك.
  • إن كان موقعك يرسل سياسة أمان المحتوى (Content-Security-Policy)، فاسمح بالعنوان https://chat.hyonova.com في script-src وframe-src. راجع سياسة أمان المحتوى.
  • منشئو المواقع (مثل WordPress وShopify وWix وWebflow) عادةً لديهم مكان لـ«الكود المخصص» أو «سكربتات التذييل». الصق المقتطف هناك.

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

الدردشة وصفحتك#

  • تنسيقات موقعك لا تغيّر الدردشة. تحتفظ الدردشة بحجمها ومكانها وشكلها. فالقاعدة العامة للإطارات في قالب موقعك — مثل قاعدة تجعل كل iframe بعرض الصفحة كاملاً — لا تغيّر حجمها ولا تنقلها ولا تخفيها. ولتغيير مكان الزر وشكله استخدم إعدادات زر الفتح.
  • الدردشة لا تغيّر شيئاً في صفحتك. لا تضيف خطوطاً ولا تنسيقات، ولا تحرّك تخطيط الصفحة. وعلى الحاسوب يبقى تمرير الصفحة كما هو والدردشة مفتوحة. وعلى الهواتف فقط، حيث تملأ الدردشة المفتوحة الشاشة، لا تتحرك الصفحة التي خلفها.
  • افتح الدردشة من زرّك أنت. يضيف المقتطف HyoNovaChat إلى صفحتك: HyoNovaChat.open() يفتح الدردشة وHyoNovaChat.close() يغلقها. وإلى جانبه يضيف المقتطف اسماً عاماً واحداً آخر لاستخدامه هو، ولا شيء غير ذلك.

سياسة أمان المحتوى#

الموقع الذي يرسل سياسة أمان المحتوى (Content-Security-Policy) يجب أن يسمح بالدردشة. وإلا حجبها المتصفح ولم يظهر زر الدردشة.

التوجيهاسمح بـ
script-srchttps://chat.hyonova.com
frame-srchttps://chat.hyonova.com
  • شيفرة تثبيت نسختها سابقاً. تحمّل الدردشة من عنوان الدردشة السابق لدى HyoNova. وما دامت تلك الشيفرة في موقعك فأبقِ العنوان الموجود في خاصية src فيها مسموحاً به في script-src وframe-src أيضاً، أو ضع مكانها نسخة جديدة من ودجات دردشة الموقع.
  • رابط التضمين يحتاج إلى frame-src فقط.
  • لا حاجة إلى شيء آخر. لا تحمّل الدردشة خطوطاً ولا تنسيقات ولا صوراً إلى صفحتك.

وإن بقي الزر مفقوداً فراجع لا يظهر زر الدردشة في موقع له سياسة أمان المحتوى.

النطاقات المسموح بها#

لا تبدأ الدردشة إلا على المواقع التي يطابق عنوانها مُدخلاً في النطاقات المسموح بها (حتى 50 مُدخلاً). يتحقق HyoNova من العنوان الحقيقي للصفحة التي تضمّن الدردشة، كما يبلّغ عنه المتصفح.

المُدخليطابقلا يطابق
example.comhttps://example.comhttps://www.example.com، https://shop.example.com
www.example.comhttps://www.example.comhttps://example.com
*.example.comhttps://www.example.com، https://shop.example.com، https://eu.shop.example.comhttps://example.com نفسه
example.com:8443https://example.com:8443https://example.com

القواعد:

  • أضف كليهما example.com و*.example.com إن كان يجب أن تعمل الدردشة على النطاق الرئيسي ونطاقاته الفرعية.
  • HTTPS فقط. الصفحات المقدَّمة عبر http:// العادي لا تستطيع تحميل الدردشة.
  • لا يُسمح بـ * وحدها. يجب أن يكون كل مُدخل نطاقاً حقيقياً.
  • القائمة الفارغة لا تسمح بأي موقع. وعندها تعمل الأداة عبر رابط الدردشة المباشر فقط.
  • عناوين HyoNova نفسه مرفوضة. لا يمكنك إضافة عنوان يخص HyoNova نفسه، مثل عنوان تطبيق HyoNova أو عنوان الدردشة. ويُرفض كذلك المُدخل ذو النجمة الذي يشمل أحدها.

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

يفتح رابط الدردشة المباشر الدردشة بملء الصفحة على عنوان دردشة HyoNova، chat.hyonova.com، فلا يعتمد على موقعك. شاركه في توقيعات البريد أو في الحسابات الاجتماعية أو في رمز QR. والرابط الذي شاركته سابقاً ما زال يعمل. أوقف رابط الدردشة المباشر في خطوة النشر في الأداة لإيقافه؛ وعندها يعرض الرابط This chat is not available.

رابط التضمين#

رابط التضمين هو الدردشة كصفحة توضع داخل إطار في صفحتك، مثلاً في مركز مساعدة. استخدمه حين تريد الدردشة داخل تخطيط صفحتك بدلاً من زر عائم.

انسخ رابط التضمين من بطاقة الأداة في ودجات دردشة الموقع واستخدمه عنواناً لإطار <iframe> عادي. ولا حاجة معه إلى مقتطف التثبيت.

html
<iframe src="YOUR_EMBED_URL" title="Chat" style="width: 400px; height: 600px; border: 0"></iframe>
  • على النطاقات المسموح بها فقط. يجب أن تكون الصفحة التي تحمل الإطار على نطاق موجود في النطاقات المسموح بها. ترفض المتصفحات عرض الدردشة داخل إطار على أي موقع آخر، ويتحقق HyoNova من الموقع الذي يحمل الإطار مجدداً قبل بدء الدردشة.
  • دع المتصفح يسمّي صفحتك. لا تضع referrerpolicy="no-referrer" على الإطار. فبعض المتصفحات تستخدم المُحيل (referrer) لتخبر الدردشة بالموقع الذي يحمل الإطار؛ وبدونه يبقى الإطار فارغاً.
  • سياسة أمان المحتوى. إن كان موقعك يرسلها فاسمح بالعنوان https://chat.hyonova.com في frame-src. ورابط التضمين الذي نسخته سابقاً ما زال يعمل؛ فأبقِ عنوانه مسموحاً به في frame-src ما دمت تستخدمه. راجع سياسة أمان المحتوى.
  • تملأ الدردشة الإطار، فأعطِ الإطار الحجم الذي تريده. وقواعد الصفحات لا تنطبق داخل الإطار.

الاتصال وعدم الاتصال#

يُعدّ الفريق متاحاً حين تكون ساعات عمل الأداة (إن ضُبطت) مفتوحة ويكون وكيل واحد على الأقل من طابور الأداة بحالة متاح. وإن لم يكن للطابور أعضاء، يُحتسب أي وكيل بحالة متاح.

ولا يُعدّ الوكيل بحالة متاح إلا ما دام قد اختار متاح وكان HyoNova مفتوحاً لديه. وخلال نحو ثلاث دقائق من إغلاق HyoNova يُعدّ الوكيل بعيداً لدى الزوار، مع أن الحالة التي اختارها لا تتغيّر. راجع متى تُعدّ متاحاً.

وحين لا يوجد من يرد وليست للزائر محادثة مفتوحة، تفعل الأداة ما اخترته في خارج ساعات العمل. ورغم اسمه، ينطبق هذا الإعداد كلما لم يوجد من يرد — حتى داخل ساعات عملك حين لا يكون أي وكيل بحالة متاح.

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

رسالة خارج الدوام هي النص الذي يراه الزوار حين لا يوجد من يرد. اتركها فارغة لاستخدام الصياغة الافتراضية للدردشة.

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

نموذج ما قبل الدردشة#

فعّل اطلب البيانات قبل الدردشة في نموذج ما قبل الدردشة لطلب بيانات قبل الرسالة الأولى. لكل من الاسم والبريد والهاتف اختر لا يُطلب أو اختياري أو مطلوب.

تُحفظ البيانات التي يكتبها الزائر على المحادثة لكنها غير موثّقة: لا يربط HyoNova أبداً دردشةً بعميل في العملاء بناءً على بريد أو هاتف كتبه الزائر. القرار للوكيل. راجع سياق العميل.

المرفقات#

حين يكون يمكن للزوار إرفاق ملفات مفعّلاً، يستطيع الزائر إضافة ملفات إلى الرسالة:

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

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

مؤشر الكتابة ومعاينة الكتابة#

للإعداد أثناء الكتابة، في خطوة الخصوصية والميزات، ثلاثة خيارات:

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

تبدأ المؤشرات بعد وجود محادثة، أي بعد أول رسالة من الزائر.

معاينة الكتابة المباشرة متوقفة ما لم تخترها، وهي مصمّمة لتشارك أقل قدر ممكن:

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

لمعرفة ما يراه الوكيل راجع مسودة العميل.

خيارات أخرى للأداة#

الخيارما يفعله
الحالةفعّالة أو معطّلة. الأداة المعطّلة لا تُحمَّل في أي مكان، ويتوقف رابطها المباشر، وتنتهي المحادثات المفتوحة للزوار فيها
يمكن للزوار إرفاق ملفاتيتيح للزوار إرفاق ملفات. وإيقافه يعني النص فقط. راجع المرفقات
صوت التنبيهيشغّل صوتاً قصيراً حين يصل رد والزائر لا ينظر إلى المحادثة
استبيان رضا العملاء (CSAT)بعد حل التذكرة يطلب من الزائر تقييمها من 1 إلى 5. ويجب أن يكون إعداد الشركة مفعّلاً أيضاً
رابط سياسة الخصوصية ورابط الشروطروابط HTTPS تظهر في أسفل الدردشة
إظهار «Powered by HyoNova»السطر في أسفل الدردشة. لا يمكنك إخفاؤه إلا إذا كانت خطة شركتك تتضمن ميزة دردشة الدعم بدون علامة HyoNova؛ وبدونها يكون المفتاح معطّلاً ويظهر السطر دائماً. والأداة الجديدة تعرضه دائماً حتى أول حفظ
رابط الدردشة المباشريشغّل رابط الدردشة المباشر أو يوقفه. راجع رابط الدردشة المباشر

الخصوصية#

  • لا حساب ولا تتبّع عبر المواقع. لا يسجّل الزوار الدخول. تحتفظ الدردشة برمز قصير الأجل صالح لساعتين، ومفتاح استئناف يتيح للمتصفح نفسه مواصلة الدردشة حتى 30 يوماً. ولا يصل أي منهما إلا إلى محادثات ذلك الزائر على تلك الأداة.
  • ما يكتبه الزائر فقط. ترسل الدردشة إلى HyoNova رسائل الزائر وملفاته، وعنوان الصفحة التي فُتحت فيها الدردشة، ولغة الصفحة، ولغة المتصفح، ليستطيع فريقك الرد في السياق. ولا تقرأ أي شيء آخر من صفحتك.
  • عنوان الصفحة دون سلسلة الاستعلام ودون ما بعد علامة #. لا يُرسل ولا يُحفظ إلا الموقع والمسار. ويُترك كل ما بعد ? أو #، لأن ذلك الجزء من العنوان قد يحمل رموزاً أو مفاتيح.
  • الصفحة التي يراها وكلاؤك. يرى الوكلاء هذا العنوان باسم الصفحة بجانب المحادثة. وهو دائماً عنوان في الموقع الذي ثُبّتت فيه الدردشة: الصفحة التي فيها زر الدردشة، أو الموقع نفسه حين تكون الدردشة داخل إطار. والمحادثة التي جاءت عبر رابط الدردشة المباشر لا تعرض صفحة.
  • عدّادات لا نصوص. لأجل تحليلاتك تعدّ الدردشة ما حدث بالاسم — مثل أن الدردشة فُتحت أو أن بحثاً في المساعدة لم يجد شيئاً. ولا يحمل العدّاد نصاً ولا عنوان صفحة ولا شيئاً عن الزائر.
  • ما يُحفظ في متصفح الزائر. إضافة إلى مفتاح الاستئناف، يتذكر المتصفح اختيار الزائر للغة، ويتذكر 30 يوماً إجابته عن مشاركة ما يكتبه.
  • معاينة الكتابة اختيار الزائر. دون موافقته لا يغادر أي نص غير مُرسل جهازه. راجع مؤشر الكتابة ومعاينة الكتابة.
  • مقالات المساعدة عامة. يستطيع كل زائر لأداة فُعّلت فيها مقالات المساعدة قراءة مقالاتك المنشورة. أما مستندات شركتك ومعرفتها الأخرى فلا تُعرض للزوار أبداً.
  • حدود ضد إساءة الاستخدام. يستطيع الزائر بدء خمس محادثات جديدة على الأكثر في الساعة، والطلبات محدودة المعدل.
  • سياستك. أضف رابط سياسة الخصوصية إلى الأداة، واذكر دردشة HyoNova للدعم في إشعار الخصوصية على موقعك. راجع الخصوصية.
↑↓ للتنقل · Enter للفتح · Esc للإغلاق