دليل الإعداد والاستخدام الكامل

البدء

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

• أنشئ الحساب من صفحة التسجيل ثم سجّل الدخول من صفحة الدخول.
• أضف مفتاح أوبن إيه آي API وتأكد من أن الردود تعمل في المحادثات التجريبية.
• حدّد مسؤوليات الفريق قبل فتح النظام للزوار الفعليين.

إعداد الودجت

التفعيل والتحديثات

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

التهيئة المثالية

مشكلات البداية

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

المحادثات

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

• استخدم حالات واضحة مثل: مفتوحة، مُعيّنة، معلّقة، محلولة.
• استخدم الوسوم لتحديد المصدر والأولوية ونوع العميل المحتمل.
• عيّن مالك المحادثة مبكرًا لتفادي الردود المكررة.
• احتفظ بقوالب رد أولي للسيناريوهات المتكررة.

المحرر والمرفقات والملاحظات

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

المستخدمون والوكلاء والمشرفون

• حدّد الصلاحيات بدقة: عارض، وكيل، مشرف.
• أضف فقط الحقول الضرورية في نماذج التسجيل والملف الشخصي.
• اربط الوكلاء بالأقسام لتبسيط التوجيه.
• راجع الحسابات غير النشطة دوريًا وأوقف غير المستخدمة.

الإعدادات

ساعات العمل

يمكن ضبط جدول ساعات العمل من Settings > Miscellaneous > Office hours. يُستخدم هذا الجدول في رسالة عدم التوفر، وإخفاء الشات خارج الدوام، وتعطيل أو تفعيل الشات بوت بحسب الوقت.

• إذا كان لليوم فترة واحدة فقط فضع وقت البداية والنهاية في الحقلين الأولين.
• لا تترك القيم فارغة؛ استخدم closed عندما يكون اليوم مغلقًا بالكامل.
• التوقيت يعتمد على UTC ويمكن ضبطه من Settings > Miscellaneous > Timezone.

المقالات

قاعدة المعرفة تساعد على الرد الفوري وتقليل حجم الدعم. يمكن عرض المقالات داخل لوحة الشات أو عبر شورت كود [articles] أو عبر صفحة مستقلة في الموقع.

• فعّل عرض المقالات من Settings > Articles > Display in dashboard.
• يمكن عرض المقالات في ووردبريس عبر [sb-articles].
• إذا أردت إخفاء الودجت في صفحة المقالات استخدم <script>var SB_DISABLED = true;</script>.
• مقالاتك تُستخدم أيضًا في تدريب الشات بوت؛ أعد التدريب بعد التعديلات المهمة.

اللغة

يدعم Chat365 لغات متعددة ويمكنه اكتشاف لغة المستخدم تلقائيًا.

• يمكن ضبط لغة الواجهة من Settings > Chat > Language أو فرضها عبر وسيط lang.
• يمكن ترجمة النصوص من Settings > Translations.
• يمكن فرض لغة الإدارة في النسخ المستضافة ذاتيًا عبر SB_ADMIN_LANG داخل config.php.
• لإضافة لغة جديدة انسخ ملف اللغة المناسب داخل مجلدات resources/languages.

الأقسام

الأقسام تسمح بتوزيع المحادثات على فرق مختلفة مثل المبيعات والدعم والفوترة.

• أضف الأقسام من Settings > Miscellaneous ثم اربط الوكلاء بها من صفحة المستخدمين.
• المشرفون أو الوكلاء بدون قسم معيّن يمكنهم رؤية جميع الأقسام.
• يمكن تعيين القسم عبر Q&A أو Flows أو الجافاسكربت أو API.

خدمات أمازون ويب

أمازون S3

يمكن رفع المرفقات إلى أمازون S3 بدلًا من خادم التثبيت. أنشئ مستخدم IAM بصلاحيات S3، احصل على مفاتيح الوصول، أنشئ الـ bucket، ثم احفظ الاسم والمنطقة والمفاتيح في Settings > Miscellaneous > أمازون S3.

• الميزة تقنية واختيارية.
• قد يحتاج تفعيل الـ bucket أو صلاحياته بعض الوقت قبل الاستقرار.

إعدادات إضافية

الردود الجاهزة

الردود الجاهزة هي رسائل محفوظة مسبقًا يمكن للوكلاء إدراجها سريعًا من Settings > Admin > Saved replies.

• اكتب # ثم اسم الرد الجاهز ومسافة لإدراجه.
• اكتب ## لفتح نافذة الردود الجاهزة.
• استخدم \n لإضافة سطر جديد.

كوبايلوت

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

الرسائل المباشرة

تسمح لك الرسائل المباشرة بإرسال رسالة شات أو بريد أو رسالة نصية إلى مستخدم واحد أو عدة مستخدمين.

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

الأتمتة

تُنفّذ الأتمتة مهامًا متعددة اللغات تلقائيًا عند تحقق الشروط التي تحددها.

