دليل المستخدم والمسؤول

يصف هذا الدليل العمل في لوحة تحكم برنامج Parsewise وفي أداة الدردشة القابلة للتضمين. صاحب الحقوق هو رائد الأعمال الفردي Ruslan Khuvazhievich Krylov. تتوفر الواجهة باللغتين الروسية والإنجليزية؛ وأسماء الأقسام والحقول والأزرار مذكورة هنا مترجمة إلى العربية.

تُسمّى في هذا الدليل مساحة العمل التي تُحفظ فيها قاعدة المعرفة وإعدادات المساعد والدردشات والفريق مشروعًا.

دليل المستخدم هو الأقسام 1–3 و5 و9. ودليل المسؤول هو جميع الأقسام.

1. بنية اللوحة

على اليسار قائمة المشروع. تتوقف محتويات القائمة على دور المشارك.

فوق القائمة مبدّل المشاريع، وفي أسفلها قائمة الحساب.

2. الأدوار

الضيف مستخدم خارجي مدعو برسالة بريد أو برابط الضيوف. لا يرى الضيف إلا الدردشات التي أنشأها بنفسه.

3. الدخول والحساب

الدخول

تحتوي صفحة «الدخول» على حقلي «البريد الإلكتروني» و«كلمة المرور»، ومربع «تذكرني»، ورابط «نسيت كلمة المرور؟». أسفل النموذج، في كتلة «أو تابع عبر»، أزرار الدخول عبر Yandex ID وVK ID و«الدخول المؤسسي (SSO)». يعمل الدخول المؤسسي إذا كان SSO مُعدًّا لمؤسسة المستخدم؛ وإلا يُبلغ البرنامج بأن الدخول عبر SSO غير مُعدّ لهذا النطاق.

التسجيل

1. افتح صفحة «التسجيل» عبر رابط «إنشاء حساب» في صفحة الدخول.
2. املأ حقول «البريد الإلكتروني» و«الاسم» و«اسم العائلة» و«كلمة المرور» و«تأكيد كلمة المرور». يجب أن تحتوي كلمة المرور على 8 أحرف على الأقل، وحرف لاتيني كبير وآخر صغير ورقم.
3. إن شئت، حدّد «تلقّي رسائل عن تحديثات المنتجات».
4. حدّد الموافقة «أقبل شروط الاستخدام وسياسة الخصوصية». شروط الاستخدام منشورة على https://parsewise.ru/policy/offer، وسياسة الخصوصية على https://parsewise.ru/policy/privacy.
5. اضغط «التسجيل».
6. أدخل الرمز المكوّن من ستة أرقام من الرسالة واضغط «تأكيد». إذا لم تصل الرسالة، اضغط «إعادة إرسال الرمز».

استعادة كلمة المرور

1. في صفحة الدخول اضغط «نسيت كلمة المرور؟».
2. أدخل عنوان البريد الإلكتروني واضغط «إرسال الرابط».
3. افتح الرابط في الرسالة وعيّن كلمة مرور جديدة.

قائمة الحساب

تحتوي القائمة على «حسابي» و«تبديل الحساب» و«إضافة حساب» و«سياسة الخصوصية» و«إرسال ملاحظات» و«الخروج». يمكن الاحتفاظ بعدة حسابات في متصفح واحد والتبديل بينها دون إعادة إدخال كلمة المرور؛ وتُحذف الحسابات الزائدة في نافذة «إدارة الحسابات».

إعدادات الحساب

4. المشروع

إنشاء مشروع

1. في مبدّل المشاريع اختر «مشروع جديد…».
2. أدخل «اسم المشروع» و«وصف المشروع». يساعد الوصف المساعدَ على فهم سياق التواصل بشكل أفضل.
3. اضغط «إنشاء المشروع».

الرئيسية

يفتح قسم «الرئيسية» نظرة عامة على المشروع. في الترويسة أزرار «الإعدادات» و«روابط الدعوة» و«دعوة مشارك»؛ والزرّان الأخيران متاحان للمالك والمسؤول.

تعرض كتلة «التحليلات» مؤشرات الفترة المختارة: «الدردشات المنشأة»، «متوسط الرسائل في الدردشة»، «متوسط مدة الجلسة»، «متوسط التقييم»، «المنتجات المقترحة»، «الملفات الشخصية المقترحة»، «مرات عرض المستندات»، «المهارات المقترحة»، «مرات تشغيل الموصلات». وأدناها قوائم «الدردشات الأخيرة» و«السلاسل الأخيرة» و«المنتجات الأخيرة» و«آخر الملفات الشخصية» و«آخر الملفات».

