> For the complete documentation index, see [llms.txt](https://docs.mavibot.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mavibot.ai/doc/ar/chatbot/live-chat.md).

# الدردشة المباشرة على الموقع الإلكتروني

من خلال تثبيت دردشة عبر الإنترنت على موقعك، يمكنك جمع بيانات العملاء وأتمتة التواصل مع الزوار مباشرةً على موقعك.

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

## كيفية إنشاء موقع ويب للدردشة المباشرة

لإنشاء دردشة، انتقل إلى قسم "Messengers" وانقر على زر "Live chat".

<div data-with-frame="true"><figure><img src="/files/265821ab90d7ab6796206101a2e2124f4de5e2a1" alt=""><figcaption></figcaption></figure></div>

بمجرد أن تنقر على زر "Online chat"، ستُفتح لوحة الإعدادات للدردشة التي أنشأتها حديثًا تلقائيًا.

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

## الإعدادات

### التنسيق

<div data-with-frame="true"><figure><img src="/files/08c2e4bffb57ebfc668670fb346efd752c9966fc" alt="" width="563"><figcaption></figcaption></figure></div>

1. **عنوان الدردشة**

يحدد هذا الحقل اسم الدردشة عبر الإنترنت — وسيظهر في أعلى نافذة الدردشة مباشرةً.&#x20;

2. **العنوان الفرعي للدردشة**

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

3. **التسمية المحددة للويدجت**

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

4. **رسالة ترحيب الدردشة**

يحتوي هذا الحقل على نص رسالة التحية الأولية من الروبوت

<div data-with-frame="true"><figure><img src="/files/d58824214cd16018ff4ec66061a740cf48e84097" alt=""><figcaption></figcaption></figure></div>

5. **اتجاه النص**

باستخدام شريط أدوات محاذاة النص، يمكنك محاذاة عنوان الدردشة والعنوان الفرعي إلى اليسار أو اليمين أو الوسط — تمامًا كما في محررات النصوص القياسية.

<div data-with-frame="true"><figure><img src="/files/6aa6b8757dd0043cee100d6cbdab40eafdeab1ff" alt="" width="177"><figcaption></figcaption></figure></div>

6. زر الدردشة

<div data-with-frame="true"><figure><img src="/files/5b6b2f5f4364bc62ae5ccae7631c81bdc2d978e4" alt="" width="375"><figcaption></figcaption></figure></div>

تم تصميم هذا الزر لفتح الدردشة عبر الإنترنت عند النقر عليه.&#x20;

يمكنك اختيار كيفية ظهور زر الدردشة عبر الإنترنت على الأجهزة المختلفة: سطح المكتب الخاص بالموقع&#x20;

تتوفر عدة خيارات للعرض. يمكنك وضع الزر على الحافة اليمنى أو اليسرى.

7. لوحة الألوان

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

<div data-with-frame="true"><figure><img src="/files/0b2fbeb18d1967e4a360875e417acd2db3bd3e41" alt="" width="563"><figcaption></figcaption></figure></div>

يمكنك أيضًا اختيار لون الأنماط وسطوعها، بالإضافة إلى عناصر أخرى في الدردشة عبر الإنترنت. للقيام بذلك، فعّل مربع الاختيار "Advanced settings".

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

8. صورة رمزية للدردشة عبر الإنترنت

<div data-with-frame="true"><figure><img src="/files/672e4164bdafc4ec15868c2b0b865053e93c8f4f" alt="" width="563"><figcaption></figcaption></figure></div>

يتيح لك هذا الخيار تغيير الصورة الرمزية للمساعد في الدردشة عبر الإنترنت. يمكن إضافة الصورة الرمزية إما عبر عنوان URL أو عن طريق تحميل ملف.

يمكنك أيضًا إخفاء الصورة الرمزية للدردشة بتفعيل مربع الاختيار هذا، إذا لزم الأمر.

9. **شعار MaviBot**

تتيح الإعدادات عرض شعار MaviBot.

<div data-with-frame="true"><figure><img src="/files/13dedf6a103df3f13decb2e42546dcdce7d983a2" alt="" width="369"><figcaption></figcaption></figure></div>

### الإعدادات

<div data-with-frame="true"><figure><img src="/files/ad7e6a92ed02b4518f9eada0cc064bfb34f6b030" alt="" width="563"><figcaption></figcaption></figure></div>

1. **النص داخل حقل الإدخال**

افتراضيًا، يحتوي هذا الحقل على النص: "أدخل رسالتك واضغط Enter."

يمكنك تخصيص هذا النص أو تركه كما هو افتراضي.

2. **النص في النسخة المحمولة**

افتراضيًا، تم ضبط النص على: "اختر طريقة الاتصال المفضلة لديك."

3. **رسالة عند تعيين مشغّل إلى عميل**&#x20;

إذا أضفت #{operatorName} في هذا الحقل، فسيتم عرض اسم المشغّل المحدد في قسم "Employees".

يمكنك تعيين مشغّل يدويًا بالنقر على زر "Take client" أو "Transfer client" أثناء محادثة مع عميل. وبدلاً من ذلك، يمكنك ضبط التوزيع التلقائي للعملاء بين المشغّلين في قسم "Employees".&#x20;

<div data-with-frame="true"><figure><img src="/files/530991d8ef376b338246bdbe8e23d2e9535ea549" alt="" width="563"><figcaption></figcaption></figure></div>

4. **رسالة عند عدم اتصال المشغّلين**

افتراضيًا، ستظهر الرسالة التالية:
&#x20;"لا يوجد أي مشغّلين متصلين حاليًا. يرجى ترك رسالة لنا، وسنعاود التواصل معك في أقرب وقت ممكن."

يُؤخذ وضع "Online" للروبوت من قسم "Employees". الأوضاع الممكنة هي: Online وBreak وOffline.

<div data-with-frame="true"><figure><img src="/files/79bbdd3da18ba006120972f5e7c2a5dd4a984fde" alt="" width="563"><figcaption></figcaption></figure></div>

يمكنك أيضًا تغيير حالتك من الشريط العلوي أثناء وجودك في أي قسم من المشروع

5. **إشعارات صوتية في الدردشة عبر الإنترنت**

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

6. **إظهار المراسِل**

<div data-with-frame="true"><figure><img src="/files/31470e539cb267c899b4f3c05aa406782e2c2d40" alt="" width="367"><figcaption></figcaption></figure></div>

يمكنك اختيار المراسلات التي ستظهر على الموقع عند تمرير المؤشر فوق ويدجت الدردشة عبر الإنترنت (الأيقونة).

{% hint style="warning" %}
ستظهر أزرار المراسلة فقط بعد ربط هذه المراسلات بالمنشئ.
{% endhint %}

7. **إظهار المراسلات فقط**

إذا فعّلت هذا الخيار، فستظهر أزرار المراسلة فقط على الموقع. *سيتم تعطيل جميع وظائف الدردشة الأخرى عبر الإنترنت!*

<div data-with-frame="true"><figure><img src="/files/f3acffab8e57d5f688f0f06e756f2fb1e42aad5a" alt="" width="563"><figcaption></figcaption></figure></div>

8. **نص المراسلة**

افتراضيًا، يكون مضبوطًا على: "اكتب إلى".

<div data-with-frame="true"><figure><img src="/files/de0fd502bd1803a0dcda90cb62d91642814ebde9" alt="" width="563"><figcaption></figcaption></figure></div>

9. **رسالة بدء WhatsApp**&#x20;

سيظهر هذا النص في حقل الإدخال للمستخدم في WhatsApp عندما ينقر على الزر في موقعك. سيحتاج المستخدم فقط إلى الضغط على "إرسال".

تأكد أيضًا من تضمين هذا النص في شروط كتلة البداية في تسلسل رسائلك.

<div data-with-frame="true"><figure><img src="/files/7db4edfec5bdd6e2a04716f11869b77482e09788" alt="" width="375"><figcaption></figcaption></figure></div>

10. **روابط مخصصة**

بالإضافة إلى أزرار المراسلة، يمكنك الآن إضافة أزرار خاصة بك مع روابط مخصصة.

يمكنك تحديد عنوان URL للرابط وإضافة صورة في الإعدادات.

<div data-with-frame="true"><figure><img src="/files/66ba57b8653bd5b255958f7504c2e232ebd8f28f" alt="" width="563"><figcaption></figcaption></figure></div>

11. رفع ملف

يتيح لك هذا الإعداد استلام المرفقات من زوار الموقع، مثل الصور.

<div data-with-frame="true"><figure><img src="/files/123ead5278516216e782feed0c7d30826e1f7073" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
أقصى حجم ملف مسموح به للتحميلات الواردة عبر الدردشة عبر الإنترنت هو 20 ميغابايت.
{% endhint %}

12. **بيانات المستخدم**

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

<div data-with-frame="true"><figure><img src="/files/3020a20b811b66829c7bd61f020d29080bb8148c" alt="" width="375"><figcaption></figcaption></figure></div>

يمكن أن يكون تعبئة النموذج اختيارية أو إلزامية من خلال تفعيل "*جعل تعبئة النموذج إلزامية"* المبدّل.

مثال على الرسالة الأولى مع جمع البيانات.

<div data-with-frame="true"><figure><img src="/files/03875116b2c73b81c45ead01f58948e0b8fd5c52" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/bfbc2c943e5b6a3505799bcc3fce606d9e318608" alt="" width="375"><figcaption></figcaption></figure></div>

13. طلب اتصال هاتفي

يظهر مربع الاختيار "Callback request" في إعدادات الدردشة عبر الإنترنت إذا كانت ميزة الاتصالات الهاتفية مفعلة في المشروع.

#### *كيف يعمل*

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

{% hint style="info" %}
يتم تعيين الموظف تلقائيًا. عند اختيار الموظف، يتم التحقق من ما يلي:

* الحالة: على الدوام
* أي دور، بما في ذلك المدير
* تم تفعيل (ضبط) الاتصالات الهاتفية للموظف

بعد المكالمة، سيتم تعيين هذا الموظف كمسؤول عن المستخدم.
{% endhint %}

14. طلب الموافقة على معالجة البيانات الشخصية&#x20;

<div data-with-frame="true"><figure><img src="/files/fbdefc30a75c9bb5cd266d772e0f4d87c0eefb93" alt="" width="563"><figcaption></figcaption></figure></div>

هذا الخيار معطّل افتراضيًا. عند تفعيله، ستظهر رسالة تقول "أوافق على معالجة البيانات الشخصية" بالإضافة إلى الـ **زر "Confirm"** عند تشغيل الدردشة عبر الإنترنت لأول مرة.

مثال على الرسالة الأولى للحصول على الموافقة على معالجة البيانات الشخصية:

15. إعدادات زر البدء

<div data-with-frame="true"><figure><img src="/files/32c3bd4e28482b1aebd8646631f3211760a4b808" alt="" width="264"><figcaption></figcaption></figure></div>

النقر على ***"Add button"*** يفتح النموذج لإنشاء زر بدء:

<div data-with-frame="true"><figure><img src="/files/d8a2f05499c93f6949946c352f9c9711d900335d" alt="" width="563"><figcaption></figcaption></figure></div>

يمكن أن يكون للزر إحدى الوظائف التالية:

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

على سبيل المثال، يمكنك إنشاء زر باسم "العنوان"، وفي حقل "Message"، تحدد العنوان الدقيق وساعات العمل.

{% hint style="info" %}
سيكون النص في حقل "Message" من دون فواصل أسطر. يرجى أخذ ذلك في الاعتبار أثناء العمل.
{% endhint %}

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

<div data-with-frame="true"><figure><img src="/files/b525e3a7b0f498f7ecb468e0c6acd934f48738fb" alt="" width="375"><figcaption></figcaption></figure></div>

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

* **ستظهر الأزرار في النص في سجل الدردشة عبر الإنترنت (المبدّل).** فعّل هذا الخيار لإظهار الأزرار من نص منشئ القمع في سجل الدردشة عبر الإنترنت الخاص بالعميل.

16. إخفاء الدردشة عبر الإنترنت

<div data-with-frame="true"><figure><img src="/files/50cfbc36180f1ec910cd80352dc6c3be948641bc" alt="" width="207"><figcaption></figcaption></figure></div>

ليس من الضروري إزالة الدردشة عبر الإنترنت من الموقع. يمكنك ببساطة إخفاؤها باستخدام المبدّل المخصص لذلك.

### الإجراءات التلقائية

تعمل الإجراءات التلقائية على النحو التالي: لكي يتم تشغيل إجراء تلقائي، يجب تعيين شرط تشغيل محدد لذلك الإجراء.

<div data-with-frame="true"><figure><img src="/files/b6abc9848b5f199e8d6fabd134732a1e7ba91c39" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/e6e630a81b3934437539d082836618069ba8093a" alt="" width="563"><figcaption></figcaption></figure></div>

المزيد عن الشروط:

<div data-with-frame="true"><figure><img src="/files/4e1e14c8f909ce28641dca15657187950392e65b" alt="" width="563"><figcaption></figcaption></figure></div>

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

في هذه الحالة، يمكنك تعيين الشرط ليكون مساويًا أو غير مساوي. على سبيل المثال، إذا كنت بحاجة إلى تحديد مدينة أو بلد (أو قائمة دول) لا ينبغي أن يُفعّل فيها الإجراء التلقائي، فاختر "غير مساوي".&#x20;

4. **يوم الأسبوع**.
   &#x20;يعمل هذا الشرط كمشغّل للإجراءات التلقائية بناءً على يوم الأسبوع. يمكنك تحديد مربعات الاختيار بجانب أيام الأسبوع، وضبط الشرط على مساوي أو غير مساوي، واختيار الإجراء التلقائي الذي ستنفذه الدردشة عبر الإنترنت.

على سبيل المثال، يمكنك تحديد جميع أيام عمل المشغّلين/المديرين لتفعيل تواصلهم اللاحق مع العملاء.&#x20;

5. **عنوان URL للصفحة الحالية**. سيتم تفعيل الإجراء التلقائي بناءً على ما إذا كان عنوان URL يحتوي/لا يحتوي أو يساوي/لا يساوي رابطًا محددًا.
6. **رسالة المستخدم**. لتشغيل الإجراء التلقائي وفقًا لهذا الشرط، يجب أن يحتوي الحقل على كلمة محددة من المستخدم.

<div data-with-frame="true"><figure><img src="/files/acc1d5e8d630a4231aefde29f3ff95dc35512be0" alt="" width="563"><figcaption></figcaption></figure></div>

6. **الوقت على الصفحة**. هذا الشرط مشابه لوقت اليوم؛ ومع ذلك، إذا كانت قاعدة بيانات عملائك موزعة عبر مناطق زمنية مختلفة، فأنت بحاجة إلى أن يحدث هذا الإجراء التلقائي في الوقت المحلي نفسه لكل منطقة زمنية.
7. **الوقت منذ إغلاق نافذة MAviBot**. يتم ضبط هذا الشرط بطريقة مشابهة لوقت اليوم أو الوقت على الصفحة، لكنه يعتمد على فعل المستخدم المتمثل في إغلاق نافذة Salebot.
8. **الوقت منذ الرسالة الأولى للزائر.** سيتم تشغيل الإجراء التلقائي بعد فترة محددة (بالثواني) عقب الرسالة الأولى للعميل في الدردشة عبر الإنترنت.
9. **الوقت دون رد من المشغّل منذ الرسالة الأولى للمستخدم**. يتم ضبط هذا الشرط أيضًا بالثواني ويُفعّل بغض النظر عمّا إذا كان المشغّل قد رد على العميل أم لا.

إذا لزم الأمر، يمكن دمج الشروط، مما يسمح بتشغيل الإجراء التلقائي بناءً على عدة معايير:

<div data-with-frame="true"><figure><img src="/files/6ddd816a5ecbda4cfc25528abc401c6f02a0e5d9" alt="" width="563"><figcaption></figcaption></figure></div>

بعد ذلك، اختر أي إجراء ينبغي أن تنفذه الدردشة عبر الإنترنت تلقائيًا:

<div data-with-frame="true"><figure><img src="/files/9837da83317d23589fc45d5f9048a245ebb9b4c3" alt="" width="563"><figcaption></figcaption></figure></div>

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

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

### اللافتات

<div data-with-frame="true"><figure><img src="/files/b3cd6651b58c9987ef69f187aad33c2fe449b890" alt=""><figcaption></figcaption></figure></div>

يمكنك إضافة لافتات قابلة للنقر إلى نافذة بدء الدردشة في علامة التبويب "Banners". لننتقل إلى الإعدادات.

1. انقر على **"Add banner"**.

<div data-with-frame="true"><figure><img src="/files/f7062a5dcef06924008a9df9cebf7286a5a1c607" alt="" width="260"><figcaption></figcaption></figure></div>

2. حمّل صورة.

<div data-with-frame="true"><figure><img src="/files/0ba56adb97880d5ffcfc19846314fc646b80437e" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
حجم الصورة ثابت.

تنسيق الصورة الموصى به: إذا أضفت عنوانًا وعنوانًا فرعيًا، فاستخدم حجم لافتة **345x194 بكسل** أو **نسبة أبعاد 16:9**.
{% endhint %}

لجعل اللافتة قابلة للنقر (مما يتيح لعميلك اتباع رابط عند النقر عليها)، أدخل عنوان URL في الحقل المقابل.

<div data-with-frame="true"><figure><img src="/files/58c42d241fa87830d19948c435415ba3beb807a4" alt="" width="563"><figcaption></figcaption></figure></div>

بعد ذلك، حدّد عنوان اللافتة وعنوانها الفرعي إذا لزم الأمر.

<div data-with-frame="true"><figure><img src="/files/8a76b3a057fe34d373157fa1e5460de8ee5f6d6b" alt="" width="563"><figcaption></figcaption></figure></div>

أدخل العنوان والعنوان الفرعي، ثم انقر على **"Save"**.

<div data-with-frame="true"><figure><img src="/files/82b9ce764a697a33f4eec0caee9df4122bb3b194" alt="" width="563"><figcaption></figcaption></figure></div>

ستظهر اللافتة بعد ذلك في ويدجت الدردشة عبر الإنترنت.

<div data-with-frame="true"><figure><img src="/files/8c15fa71163055fc941603e1212f77b5764691a9" alt="" width="563"><figcaption></figcaption></figure></div>

لإيقاف لافتة عن العمل (عدم عرضها في الدردشة عبر الإنترنت)، بدّل المفتاح إلى الوضع غير النشط.

<div data-with-frame="true"><figure><img src="/files/a40fc3721453d65801ccf2335c2ef2bd42f35c37" alt="" width="563"><figcaption></figcaption></figure></div>

لتعديل أو حذف لافتة، انقر على **تعديل**.

### تقييم الجودة

<div data-with-frame="true"><figure><img src="/files/d2fd68f8428a7501ba4601b3d32bef9a2c3d19e7" alt="" width="375"><figcaption></figcaption></figure></div>

هناك قسم إعدادات إضافي في الدردشة عبر الإنترنت يسمى "Quality control". لتفعيل هذه الميزة، انتقل إلى علامة التبويب المقابلة في الإعدادات.

<div data-with-frame="true"><figure><img src="/files/c88bd04db70e9bdc88df99a080490c36b3fc3d02" alt="" width="563"><figcaption></figcaption></figure></div>

تتيح الوظيفة الاختيار بين ثلاثة مقاييس لتقييم الجودة: خمس نقاط، وثلاث نقاط، ونقطتان.

<div data-with-frame="true"><figure><img src="/files/97e6bb62e0aef0722511556d8399e85175d22bb5" alt="" width="563"><figcaption></figcaption></figure></div>

أدخل النص الذي سيظهر قبل التقييم في الحقل المقابل.

<div data-with-frame="true"><figure><img src="/files/7bff14797842b1e51b5106af2e34431a7d4a6722" alt=""><figcaption></figcaption></figure></div>

لا توجد قيمة افتراضية في هذا الحقل. إذا تركته فارغًا، فسيظهر النص التالي على لافتة تقييم الجودة.

يمكنك أيضًا تحديد اسم مخصص لحقل ملاحظات العميل.

<div data-with-frame="true"><figure><img src="/files/aa0629ec1b4533db7a238bbec87702fc00b77282" alt="" width="375"><figcaption></figcaption></figure></div>

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

يمكنك أيضًا تفعيل مربع اختيار لجعل تعليق ملاحظات العميل إلزاميًا.

<div data-with-frame="true"><figure><img src="/files/a91c03e6c57a8786aaec433a0da0fde838ba8f7c" alt="" width="363"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/ca8960c31ef915350d82d0f80cdb47702be4c60f" alt="" width="313"><figcaption></figcaption></figure></div>

#### مربع الاختيار "يمكن للمستخدم تقييم الدردشة"

<div data-with-frame="true"><figure><img src="/files/d6b8abe83b9f5a98563dd2ee34286b8f888986b9" alt="" width="563"><figcaption></figcaption></figure></div>

في قسم "Clients"، يمكن للمشغّل إنهاء الحوار أثناء المحادثة مع المستخدم. إذا كان هذا المربع مفعّلًا، فسيتمكن المستخدم من تقديم تقييم.

{% hint style="success" %}
لا يرى المشغّل التقييم الذي أعطاه العميل للمحادثة.
&#x20;ستكون جميع تقييمات الجودة متاحة في قسم "Analytics".
{% endhint %}

يمكن للمشغّل النقر على زر "End conversation" أثناء محادثة مع المستخدم. سيؤدي ذلك إلى فتح نموذج تأكيد لإجراء المشغّل:

<div data-with-frame="true"><figure><img src="/files/987a7059a65fc9681bd217324267fcffa3aa0db6" alt="" width="375"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/13959e919199e737e1891f444c372504a462c994" alt="" width="375"><figcaption></figcaption></figure></div>

إذا كانت خدمة البريد الإلكتروني متصلة في القنوات، فستظهر خيارات لإرسال الرسائل عبر البريد الإلكتروني.

بعد أن ينهي المشغّل المحادثة، يتم إرسال نموذج تقييم الجودة إلى المستخدم، ويُسجَّل التقييم نفسه في Analytics.

إذا لم يترك العميل تقييمًا، فستعرض الإحصاءات "لم يترك المستخدم تقييمًا."

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

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

<div data-with-frame="true"><figure><img src="/files/1d1630942d3ce16469776b62cd1b3dad2721cf84" alt=""><figcaption></figcaption></figure></div>

انسخ كود الدردشة عبر الإنترنت.

<div data-with-frame="true"><figure><img src="/files/f105d6966ba0ae90636c2a6694665ed690c006c4" alt=""><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/30709ee8eb094895610f68b6cda9a50a995d029d" alt="" width="563"><figcaption></figcaption></figure></div>

ثم، انتقل إلى **تحرير الموقع**.

<div data-with-frame="true"><figure><img src="/files/4e812f1c04a4066e979d7409d84763b147097ce7" alt="" width="563"><figcaption></figcaption></figure></div>

وانتقل إلى إعدادات الموقع.

<figure><img src="/files/c2a980b67ed7ea35bb05e7cb03863890575696b2" alt="" width="563"><figcaption></figcaption></figure>

في قسم **الألوان، والخطوط، وHTML** ، الصق كود الدردشة عبر الإنترنت المنسوخ في حقل **رأس كود HTML** الحقل.

<div data-with-frame="true"><figure><img src="/files/bc8bfa11c3b5d40d7e9f11205d56753acc86b80d" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
**الصق هذا الكود في كل صفحة من صفحات موقعك، داخل وسم `<head>` .**
{% endhint %}

&#x20;تم الآن ربط الدردشة عبر الإنترنت بموقعك بنجاح.

## إرسال نموذج ليملأه العملاء

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

<div data-with-frame="true"><figure><img src="/files/a4cad77db5130087ef18ee39a3f380a96e23da60" alt="" width="375"><figcaption></figcaption></figure></div>

يتم إرسال هذا النموذج باستخدام **online\_chat\_send\_form()** الدالة، التي تأخذ المعلمات التالية:

1. **name;**
2. **phone;**
3. **privacy;**
4. **callback** (تعمل هذه المعلمة فقط إذا كانت الاتصالات الهاتفية مدمجة في المشروع);
5. age;
6. email\_group\_ID (إذا أضفت هذه المعلمة مع بريد إلكتروني، فسيتم إنشاء عميل بريد إلكتروني وربطه بمستخدم الدردشة);
7. wa\_group\_ID (إذا أضفت هذه المعلمة مع رقم هاتف، فسيتم إنشاء جهة اتصال في WhatsApp وربطها بمستخدم الدردشة).
8. *إذا تم تحديد مجموعة غير موجودة، فسيتم إرسال النموذج، ولكن لن يتم إنشاء العميل.*

{% hint style="danger" %}

#### مهم

تُدخل جميع المعلمات كسلسلة واحدة مفصولة بفواصل.

*مثال على الإدخال في Calculator:* online\_chat\_send\_form("name,email,email\_group\_ID")
{% endhint %}

الإشعار الذي سيظهر في الدردشة بعد إرسال النموذج

<div data-with-frame="true"><figure><img src="/files/0e927490b6627ee97de493be667d15bd209dc4ce" alt="" width="371"><figcaption></figcaption></figure></div>

{% hint style="info" %}
يتم حفظ البيانات المرسلة عبر النموذج في متغيرات العميل.
&#x20;يمكنك رؤية المزيد من التفاصيل حول هذه المتغيرات أدناه في ملف تعريف العميل عبر الإنترنت.
{% endhint %}

#### <mark style="color:أحمر;">!</mark> online\_chat\_send\_form(arguments, texts)

يأخذ وسيطين مطلوبين.

arguments - سلسلة المعلمات

texts - اسم النموذج

على سبيل المثال، في Calculator، يمكنك إدخالها على هذا النحو: **online\_chat\_send\_form("name,phone", "مرحبًا، يرجى ملء النموذج**.**")**.

<div data-with-frame="true"><figure><img src="/files/e3d389dcb0175b01672a14c4657f473cc7f61e76" alt=""><figcaption></figcaption></figure></div>

مثال على استجابة الدردشة عبر الإنترنت.

<div data-with-frame="true"><figure><img src="/files/9cf3611a5a06b21683ccc8ca5afdf493ad0c371f" alt="" width="375"><figcaption></figcaption></figure></div>

## **إرسال رسائل إلى الدردشة**

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

`if(window.ChatBotPro) { window.ChatBotPro.sendMessageFromUser("Message") }`

على سبيل المثال، عندما ينقر المستخدم على زر، سيتم إرسال رسالة نيابةً عنه.

**تغيير إعدادات التلميح**

يمكنك ضبط الروبوت ليتفاعل مع هذه الرسالة.

يتم إدراج الكود في قسم HTML من إعدادات الموقع.

<div data-with-frame="true"><figure><img src="/files/0fbc12bea4c70467e0743c988435361476d33a94" alt=""><figcaption></figcaption></figure></div>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ar/chatbot/live-chat.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.