• الأتمتة تُرسل مرة واحدة فقط لكل مستخدم.
• لإعادة إرسالها لمستخدمين استلموها سابقًا يجب حذفها وإنشاؤها من جديد.
• بعض الشروط تعتمد على تفعيل Register all visitors وFull visitor details.
• الأتمتة غير متوافقة مع قنوات المراسلة مثل واتساب وماسنجر وتيليجرام وغيرها.

النشرة البريدية

يمكن ربط النظام مع مزودي النشرات مثل Mailchimp وBrevo وSendGrid وHubSpot وMailerLite وغيرهم باستخدام مفتاح API ومعرف القائمة المناسب لكل مزود.

• يحدث الاشتراك عادة عبر التسجيل أو رسائل المتابعة أو رسائل الاشتراك أو الشورت كود البريدي.
• راجع صفحة المزود نفسه للحصول على API key وList ID الصحيحين.

الطابور والتوجيه

عند تفعيل Queue أو Routing من إعدادات Miscellaneous يقوم Chat365 بتوزيع المحادثات تلقائيًا على الوكلاء المتاحين بشكل نسبي.

• يُحتسب فقط الوكلاء المتصلون كـ "متاحين" افتراضيًا.
• إذا لم يكن أي وكيل متصلًا تبقى المحادثة غير معيّنة حتى يتصل أول وكيل.
• المشرفون يرون كل المحادثات لكنهم لا يدخلون في معادلة التوزيع.
• لإنهاء المحادثة فعليًا يجب على الوكيل أرشفتها حتى ينتقل إلى المحادثة التالية.
• يمكن التعيين عبر Q&A أو Flows أو قائمة الوكلاء أو الجافاسكربت أو API.

الإشعارات

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

إشعارات البريد الإلكتروني

• يمكن للوكلاء والمستخدمين استلام تنبيه عند وصول رسالة جديدة.
• يستخدم النظام قالب البريد الموجود في Settings > Notifications > Email template.
• يجب تضمين {content} داخل القالب.
• عادة يتم إرسال إشعار واحد فقط، ثم لا تتكرر الإشعارات اللاحقة لنفس السياق مباشرة.
• إشعارات الوكلاء تُرسل فقط للوكلاء أو المشرفين غير المتصلين بحسب القسم أو التعيين الحالي.
• إشعارات المستخدم تُرسل فقط إذا كان المستخدم غير متصل.

مهمة كرون للبريد

• فعّل Email notifications via cron job إذا أردت أن تتم الإشعارات عبر كرون.
• استخدم المسار [CHAT365-URL]/include/api.php?email-notifications=true.
• في النسخة السحابية استخدم رابط API السحابي المزوّد بالتوكن.

الإشعارات الفورية

• الإشعارات الفورية تعمل عبر Pusher أو OneSignal، وOneSignal مطلوب لأجهزة iOS.
• في النسخة السحابية تكون OneSignal مفعلة افتراضيًا في بيئة الإدارة.
• يجب أن يعمل الموقع عبر HTTPS كي تعمل الإشعارات الفورية بشكل صحيح.
• عندما تكون الإشعارات الفورية مفعلة فإنها تستبدل Desktop notifications.

إشعارات الرسائل النصية

• تعتمد على Twilio وتدعم التنبيه الثنائي الاتجاه عبر SMS.
• يجب إدخال Account SID وAuth Token ورقم الإرسال في إعدادات التنبيهات النصية.
• في النسخة التجريبية من Twilio لا يمكن الإرسال إلا إلى الأرقام الموثقة.
• كل أرقام الهواتف يجب أن تتضمن رمز الدولة مع +.

الإشعارات الصوتية

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

إشعارات تيليجرام

يمكن للوكلاء استلام التنبيهات عبر قناة تيليجرام مرتبطة بالبوت المتزامن مع Chat365.

1. انتقل إلى Settings > تيليجرام > Notifications واضغط Activate.
2. حدّد اسم القناة بدقة ثم احفظه.
3. أنشئ قناة تيليجرام بالاسم نفسه.
4. أضف البوت كمسؤول في القناة.

الذكاء الاصطناعي

هذه الإعدادات تخص تطبيق الذكاء الاصطناعي داخل Chat365.

التثبيت

من Settings > Apps اختر Artificial Intelligence وأدخل مفتاح الترخيص. في النسخة السحابية استخدم زر التفعيل المباشر.

التحويل إلى وكيل بشري

• يحدث التحويل عندما يرد وكيل بشري على المستخدم أو عندما يفشل الشات بوت في الفهم ويكون خيار Human takeover مفعّلًا.
• عندما يتفعّل التحويل يتم تعطيل الشات بوت مؤقتًا بحسب حالة الوكيل وسياق المحادثة.
• يمكن إرسال رسالة احتياطية للمستخدم أثناء انتظار الوكيل، بحد أقصى مرة كل 30 دقيقة.
• الميزة تعمل كذلك عبر قنوات مثل واتساب وماسنجر وتيليجرام.