الإعدادات العامة

قسم «الإعدادات ← عام» متاح للمالك والمسؤول.

يحذف زر «حذف المشروع» في ترويسة القسم المشروع بجميع بياناته، وهو متاح لمالك المشروع فقط. للتأكيد يجب إدخال اسم المشروع.

النطاقات الخاصة

كتلة «النطاقات الخاصة» في قسم «الإعدادات ← عام» متاحة للمالك والمسؤول. تتيح فتح صفحة المشروع على نطاق المؤسسة الخاص.

1. اضغط «إضافة نطاق»، وأدخل النطاق وتعليقًا عند الحاجة، ثم اضغط «حفظ».
2. اضغط «تحقّق» في سطر النطاق. تُفتح نافذة «ربط النطاق» مع سجلات DNS؛ ويُنسخ قيمة السجل بالنقر على سطره.
3. أضف السجلات لدى مسجّل النطاق: TXT — لتأكيد الملكية، وA — للنطاق الجذري أو CNAME — للنطاق الفرعي.
4. اضغط «تحقّق» في النافذة. إذا عُثر على السجلات، يُبلغ البرنامج بتأكيد النطاق والبدء في إعداد الربط، ثم يُضبط الربط وشهادة SSL تلقائيًا. وإن لم يُعثر عليها، يُبلغ البرنامج بأن سجلات DNS غير موجودة أو تشير إلى مكان خاطئ.

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

5. الدردشات

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

الدردشة هي المراسلة كاملة مع المساعد؛ ويقسّم البرنامج الدردشة إلى سلاسل — أجزاء من المراسلة حول سؤال واحد للمستخدم، تُسمّى فروعًا في كتلة «الأسئلة».

المحادثة

1. اضغط «دردشة جديدة» أو افتح دردشة من القائمة.
2. اكتب رسالة في حقل «اكتب رسالة...» واضغط «إرسال». يمكن إرفاق ملفات بالرسالة: حتى 10 ملفات، وحتى 5 في المرة الواحدة، بحجم لا يتجاوز 10 ميغابايت لكل منها.
3. يجيب المساعد بنص وبطاقات منتجات وملفات شخصية وبطاقات مهارات، وإذا فُعّل «إبراز الملفات» في إعدادات المشروع — بملفات قاعدة المعرفة مع إبراز المقطع الذي استند إليه. يفتح النقر على الملف نافذة «تفاصيل الملف» مع أزرار «تنزيل» و«فتح» و«الإجابة من المستند». يضيف الزر الأخير إشارة إلى المستند في حقل الإدخال: أرسل الرسالة كما هي ليجيب المساعد عن السؤال السابق من هذا المستند فقط، أو أضف بجانبها سؤالًا جديدًا. يبقى الرابط الذي يُفتح به الملف صالحًا مدة لا تتجاوز ساعة.
4. قيّم الإجابة بأزرار «سيئ» أو «متوسط» أو «جيد».
5. لتقييم الدردشة كاملة، اضغط «تقييم» وامنح من نجمة إلى خمس نجوم مع تعليق.

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

التحليلات

ترتيب الكتل على الصفحة من الأعلى إلى الأسفل.

تُعاد بناء قائمة الأسئلة مرة يوميًا. وتُحدَّد فترة الجمع في قسم «عام»، كتلة «الأسئلة».

6. قاعدة المعرفة

الملفات

1. اضغط «رفع الملفات» أو اسحب الملفات إلى نافذة القسم.
2. إذا وُجد ملف بالاسم نفسه، يعرض البرنامج نافذة «عُثر على ملفات مكررة»: «رفع» يحفظ نسخة، و«استبدال» يستبدل الملف الموجود.

تقبل اللوحة ملفات حتى 50 ميغابايت: مستندات PDF وDOC وDOCX وXLS وXLSX وPPT وPPTX وTXT وCSV وJSON وXML وMD وRTF وODT وODS وODP وHTML، وكذلك الصور والفيديو والصوت والأرشيفات. يُستخرج النص لإجابات المساعد من الصيغ المذكورة في «الخصائص الوظيفية»، القسم 3.3؛ وتُخزَّن الملفات الأخرى دون فهرسة.

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

المنتجات