الرد الذكي

• يقترح ردودًا سريعة أثناء المحادثة اعتمادًا على الشات بوت الخاص بك.
• يدعم اكتشاف اللغة والترجمة متعددة اللغات إذا كانت هذه المزايا مفعلة.
• يمكن استعادة الرسالة السابقة عبر CTRL + Z.

التهيئة المثالية للشات بوت

• حسّن بيانات التدريب باستمرار من لوحة التدريب.
• فعّل الرد الذكي وChatbot وSpelling Correction وRewrite Message Button.
• درّب الشات بوت بمحتواك الخاص وفعّل ميزات جوجل اللغوية إذا كان جمهورك متعدد اللغات.
• غيّر اسم البوت من Settings > Users > Bot name.

استكشاف المشاكل

• افتح Console في المتصفح وأرسل رسالة لاختبار الأخطاء الظاهرة من أوبن إيه آي أو جوجل.
• تحقق أولًا من عدم وجود Human takeover نشط يمنع رد الشات بوت.
• إذا كانت الجودة ضعيفة فأعد تدريب البيانات أو ابدأ بإعدادات أوبن إيه آي أساسية ثم أضف الخيارات تدريجيًا.

أوبن إيه آي

هذه الإعدادات تخص تكامل أوبن إيه آي داخل تطبيق الذكاء الاصطناعي.

المزامنة

الوضع التلقائي

• متاح فقط في النسخة السحابية.
• يتم ضبطه من Settings > Artificial Intelligence > أوبن إيه آي > Sync mode.
• يتطلب رصيد الرصيد.

الوضع اليدوي

• أنشئ حساب أوبن إيه آي واحصل على API key.
• ألصق المفتاح في إعدادات أوبن إيه آي داخل Chat365.
• في النسخة السحابية غيّر Sync mode إلى Manual إذا كنت ستستخدم مفتاحك الخاص.

الشات بوت

1. أكمل المزامنة.
2. فعّل خيار Chatbot واحفظ التغييرات.
3. اختبر من مساحة Chatbot داخل النظام.
4. عند وجود مشكلة استخدم زر Troubleshoot problems.

تكاملات الشات بوت

يدعم Chat365 تكاملات مثل جوجل Calendar وTidyCal لحجز المواعيد وإدارتها عبر الشات بوت وبأسلوب محادثي متعدد اللغات.

• جوجل Calendar وTidyCal يدعمان الحجز والتعديل والإلغاء وعرض الأوقات المتاحة.
• يمكن ضبط مدة الموعد وBuffer time والحد الأدنى للحجز من الإعدادات المرتبطة.

إعدادات أوبن إيه آي

• اختر Chatbot mode بحسب نوع الأسئلة التي تريد دعمها.
• فعّل Small talk إذا أردت ردودًا اجتماعية بسيطة.
• يمكن استخدام أوبن إيه آي Assistant في وضع Assistant.
• رسالة Fallback تُستخدم عندما لا يفهم أوبن إيه آي السؤال.
• Prompt يحدد أسلوب الرد ويجب أن يتضمن عبارة "I don't know" عند الحاجة إذا كنت تستخدم Human takeover.
• تتوفر خيارات إضافية مثل Spelling correction وSpeech recognition وImage/file analysis وSource links وContext awareness.

التدريب

• يمكن التدريب عبر الملفات وخرائط الموقع وQ&A والمقالات وFlows والمحادثات.
• إعادة التدريب تضيف مصادر جديدة ولا تحذف القديمة إلا إذا حذفت البيانات يدويًا.
• يمكن تشغيل التدريب دوريًا عبر كرون في النسخ التي تدعم ذلك.
• يدعم التدريب متعدد اللغات عندما تكون المصادر واللغة الافتراضية مضبوطة بشكل صحيح.

Q&A وFlows وTools calling

• Q&A تسمح بربط أسئلة المستخدم بردود محددة وإجراءات مثل تعيين القسم أو الوسوم.
• Flows تسمح ببناء سيناريوهات محادثة موجهة باستخدام كتل متعددة.
• Tools calling يربط الشات بوت بخوادم أو أنظمة خارجية لإرجاع بيانات ديناميكية.

جوجل

هذه الإعدادات تخص خدمات جوجل داخل تطبيق الذكاء الاصطناعي.

المزامنة

• في الوضع التلقائي داخل النسخة السحابية اضغط Synchronize now وأكمل الخطوات.
• في الوضع اليدوي يجب تفعيل Cloud Natural Language API وCloud Translation API وجوجل Calendar API وإعداد OAuth وإدخال Client ID وClient Secret وRefresh token.
• إذا كنت تستخدم جوجل Workspace فقد تحتاج إلى تعطيل طلب إعادة المصادقة المتكررة.

الترجمة التلقائية

• تترجم رسائل المستخدم إلى لغة الوكيل ورسائل الوكيل إلى لغة المستخدم.
• يلزم تفعيل Cloud Translation API والفوترة في جوجل Cloud.
• يمكن للوكلاء عرض النص الأصلي من قائمة الرسالة.
• يمكن منع ترجمة نص معيّن بوضعه بين backticks.

التعدد اللغوي عبر الترجمة

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

اكتشاف اللغة

• يكتشف لغة أول رسالتين تقريبًا من المستخدم ويحدّث لغة الحساب بناءً على ذلك.
• يجب أن تحتوي الرسالة على كلمتين على الأقل.
• يمكن استخدام {language_name} داخل رسالة fallback.

جوجل search

• يمنح الشات بوت القدرة على جلب معلومات لحظية عندما لا يعرف الإجابة.
• يتطلب إعداد Programmable Search Engine وAPI key المناسب.
• الميزة اختيارية ولا تُعد شرطًا لتصحيح الإملاء.

التذاكر

تطبيق Tickets يوفّر واجهة مختلفة عن الشات لإنشاء المحادثات وإرسال الرسائل.

التثبيت

من Settings > Apps اختر Tickets وأدخل مفتاح الترخيص. في النسخة السحابية استخدم زر التفعيل.

عرض واجهة التذاكر

• في PHP أضف سكربت التهيئة مع ?mode=tickets.
• في ووردبريس استخدم الشورت كود [sb-tickets].
• في النسخة السحابية أضف &mode=tickets إلى رابط السكربت.
• يمكن تفعيل الواجهة داخل صفحة الشات عبر SB_TICKETS = true;.

معلومات

• إذا لم تظهر الواجهة تأكد من عدم تفعيل Manual initialization للتذاكر.
• على مستوى الإدارة، التذاكر هي محادثات عادية والاختلاف فقط في واجهة العميل.
• بعض إعدادات الشات متوافقة مع Tickets وبعضها غير متوافق مثل بعض عناصر الـ dashboard والـ popup.
• تدعم جوجل reCAPTCHA v3.

واتساب

هذه الإعدادات تخص تطبيق واتساب.

التثبيت

من Settings > Apps اختر واتساب وأدخل مفتاح الترخيص. في النسخة السحابية استخدم زر التفعيل.

واتساب Cloud API - الوضع التلقائي

• متاح فقط في النسخة السحابية.
• اضغط Synchronize now وأكمل خطوات المزامنة.
• إضافة الأرقام الجديدة تتم من Meta واتساب Manager ثم يُعاد التزامن.
• إذا لم تصل الرسائل إلى Chat365 فراجع إعادة الربط وفوترة Meta.

واتساب Cloud API - الوضع اليدوي

• أنشئ تطبيق Meta واستخدم إعدادات الويب هوك ورمز التحقق ومفاتيح الوصول الدائمة.
• أضف Phone number ID والتوكن في إعدادات Chat365.
• للأرقام الحقيقية والإنتاج يجب استكمال صلاحيات Meta والمراجعة المناسبة.

إعداد 360dialog وTwilio

• يدعم Chat365 أيضًا 360dialog وTwilio لتكامل واتساب.
• في 360dialog أدخل API key ثم استخدم Synchronize now.
• في Twilio أدخل Account SID وAuth Token واضبط Webhook sandbox أو الرقم الإنتاجي.

القوالب والمكالمات والتدفقات

• القوالب مطلوبة عند تجاوز نافذة 24 ساعة الخاصة بـ واتساب.
• يمكن ضبط متغيرات Header وBody وButtons بحسب القالب المستخدم.
• تتوفر مكالمات صوتية/فيديو عند إعداد واتساب calling template المناسب.
• يدعم النظام Flows وShop عبر حقول الدمج الخاصة بواتساب.

معلومات إضافية

• المحادثات متوافقة مع queue وrouting.
• يدعم الشات بوت وHuman takeover وميزات اللغة والترجمة والبحث.
• إذا فشل الاستقبال أو الإرسال فتحقق من الويب هوك والتوكن والأقسام والرقم المستخدم في الاختبار.
• الـ sandbox وبعض الموفرين مثل Twilio و360dialog لديهم قيود إضافية.

ماسنجر

هذه الإعدادات تخص تطبيق ماسنجر وارتباطه بـ Instagram عند الحاجة.

التثبيت

من Settings > Apps اختر ماسنجر وأدخل مفتاح الترخيص.

المزامنة التلقائية

• اختر صفحة Facebook واحدة على الأقل واحفظ البيانات في Settings > ماسنجر > Facebook pages.
• تتم مزامنة الرسائل الجديدة فقط، وليس الرسائل القديمة.

المزامنة اليدوية