الإنشاء يدويًا. يفتح زر «إنشاء منتج» نموذجًا:

الاستيراد من ملف. يقبل زر «استيراد من ملف» ملفات CSV وXLSX وXLS وJSON وXML وYML وYAML. إذا كانت في المشروع منتجات بالفعل، يعرض البرنامج رفعها مجددًا أو استبدال الموجودة.

تغذية عبر رابط. يفتح زر «الرفع عبر رابط» نافذة «تغذيات المنتجات». يمكن إضافة رابط أو أكثر إلى تغذية بصيغ YML أو XML أو CSV أو XLSX أو JSON. تُزامَن التغذية مرة يوميًا وبالزر؛ وتُطابَق المنتجات حسب رمز المنتج.

بطاقة المنتج. تعرض كتلة «تحليلات المنتج» «مرات الاقتراح» و«مرات فتح البطاقة» و«النقرات على CTA» و«التحويل» للفترة المختارة. يحذف زر «حذف المنتج» المنتج.

الملفات الشخصية

يحتوي قسم «الملفات الشخصية» على كتالوج الأشخاص الذين يوصي بهم المساعد: الأخصائيين والموظفين والمستشارين.

• «إنشاء ملف شخصي» — إنشاء الملف يدويًا.
• «استيراد من ملف» — رفع ملفات CSV وXLSX وXLS وJSON وXML وYML وYAML؛ تُحدَّد مطابقة الأعمدة لحقول الملف الشخصي تلقائيًا.
• «الرفع عبر رابط» — نافذة «تغذيات الملفات الشخصية»؛ تُزامَن التغذية مرة يوميًا وبالزر، وتُطابَق الملفات الشخصية حسب الرمز الخارجي — الرقم الوظيفي أو معرّف الموظف أو الرمز من نظام CRM.

7. المساعد

الشخصية

قسم «الشخصية» متاح للمالك والمسؤول والمحرر. تحتوي كتلة «إعدادات المساعد» على حقل «اسم المساعد» — الاسم الذي يظهر في دردشة الأداة — وحقل «قواعد الإجابة (اختياري)» حيث تُحدَّد بنص حر نبرة الإجابات وأسلوبها وحدودها. يمكن رفع «صورة المساعد الرمزية» أو اختيارها من الصور القياسية في مجموعتي «صور فوتوغرافية» و«رسوم توضيحية».

المهارات

قسم «المهارات» متاح للمالك والمسؤول والمحرر؛ أما حذف المهارة ونشرها وإرسالها للمراجعة وإلغاء نشرها فللمالك والمسؤول فقط. المهارة قدرة للمساعد لها واجهتها الخاصة في شريط الإجابة: بطاقة تفاعلية، نموذج، حاسبة، جدول مواعيد.

1. ثبّت مهارة من الكتالوج بزر «المتجر» أو ارفع ملفًا بزر «رفع .skill».
2. عند رفع ملف من طرف ثالث، أكّد الثقة في نافذة «هل تثق بهذه المهارة؟» بزر «الثقة والتثبيت».
3. إذا وُجدت مهارة بالاسم نفسه، اختر «تحديث» أو «إنشاء نسخة».

يفتح زر «منشئ المهارات» مواد تطوير مهاراتك الخاصة. يمكن تعطيل عدة مهارات أو حذفها عبر «وضع التحديد».

تحتوي بطاقة المهارة على كتل «عام» و«البطاقة» و«اللوحة الجانبية» و«الموارد» و«الطلبات» و«الموصلات» و«السجلات». تُجمع في كتلة «الطلبات» بيانات نماذج المهارة، ويمكن تصديرها بزر «تنزيل CSV»؛ ويُصدَّر سجل الاستدعاءات بزر «تنزيل .log». الإجراءات على المهارة:

الموصلات

قسم «الموصلات» متاح للمالك والمسؤول والمحرر؛ وحذف الموصل للمالك والمسؤول فقط. الموصل حزمة دون واجهة تمنح المساعد الوصول إلى أدوات الأنظمة الخارجية.

1. ثبّت موصلًا بزر «المتجر» أو ارفع ملفًا بزر «رفع .skill».
2. عند رفع ملف من طرف ثالث، أكّد الثقة بزر «الثقة والتثبيت».
3. في البطاقة افتح كتلة «الموصلات» واضغط «إعداد» لتعيين أسرار التفويض.
4. تحقّق من أدوات الخادم بزر «اختبار».