• أنشئ تطبيق Meta مع الصلاحيات المطلوبة لـ ماسنجر وInstagram والصفحات.
• اضبط Callback URL وVerify Token وحقول الـ webhook والتوكنات داخل Chat365.
• إذا أردت مزامنة التعليقات أو Instagram فعليك إضافة الصلاحيات والحقول المناسبة ثم إرسال التطبيق للمراجعة عند الحاجة.

التعليقات والمعلومات

• تعليقات Facebook وInstagram يمكن تحويلها إلى محادثات داخل النظام.
• يمكن إرسال DM تلقائي لأول مرة يعلّق فيها المستخدم إذا تم ضبط ذلك.
• إذا ظهرت رسائل مكررة فتأكد من عدم ربط الحساب نفسه بأكثر من تثبيت Chat365.
• القناة تدعم الشات بوت وHuman takeover والميزات اللغوية الأساسية.

تويتر

هذه الإعدادات تخص تطبيق تويتر.

• أنشئ تطبيقًا من تويتر Developer Portal، واحصل على مفاتيح API وConsumer Secret وAccess Token وAccess Token Secret.
• اطلب Elevated access ثم فعّل Account Activity API sandbox حسب متطلبات تويتر.
• اضبط Callback URL من Chat365 ثم اضغط Subscribe بعد حفظ الإعدادات.
• لا يمكن الاختبار من localhost، والرسائل المباشرة لها نافذة رد محدودة.
• القناة تدعم الشات بوت وHuman takeover وبعض الرسائل الغنية بحدود المنصة.

تيليجرام

هذه الإعدادات تخص تطبيق تيليجرام.

• ثبّت التطبيق من Settings > Apps ثم احصل على توكن البوت من BotFather.
• ألصق التوكن في Settings > تيليجرام > Token ثم اضغط Synchronize now.
• يتطلب HTTPS، وتظهر الرسائل الجديدة داخل لوحة المحادثات في Chat365.
• القناة متوافقة مع queue وrouting وتدعم الشات بوت وHuman takeover.

إشعارات تيليجرام

• يمكن للوكلاء استلام إشعارات عبر قناة تيليجرام مخصصة.
• يجب أن يتطابق اسم القناة بين إعدادات Chat365 وتيليجرام.
• أضف البوت كمسؤول في القناة ليتمكن من إرسال الإشعارات.

فايبر

هذه الإعدادات تخص تطبيق فايبر.

• ثبّت التطبيق ثم أنشئ البوت من منصة فايبر Partners.
• ألصق التوكن في إعدادات فايبر داخل Chat365 ثم اضغط Synchronize now.
• يلزم HTTPS.
• القناة متوافقة مع queue وrouting وتدعم الشات بوت وHuman takeover.

سلاك

هذه الإعدادات تخص تطبيق سلاك.

• ثبّت التطبيق ثم انتقل إلى Settings > سلاك واضغط Synchronize now.
• إذا فشلت المزامنة فتأكد من اختيار قناة عامة أثناء الربط.
• إذا استطعت الاستقبال دون الإرسال، راجع إعدادات القنوات العامة وملف /supportboard/apps/slack/post.php.
• يمكن ربط الأقسام بقنوات سلاك وإظهار بعض تفاصيل المستخدم في القناة الرئيسية.

معلومات

• تُنشأ قناة مخصصة لكل مستخدم أو محادثة بحسب إعدادات الدمج.
• عند أرشفة المحادثة في Chat365 يمكن أرشفة قناة سلاك المرتبطة أيضًا.
• التكامل يعمل مع email piping والقنوات الأخرى ويدعم التوافق مع الإشعارات.

لاين

هذه الإعدادات تخص تطبيق لاين.

• أنشئ Messaging API channel من لاين Developers.
• أدخل Channel secret وAccess token وWebhook URL في إعدادات لاين داخل Chat365.
• فعّل Use webhook وامسح QR code لاختبار الرسائل.
• الملصقات غير مدعومة، لكن القناة تدعم الشات بوت وHuman takeover والتوجيه.

ويتشات

هذه الإعدادات تخص تطبيق ويتشات.

• أنشئ Service account وأكمل التحقق من ويتشات Official Account.
• أدخل App ID وApp Secret وToken وConfiguration URL داخل الإعدادات المناسبة.
• إذا ظهرت أخطاء access token فتأكد من IP whitelist داخل إعدادات ويتشات.
• المرفقات والروابط لها قيود خاصة في ويتشات، لكن القناة تدعم التوجيه والشات بوت.

زالو

هذه الإعدادات تخص تطبيق زالو.

• أنشئ App من منصة زالو Developers وأدخل Application ID وSecret key في إعدادات Chat365.
• اضبط Webhook URL وOA Secret Key وفعل الأحداث المطلوبة.
• اربط Official Account ثم احصل على Refresh token من API Explorer.
• القناة متوافقة مع queue وrouting وتدعم الشات بوت وHuman takeover والميزات اللغوية الأساسية.

زنديسك

هذه الإعدادات تخص تطبيق زنديسك.

• ثبّت التطبيق ثم أدخل subdomain الخاص بـ زنديسك والبريد وAPI token.
• يقوم Chat365 بمزامنة التذاكر الجديدة أو المحدثة مع زنديسك تلقائيًا.
• يتم الربط بين المستخدمين عادة عبر البريد الإلكتروني أو رقم الهاتف.

بيرفكس

هذه الإعدادات تخص تطبيق بيرفكس.

• يتطلب التكامل تثبيت تطبيق بيرفكس داخل Chat365 وتثبيت Support Board module داخل بيرفكس.
• أدخل بيانات قاعدة البيانات والرابط من ملفات بيرفكس ثم اضبط Support Board plugin URL داخل بيرفكس.
• إذا تغيّرت بيانات قاعدة البيانات فتأكد من تحديث supportboard/config.php يدويًا أيضًا.

WHMCS

هذه الإعدادات تخص تطبيق WHMCS.

• يتطلب الربط تثبيت App داخل Chat365 بالإضافة إلى add-on داخل WHMCS.
• أدخل بيانات قاعدة البيانات والرابط في إعدادات WHMCS داخل Chat365.
• فعّل Addon Module داخل WHMCS ثم أدخل رابط Support Board plugin URL.
• عند التحديثات اليدوية استبدل مجلد add-on بالإصدار الجديد.

أوبن كارت

هذه الإعدادات تخص تطبيق أوبن كارت.

• أدخل بيانات أوبن كارت وAPI key واسم المستخدم بعد تفعيل مستخدم API داخل لوحة أوبن كارت.
• أضف متغيرات Support Board المطلوبة في ملفات header.php وheader.twig.
• ارفع ملف sb.php إلى catalog/controller/api.
• حاليًا الدعم مخصص لـ أوبن كارت 3، وقد تحتاج لإعادة تطبيق التعديلات بعد التحديثات.

أكتيف إي كومرس

هذه الإعدادات تخص تطبيق أكتيف إي كومرس.

• ثبّت التطبيق ثم أدخل بيانات قاعدة البيانات والرابط وAPP_KEY من ملف .env.
• أضف كود الدمج داخل ملف footer.blade.php في أكتيف إي كومرس.
• يمكن استيراد البائعين وربط المحادثات ببائعي المنتجات عند تفعيل الخيارات المناسبة.
• إذا حدث أكتيف إي كومرس فغالبًا ستحتاج لإعادة إدراج كود الدمج.

مارتفوري

هذه الإعدادات تخص تطبيق مارتفوري.

• أدخل بيانات قاعدة البيانات والرابط وSecret key من ملف .env.
• احصل على مارتفوري path عبر ملف المساعدة داخل مجلد /public.
• أضف كود الودجت إلى مارتفوري Admin > Appearance > Custom JS > Footer JS.
• يدعم وضع Private chat واستيراد البائعين وربطهم بالمتاجر الصحيحة.

ووردبريس

هذه الإعدادات تخص نسخة Chat365 المثبّتة داخل ووردبريس.

• يمكن مزامنة مستخدمي ووردبريس تلقائيًا عند اختيار ووردبريس كنظام المستخدمين.
• يمكن إنشاء مستخدم ووردبريس عند تسجيل زائر داخل Chat365 إذا كانت الحقول المطلوبة موجودة.
• يمكن الدخول مباشرة إلى لوحة الإدارة من مسار plugin المباشر لاستخدام وضع PWA أيضًا.
• إذا أردت أن تتبع لغة الشات لغة الصفحة، عطّل Settings > Chat > Language.

تعطيل Emoji الخاص بووردبريس

يمكنك منع استبدال الإيموجي في الشات عبر إضافة الكود التالي إلى functions.php:

function disable_emojis() {
     remove_action("wp_head", "print_emoji_detection_script", 7);
     remove_action("admin_print_scripts", "print_emoji_detection_script");
     remove_action("wp_print_styles", "print_emoji_styles");
     remove_action("admin_print_styles", "print_emoji_styles");
}
add_action("init", "disable_emojis");

ووكومرس

هذه الإعدادات تخص تطبيق ووكومرس لنسخة ووردبريس من Chat365.

• بعد التثبيت يستطيع الشات بوت الإجابة عن أسئلة المتجر تلقائيًا.
• يدعم التكامل WPML وPolylang للتعدد اللغوي.
• يمكن استخدام حقول دمج وشورت كود لعرض المنتجات والأسعار والطلبات والكوبونات داخل الرسائل.
• يمكن تعطيل Store integration والاعتماد بدلًا منه على تدريب الموقع إذا كانت الإجابات غير دقيقة.
• يدعم واتساب shop عندما تتطابق معرّفات المنتجات بين ووكومرس وكاتالوج واتساب.