الأداة

قسم «الأداة» متاح للمالك والمسؤول والمحرر. تعرض كتلة «التحليلات» «مرات ظهور الأداة» و«مرات فتح الأداة» و«الدردشات المنشأة» و«التحويل».

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

تثبيت الأداة على الموقع. ينقل زر «التثبيت» في ترويسة القسم إلى التعليمات. تتوفر في قائمة «اختر المنصة» HTML/CSS وTilda و1C-Bitrix وInSales وOpenCart وShop-Script وCS-Cart وuniSiter وSmink وWordPress وNext.js وReact وAngular؛ وتُعرض لكل منصة خطوات تفصيلية. لموقع HTML:

1. انسخ رمز التثبيت بالنقر على حقل الرمز.
2. افتح ملف HTML للموقع، مثل index.html أو القالب الرئيسي.
3. الصق الرمز قبل وسم الإغلاق </head>.
4. احفظ الملف وافتح الموقع: سيظهر زر الأداة في أسفل الصفحة.

8. الفريق، رموز API، الفوترة

الفريق

قسم «الفريق» متاح للمالك والمسؤول.

1. اضغط «دعوة مشارك»، وأدخل «عنوان البريد الإلكتروني» و«الدور» — مسؤول أو محرر أو مراقب أو ضيف — واضغط «إرسال الدعوة».
2. لدعوة عدة أشخاص، اضغط «روابط الدعوة» وأنشئ رابطًا بزر «للمسؤولين» أو «للمحررين» أو «للمراقبين» أو «للضيوف». يمكن نسخ الروابط النشطة أو حذفها.

في نافذة المشارك يمكن تغيير الدور في حقل «تغيير الدور» وحفظه، وإزالة المشارك بزر «إزالة المشارك»، وللدعوة غير المؤكدة — «إلغاء الدعوة». يمكن للمالك الضغط على «جعله مالكًا» وتأكيد «نقل الملكية» بإدخال كلمة transfer؛ وبعد النقل يصبح المالك السابق مسؤولًا.

رموز API

قسم «رموز API» متاح للمالك والمسؤول.

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

تظهر في قائمة الرموز تاريخ الإنشاء و«آخر استخدام». تُحذف الرموز غير اللازمة عبر «وضع التحديد».

الفوترة

قسم «الفوترة» متاح للمالك والمسؤول ويحمل عنوان «الفوترة والاستخدام».

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

إجراءات الدفع:

1. اضغط «دفع الفريق» أو «دفع السلاسل».
2. أدخل عدد المقاعد أو السلاسل شهريًا — لا يقل عن الحد الأدنى — وتحقّق من مبلغ «المستحق للدفع».
3. اطّلع على شروط العرض العام عبر الرابط https://parsewise.ru/policy/offer واضغط «الانتقال إلى الدفع».

يُدفع الاستخدام الزائد على الحجم المدفوع بحسب الفعلي في نهاية الفترة. تُدفع المقاعد المضافة إلى المجمّع السنوي لخطة «الفريق» بالسعر الشهري للمقعد عن كل شهر متبقٍ حتى نهاية المدة السنوية. يمكن إلغاء الاشتراك في خطة «الفريق» بزر «إلغاء الاشتراك».

للمنتج المدفوع يُعيَّن صمام أمان للإنفاق عبر رابط «تغيير»: «حد المقاعد» — لا يمكن دعوة مشارك بعد تجاوزه؛ «حد السلاسل شهريًا» — عند بلوغه يتوقف المساعد عن فتح سلاسل جديدة حتى نهاية الشهر. إذا لم يُعيَّن حد، تسري القيم الافتراضية: 200 مقعد و10,000 سلسلة شهريًا. لا يمكن أن يقل حد المقاعد عن الباقة الدنيا، ولا حد السلاسل عن الحجم المدفوع؛ والحقل المُفرَّغ يلغي الحد.

9. الأداة على الموقع

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

تتوفر في نافذة البحث والإجراءات الدردشات الأخيرة والبحث فيها والإجراءات «دردشة جديدة» و«تنزيل السجل» و«المساعدة». أسفل حقل الإدخال يظهر رابط سياسة الخصوصية https://parsewise.ru/policy/privacy.

إذا اختير في قسم «الأداة» وضع «المسجلون فقط»، يرى الزائر غير المسجل في الموقع رسالة تفيد بأن الدردشة متاحة للمستخدمين المسجلين فقط.