أسئلة شائعة مدمجة للشات بوت

• هل لديكم أحذية بأقل من 299 دولار؟
• اعرض لي الحقائب.
• ما حالة طلبي؟
• أضف منتجًا إلى السلة أو احذفه منها.
• إلى أين تقومون بالشحن؟

ألتميت ممبرشيب برو

هذه الإعدادات تخص تطبيق ألتميت ممبرشيب برو.

• ثبّت التطبيق من Settings > Apps. هذا التطبيق غير متاح للنسختين السحابية وPHP.
• بعد التثبيت أدخل بيانات أكتيف إي كومرس وAPP_KEY كما هو موضح في الإعدادات ذات الصلة.
• تتم مزامنة المستخدمين الجدد تلقائيًا، ويمكن استيراد المستخدمين الحاليين يدويًا من إعدادات ووردبريس.
• يمكن تقييد الوصول إلى خطة محددة باستخدام الشورت كود المخصص مع تفعيل Manual init.

إيه آر ممبر

هذه الإعدادات تخص تطبيق إيه آر ممبر.

• ثبّت التطبيق من Settings > Apps. التطبيق غير متاح للنسختين السحابية وPHP.
• بعد التثبيت أدخل بيانات أكتيف إي كومرس وAPP_KEY من ملف .env.
• تتم مزامنة المستخدمين الجدد تلقائيًا ويمكن استيراد المستخدمين الحاليين من إعدادات ووردبريس.
• يُعتبر المستخدم عضوًا مدفوعًا فقط إذا كان لديه على الأقل خطة مدفوعة نشطة وغير منتهية.

النسخة السحابية

هذا القسم يخص النسخة السحابية فقط والمتاحة على cloud.board.support.

الرصيد

• يُستخدم الرصيد فقط عند العمل في وضع المزامنة التلقائية.
• تُستهلك الاعتمادات في خدمات جوجل اللغوية وأوبن إيه آي وكوبايلوت وNote data scraping.
• يمكن التحويل بين Automatic وManual sync في أي وقت من الإعدادات.

التسعير

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

شوبيفاي

• تكامل شوبيفاي متاح فقط في النسخة السحابية.
• بعد تثبيت تطبيق Support Board على شوبيفاي يظهر الودجت على المتجر ويمكن للشات بوت الوصول إلى المنتجات والمجموعات والـ variants والـ tags تلقائيًا.
• للمتاجر متعددة اللغات اضبط لغة الشات على Multilingual.
• يمكن استخدام {shopify product_id="12345678"} لعرض بطاقات المنتجات.

معلومات إضافية

• ستجد API token داخل صفحة التثبيت في حسابك السحابي.
• يمكن التبديل بين الحسابات من Settings > Admin > Switch accounts.
• إذا ظهرت شاشة بيضاء أضف reset-login إلى الرابط ثم أعد المحاولة.

متفرقات

هذا القسم يضم ميزات مساندة غير مذكورة في الأقسام السابقة.

تطبيق ويب تقدمي

• لوحة الإدارة يمكن تثبيتها كتطبيق على سطح المكتب أو الهاتف.
• في Chrome استخدم زر التثبيت أو Add to Home Screen، وفي Safari استخدم Share ثم Add to Home Screen.
• في ووردبريس استخدم رابط الإدارة المباشر [SUPPORT-BOARD-URL]/admin.php.
• يمكن تخصيص اسم وأيقونة الـ PWA عبر ملف manifest.json.

اختصارات لوحة المفاتيح

• ENTER أو SPACE للتأكيد أو إغلاق التنبيه.
• ESC للإلغاء أو إغلاق النوافذ.
• SHIFT+ENTER أو CTRL+ENTER لإضافة سطر جديد داخل المحرر.
• CTRL+V للصق صورة من الحافظة وإرسالها.
• CTRL + click لاختيار محادثات متعددة.

config.php

• يمكن استخدام SB_UPLOAD_URL وSB_UPLOAD_PATH لتخصيص مسار الرفع.
• يمكن استخدام $GLOBALS['SB_LOCAL_SETTINGS'] لتجاوز بعض الإعدادات محليًا.

مهام كرون

• تعتمد بعض المهام المجدولة على زيارات الموقع، لكن يمكن تسريعها عبر كرون خارجي أو WEB API.
• المسار العام هو [SUPPORT-BOARD-URL]/include/api.php?cron=true.

السجلات

يمكن تفعيل السجلات من Settings > Miscellaneous > Logs في النسخ غير السحابية لمتابعة الرسائل والحذف والأرشفة والتعيينات وتعديلات المستخدمين.

وسائط URL

• ?token=TOKEN لتسجيل دخول مستخدم.
• ?conversation=ID لفتح محادثة.
• ?chat=open لفتح واجهة الشات.
• في الإدارة يمكن استخدام ?user=ID أو ?setting=ID أو ?area=conversations وغيرها.

Calendly وZapier وEnvato

• يمكن استخدام زر غني لفتح رابط Calendly مع رسالة نجاح مخصصة.
• يدعم Chat365 الربط مع Zapier عبر الويب هوك.
• يمكن التحقق من أكواد شراء Envato عبر API token المناسب.

الأمان والأداء

• يتضمن النظام حظر IP بعد محاولات الدخول الفاشلة، وحماية XSS وCSRF، وتشفير AES-256 لبعض البيانات الحساسة.
• يمكن أرشفة الرسائل القديمة وتعطيل التقارير أو المقالات لتحسين الأداء.
• يوجد دعم لـ Async PHP process عند توفر exec() وضبط المسار الصحيح لـ PHP.

مزامنة البريد الإلكتروني

تسمح مزامنة البريد الإلكتروني بمزامنة عدة عناوين بريد لاستقبال الرسائل مباشرة داخل Chat365، كما يتيح للمشرفين والوكلاء والمستخدمين الرد عبر البريد مع الحفاظ على ربط المحادثة.

التفعيل

• أدخل بيانات POP3/IMAP في Settings > Notifications > مزامنة البريد الإلكتروني.
• أدخل بيانات SMTP في Settings > Notifications > SMTP.
• يجب أن يكون عنوان المرسل في SMTP متطابقًا مع بريد مزامنة البريد الإلكتروني قدر الإمكان.

معلومات

• عند اختلاف عنوان SMTP عن صندوق مزامنة البريد الإلكتروني قد يضيف النظام reply-to للمحافظة على الترابط.
• تُفعّل إشعارات البريد للوكلاء والمستخدمين تلقائيًا عند تفعيل مزامنة البريد الإلكتروني.
• إذا كان خيار Convert all emails مفعّلًا فقد تتحول الرسائل الدعائية أو السبام إلى محادثات.
• رسائل الوكلاء والمشرفين من العناوين المسجلة لديهم لا تتحول عادة إلى محادثات جديدة.
• الميزة تدعم المرفقات والفلاتر والأقسام.
• في Gmail/جوجل Workspace استخدم App password بدل كلمة المرور العادية.
• الميزة تحتاج إلى IMAP extension على الخادم.

مهمة كرون

• يحاول النظام معالجة البريد دوريًا كل نحو 60 ثانية.
• يمكن تشغيلها يدويًا عبر [CHAT365-URL]/include/api.php?piping=true أو عبر API المناسبة.
• في النسخة السحابية استخدم رابط API السحابي مع التوكن.

بوشر

عند تفعيل Pusher من Settings > Miscellaneous > Pusher ينتقل النظام من AJAX polling إلى WebSockets لتحسين السرعة وحالة الكتابة والاتصال.

• أنشئ تطبيقًا من Pusher Channels واحصل على App ID وKey وSecret وCluster.
• أدخل القيم داخل إعدادات Pusher في Chat365.
• عند التفعيل تُستبدل طلبات التحقق المتكررة باتصال فوري عبر WebSockets.
• يُنصح بها إذا كان الخادم يعاني من حمل زائد أو بطء ناتج عن polling.

مكتبة التكاملات

استخدم صفحة التكاملات لتصفح التطبيقات والفئات المتاحة.

• ابحث بالاسم أو الفئة.
• اختبر بيانات الاعتماد أولًا في بيئة تجريبية.
• وثّق مالك كل تكامل والغرض منه داخل فريقك.

الويب هوك وواجهة API

• استخدم Webhooks موقعة أو تحقّق من مصدر الطلبات.
• صمّم المعالجة بحيث تتحمل إعادة المحاولة وعدم التكرار.
• سجّل الطلبات والردود مع correlation IDs لتسهيل التتبع.

تدفقات الأتمتة

• استخدمها في Lead scoring والوسوم والتوجيه والتحديثات الخارجية.
• للحِمل الكبير يفضّل استخدام queue workers أو بنية خلفية مناسبة لمعالجة الويب هوك.
• أضف تنبيهات للفشل أو توقف المهام الآلية.

مزامنة إدارة علاقات العملاء والأنظمة الخارجية

• زامن سجلات العملاء مع مصدر القناة ومرحلة العميل المحتمل.
• حافظ على ثبات مطابقة الحقول بين الأنظمة.
• استخدم Webhooks للتحديث شبه الفوري عند الحاجة.

قائمة الإطلاق

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

المشكلات الشائعة

إرشادات التشغيل

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

التواصل والاستفسارات

للاستفسارات العامة حول Chat365 تواصل مع فريقنا وسنرد عليك في أقرب وقت.

• البريد الإلكتروني: digital@gyanwave.com
• واتساب / الهاتف: +971 52 696 0842
• يرجى تضمين الاسم والشركة ونوع الاستفسار لتسريع المتابعة.