دليل التشغيل | آلزا بوت

البداية

تثبيت آلزا بوت

لتثبيت آلزا بوت على خادمك، اتبع الخطوات التالية:

افتح الأرشيف alz-bot 1.2.3.zip واستخرج المجلد في موقع خادمك الذي تختاره.
انتقل إلى الرابط http://[your-site]/alz-bot/admin.php وأكمل عملية التثبيت. قم بتبديل [your-site] بعنوان URL الخاص بموقع الويب الخاص بك. إذا قمت بتغيير اسم الدليل، قم بتبديل آلزا بوت بالاسم الجديد للدليل.
بمجرد اكتمال التثبيت، قم بتسجيل الدخول باستخدام البريد الإلكتروني وكلمة المرور التي أنشأتها في الخطوة السابقة وانتهيت!

عرض الدردشة

لعرض الدردشة على موقع الويب الخاص بك، قم بتضمين السكربتات التالية في <head></head> أو <footer></footer> من كل صفحة يتم فيها عرض الدردشة. قم بتبديل [YOUR-ALZ-BOT-URL] بعنوان URL لتثبيت آلزا بوت الخاص بك. مثال: https://example.com/alz-bot/js/main.js.

        <!-- غير مطلوب إذا كان jQuery قد تم تحميله بالفعل -->
        <script src="[YOUR-ALZ-BOT-URL]/js/min/jquery.min.js"></script>
        <script id="sbinit" src="[YOUR-ALZ-BOT-URL]/js/main.js"></script>

معلمات عنوان URL

lang=LANGUAGE-CODE انظر إلى الوثائق المتعددة اللغات للحصول على مزيد من التفاصيل.
url=APP-URL استخدم هذا المعلم إذا تم تغيير مجلد URL / التطبيق الخاص بك. قم بتبديل APP-URL بعنوان URL الكامل لمجلد التطبيق. يمكنك أيضًا تعريف العنوان URL عبر JavaScript: var SB_INIT_URL = "APP-URL".

هجرة الموقع

إذا قمت بنقل الدردشة إلى نطاق / عنوان URL جديد، يجب عليك تحرير ملف config.php (في مجلد آلزا بوت ) وتحديث الثابت SB_URL بالعنوان URL الجديد.

ضغط JS

لأسباب أداء، قد ترغب في تحميل ملف main.js المضغوط: [YOUR-ALZ-BOT-URL]/js/min/main.min.js. يرجى ملاحظة أنه إذا اتصلت بنا للحصول على الدعم، ستحتاج إلى إعادة تحميل الإصدار غير المضغوط مرة أخرى.

لتثبيت آلزا بوت على ورد بريس، اتبع الخطوات التالية:

انتقل إلى صفحة الإضافات وانقر على إضافة جديدة ثم تحميل الإضافة وقم بتحميل ملف alz-bot 1.2.3.zip.
بمجرد اكتمال التثبيت، يجب أن ترى عنصر القائمة الجديد المسمى آلزا بوت. أنتمت، سيتم عرض الدردشة تلقائيًا على جميع الصفحات.

لعرض الدردشة على موقع الويب الخاص بك، انتقل إلى https://alz-bot.techn-oviz.com/account/?tab=installation وانسخ رمز التضمين، ثم الصقه في صفحات موقع الويب الخاص بك. إذا كنت تستخدم ورد بريس يمكنك تحميل مكون إضافي آلزا بوت السحابة هنا.

المتطلبات

يجب أن يدعم مشروع الويب الخاص بك HTML و PHP، ويجب فتح صفحات تحتوي على الدردشة عبر متصفح الويب.
لا يمكن عرض الدردشة على صفحة HTML تم فتحها مباشرة على جهاز كمبيوتر محلي. استخدم خادمًا محليًا مثل Xampp بدلاً من ذلك.
يجب أن يسمح خادمك بالوصول إلى الملف التالي: alz-bot/include/ajax.php
إذا كنت تستخدم الإصدار الخاص بـ ورد بريس من آلزا بوت ولديك أي إضافات أمان مثبتة، يرجى التأكد من أنها لا تمنع ملف alz-bot/include/ajax.php.
JQuery 1.1+
PHP 7.4+
في إعدادات الخادم الخاص بك، يجب تمكين CURL و ZIP ARCHIVE وأن تعمل بشكل صحيح.
يجب أن تمنح أذونات القراءة والكتابة للملفات التالية في آلزا بوت التحميلات و الموارد/اللغة و التطبيقات. يجب أن يكون آلزا بوت قادرًا على حفظ وقراءة الملفات في هذه المجلدات.
MySQL 5.5+
MySQL - يجب تعطيل وضع SQL "ONLY_FULL_GROUP_BY" وإعداد "ANSI_QUOTES".
يجب أن تكون لجميع مجلدات آلزا بوت أذونات 755، ويجب أن تكون لجميع ملفات آلزا بوت أذونات 644.

بمجرد الانتهاء من التثبيت، يمكنك التحقق من متطلبات النظام من خلال الإعدادات > متنوع > متطلبات النظام.

التنشيط

لتنشيط آلزا بوت وتمكين جميع الميزات (بما في ذلك التحديثات وتشفير أكثر أمانًا)، يجب إدخال رمز الشراء تكنو فيز في الإدارة > الإعدادات > متنوع.

تثبيت التطبيقات

لتنزيل وتثبيت وتفعيل التطبيقات، انتقل إلى الإعدادات > التطبيقات في آلزا بوت وأدخل رمز الشراء تكنو فيز أو مفتاح الترخيص.

العثور على رمز الشراء تكنو فيز الخاص بك

التحديثات

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

تحديثات يدوية

لتحديث آلزا بوت والتطبيقات يدويًا، انتقل إلى https://alz-bot.com/synch/manual.php.

هل تواجه مشاكل؟

إذا كنت تواجه أي مشكلة على الإطلاق، يرجى الاتصال بفريق الدعم الودود لدينا على [email protected]. قبل الاتصال بنا، يرجى التأكد من أن خادمك يحتوي على جميع المتطلبات المذكورة أعلاه. على نفس النقطة، إذا كنت تستخدم الإصدار الخاص بـ ورد بريس، يرجى التأكد من أن تثبيت ورد بريس لديك يحتوي على جميع المتطلبات المذكورة أعلاه.

مشكلة عامة

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

شاشة فارغة عند الوصول إلى منطقة الإدارة

تحقق مما إذا كانت هناك أخطاء في وحدة التحكم بالمتصفح (يمكنك فتحها في Chrome من الإعدادات > أدوات إضافية > أدوات المطور > وحدة التحكم).
قم بتمكين تصحيح الأخطاء في PHP وتحقق من سجلات أخطاء PHP.
إذا كنت تستخدم الإصدار الخاص بـ ورد بريس قم بتعطيل جميع الإضافات الأمان والإضافات المتعلقة بالاستضافة.

تكوين النطاقات المتعددة

إذا كنت ترغب في استخدام نفس تثبيت الدردشة على عدة نطاقات، يجب أن يسمح خادمك بطلبات cross-origin. لتمكين طلبات cross-origin على خادمك، اتبع الخطوات التالية:

تكوين النطاقات المتعددة عبر الخادم

بالنسبة لخوادم Apache — قم بتحرير ملف .htaccess للنطاق الذي يتم تثبيت المكون فيه وأدخل الكود <IfModule mod_headers.c>Header set Access-Control-Allow-Origin "*"</IfModule> أو <IfModule mod_headers.c="">header('Access-Control-Allow-Origin: *');</IfModule> في الجزء العلوي جدًا من الملف. لجعله يعمل، يجب أن تكون لديك على الأقل AllowOverride +FileInfo أو AllowOverride All في تكوين Apache.
بالنسبة لخوادم nginx — قم بتحرير ملف /etc/nginx/nginx.conf للنطاق الذي يتم تثبيت المكون فيه وأدخل الكود add_header Access-Control-Allow-Origin "*"; في الجزء العلوي جدًا من الملف. إذا كنت تستخدم Plesk، انتقل إلى النطاقات > example.com > إعدادات Apache و nginx الإضافية وأدخل
add_header 'Access-Control-Allow-Origin' '*';.
بالنسبة لخوادم OpenLiteSpeed — زر https://openlitespeed.org/kb/setting-up-cors-on-openlitespeed/.

يمكنك عرض البرامج التعليمية لبرمجيات إدارة الخادم الأكثر شيوعًا في القائمة أدناه:

تكوين النطاقات المتعددة عبر PHP

إذا لم تعمل أيًا من الحلول السابقة أو لا يمكنك تغيير إعدادات الخادم، اتبع الخطوات التالية:

قم بتحرير ملف alz-bot/config.php وأدخل الكود define('SB_CROSS_DOMAIN', true); في نهاية الملف.
قم برفع المجلدات التالية إلى النطاق الخاص بك (النطاق الذي يجب أن يظهر فيه الدردشة، ليس النطاق الذي يتم تثبيت Alz-Bot فيه): alz-bot/media/fonts و alz-bot/media/icons. يمكنك رفع الملفات حيث تشاء، على سبيل المثال، http://www.example.com/chat-files. إذا تم تحميل الدردشة على عدة نطاقات، قم برفع الملفات على كل نطاق.
قم بتعديل الملف alz-bot/config.php مرة أخرى وأدخل الكود define('SB_CROSS_DOMAIN_URL', 'YOUR-URL'); في نهاية الملف. استبدل YOUR-URL بعنوان URL الذي يشير إلى الملفات التي قمت بتحميلها للتو، على سبيل المثال، http://www.example.com/chat-files. إذا تم تحميل الدردشة على عدة نطاقات، استبدل YOUR-URL بمصفوفة من عناوين URL، على سبيل المثال، ["http://www.example.com/chat-files", "http://www.example-2.com/chat-files"].

حجب التكبير على أجهزة iOS

عند استخدام الدردشة على iPhones، يتم تكبير مربع النص تلقائيًا عندما يبدأ المستخدم في كتابة رسالة جديدة. لإيقاف التكبير، أدخل الكود أدناه في منطقة <head> لجميع الصفحات التي تتضمن الدردشة.

    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1.0, user-scalable=no" />

إخفاء admin.php من الرابط

بشكل افتراضي، يكون عنوان URL الخاص بالإدارة مثل https://your-website.com/support/admin.php. يمكنك إخفاء جزء admin.php من الرابط وجعله مثل https://your-website.com/support/ عن طريق إدراج الكود التالي في ملف .htaccess الخاص بك:

        <ifmodule mod_dir.c> DirectoryIndex admin.php</ifmodule>

عدم ظهور واجهة الدردشة

لا يمكنك رؤية واختبار الدردشة كمستخدم إذا كنت مسجل الدخول إلى منطقة الإدارة. لاختبار الدردشة كمستخدم، يرجى تسجيل الخروج من حساب الإدارة الخاص بك. بالإضافة إلى ذلك، يمكنك استخدام نافذة متصفح أخرى في وضع "خاص" أو "متصفح خفي". بالإضافة إلى ذلك، يمكنك إجبار تسجيل الخروج عن طريق تنفيذ وظيفة SBF.reset() في وحدة التحكم في المتصفح.

إعادة تعيين البريد الإلكتروني أو كلمة المرور لحساب الإدارة

إذا لم تتمكن من تسجيل الدخول إلى منطقة الإدارة، يمكنك إعادة تعيين كلمة المرور والبريد الإلكتروني باتباع الخطوات التالية:

قم بتحرير قاعدة بيانات MySQL. يمكنك تحريرها من لوحة الاستضافة الخاصة بك، عادةً مع phpMyAdmin.
قم بتحرير الجدول sb_users.
ابحث عن حساب الإدارة الخاص بك وتأكد من أن قيمة العمود user_type هي admin.
إعادة تعيين كلمة المرور الخاصة بك عن طريق تحرير العمود password وإدخال كلمة مرور جديدة كهاش. لتوليد هاش لكلمة مرورك، قم بزيارة https://phppasswordhash.com /، أو أدخل الهاش $2y$10$i7OComVhUh8BHcyx9VzUfuN.hnNsnKzK1Hd/GKK2KIwBo7Y6stppu (كلمة المرور: 12345678).
إعادة تعيين عنوان البريد الإلكتروني الخاص بك من عمود email.

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

تم حذف حساب الإدارة

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

قم بتحرير قاعدة بيانات MySQL. يمكنك تحريرها من لوحة الاستضافة الخاصة بك، عادةً مع phpMyAdmin.
قم بتحرير الجدول sb_users.
يمكنك تحويل أي مستخدم موجود إلى مدير عن طريق تحرير العمود user_type وإدخال القيمة admin.
يمكنك أيضًا إضافة مستخدم جديد عن طريق تعيين قيمة لحقول الاسم الأول، والاسم الأخير، وكلمة المرور، والبريد الإلكتروني، ونوع المستخدم. قيمة عمود كلمة المرور يجب أن تكون هاش. لتوليد هاش لكلمة مرورك، قم بزيارة https://phppasswordhash.com/. أيضًا، يجب أن تكون قيمة العمود user_type هي admin.

الخادم غير متاح

إذا كان خادمك و/أو موقعك يتوقف فجأة بعد بضع دقائق من استخدام الدردشة، قد يكون السبب متعلقًا بجدار حماية الخادم الخاص بك. يحدث هذا عادةً نتيجة لحظر عنوان IP (Fail2Ban) أو إعدادات جدار الحماية من التطبيقات الويب (ModSecurity). يتم التعرف على الطلبات المتعددة من AJAX من الدردشة إلى قاعدة البيانات كـ "هجوم على الخادم" وبالتالي يضع الخادم حظرًا مؤقتًا على عنوان IP الخاص بك. يجب أن يؤثر هذا الأمر فقط علىك و/أو مطوريك. لا يجب أن يتأثر الزوار/المستخدمون. للتحقق مما إذا كان هذا هو السبب، استخدم خدمة VPN مثل Hotspot Shield. عندما يتوقف الخادم، قم بتنشيط VPN لتغيير عنوان IP الخاص بك وحاول الوصول إلى موقع الويب الخاص بك مرة أخرى. إذا كان الموقع يعمل بشكل طبيعي، يتم تأكيد المشكلة. لحلها مؤقتًا، قم بتعطيل fail2ban أو اتصل بدعم الاستضافة للحصول على دعم إضافي.

تعطيل الدردشة عبر JS

أدخل الكود var SB_DISABLED = true; في صفحة لمنع تحميل الدردشة.

المحادثات

إدارة المحادثات

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

البحث عن المحادثات

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

المعلومات

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

محرر النصوص وميزات الرسائل التلقائية

يمكن استخدام محرر النصوص في منطقة الإدارة والرسائل التلقائية (مثل: رسائل الترحيب والاشتراك) لإنشاء رسائل مُزخرفة:

تنسيق الروابط — يتم تحويل جميع روابط النص تلقائياً إلى روابط فعّالة.
تنسيق النص — يدعم المحرر أيضًا بنية تنسيق النص:
- لجعل النص عريض، قم بتحيطه ب *: *نصك*.
- لجعل النص مائل، قم بتحيطه ب __: __نصك__.
- لجعل النص ~~مشطوب~~، قم بتحيطه ب ~: ~نصك~.
- لإدراج تعليق بسطر واحد، قم بتحيطه ب `: `نصك`.
- لإدراج كتلة رمز، قم بتحيطها ب ```: ```نصك```.
HTML ولغات الشيفرة الأخرى — لأسباب أمان، لا يُسمح بأكواد HTML أو JavaScript (JS) أو لغات الشيفرة الأخرى. ومع ذلك، يمكنك استخدام مقتطفات HTML من خلال استخدام رسائل الغنية المخصصة (المناقشة أدناه).
لإدراج فاصلة في رسالة، استخدم تركيبة لوحة المفاتيح SHIFT + ENTER أو CTRL + ENTER.

حقول الدمج

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

الرمز	الوصف
{user_name}	الاسم الكامل للمستخدم النشط.
{user_email}	بريد المستخدم النشط.
{agent_name}	الاسم الكامل للوكيل النشط.
{agent_email}	بريد الوكيل النشط.

رسائل الغنية

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

كيف يعمل:

إنشاء وإرسال

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

يتم عرض الرسالة

عند استخدام رمز اختصار، يرى المستخدم الرسالة الغنية (وليس الرمز) ويمكنه اختيار أو إدخال المعلومات المطلوبة لإكمال تقديم النموذج.

تم تقديم رد المستخدم

بمجرد ملء نموذج الرسالة الغنية وإرساله من قبل المستخدم، يتم عرض رسالة النجاح ويتم حفظ بيانات النموذج.

رسائل الغنية

الاسم	رمز اختصاري	الوصف
بطاقة	[card image="URL" header="TITLE" description="Lorem ipsum dolor sit amete" link="URL" link-text="Purchase" extra="$399" target="_blank"]	بطاقة نداء للتحرك مع صورة وعنوان ووصف ورابط، والمزيد.
متزلج	[slider image-1="URL" header-1="TITLE" description-1="Lorem ipsum dolor sit amete" link-1="URL" link-text-1="Purchase" extra-1="$599" image-2="URL" header-2="TITLE" description-2="Lorem ipsum dolor sit amete" link-2="URL" link-text-2="Purchase" extra-2="$399" target="_blank"]	متزلج ببطاقات دعوة للتحرك مع صورة وعنوان ووصف ورابط، والمزيد. يمكنك إضافة ما يصل إلى 10 شرائح.
صور المتزلج	[slider-images images="URL,URL,URL"]	متزلج من الصور.
شيبس	[chips options="A,B,C"]	قائمة أزرار.
أزرار	[buttons options="A,B,C"]	قائمة أزرار.
تحديد	[select options="A,B,C"]	قائمة منسدلة للاختيارات.
الإدخالات	[inputs values="A,B,C" button="Send now"]	قائمة إدخالات نصية.
البريد الإلكتروني	[email name="true" last-name="true" phone="true" phone-required="false" placeholder=""]	نموذج لجمع بريد المستخدم الإلكتروني ورقم الهاتف. جميع السمات اختيارية. يتم استخدام إعدادات المتابعة كقيم افتراضية. أضف السمة required-messaging-apps="true" لفرض على المستخدمين تقديم بريدهم الإلكتروني ورقم هاتفهم على تطبيقات المراسلة.
تسجيل	[registration]	نموذج التسجيل.
جدول زمني	[timetable]	جدول زمني.
مقالات	[articles link="https://alz-bot.com/articles-demo"]	مقالات مع منطقة بحث. تُستخدم السمة link كرسالة احتياطية لرسائل Facebook Messenger وWhatsApp وTelegram.
تقييم	[rating label-positive="Helpful" label-negative="Not helpful" label="Rate and review" success-negative=""]	نموذج تقييم الوكيل. لجعل رمز التقييم يعمل على WhatsApp وMessenger وTelegram، يجب عليك استخدام Dialogflow والشات بوت، قم بإنشاء نية جديدة مع تقييم كـ سياق إدخال، لا شيء كـ سياق إخراج، قائمة برسائل المستخدم الأكثر شيوعًا للتقييم الإيجابي كـ عبارات التدريب (مثل: جيد، إيجابي) و { "rating": 1, "force-message": true } كرد تخصيص . للتقييم السلبي، أنشئ نيةً جديدة بنفس السياق ولكن استبدل عبارات التدريب ورد العبارات المخصص بـ { "rating": -1, "force-message": true } . يجب أن يتضمن رمز الاختصار أيضًا عنوانًا أو رسالة.
قائمة	[list values="A,B,C"]	قائمة نصية.
قائمة مزدوجة	[list values="A:X,B:Y,C:Z"]	قائمة نصية مع عناوين.
قائمة صورة	[list-image values="URL:A,URL:B,URL:C"]	قائمة نصية مع عناوين وصور.
جدول	[table header="A,B,C" values="A:B:C,A:B:C,A:B:C"]	جدول.
زر	[button link="https://alz-bot.com" name="Click here" target="_blank" style="link"]	عرض رابط أو فتح مقالة. السمة target="_blank" اختيارية وتفتح الرابط في نافذة جديدة. السمة style="link" اختيارية وتغيير تصميم الزر. لفتح مقالة بنقرة على الرابط يجب أن يكونتقييم الرابط #article-ID، استبدل ID بمعرف المقال.
فيديو	[video type="youtube" id="0TImic4N1ko" height="350"]	عرض فيديو YouTube أو Vimeo. يمكن أن تكون قيمة السمة type youtube أو vimeo. السمة id هي معرف الفيديو، احصل عليه من عنوان URL. السمة height اختيارية وتعيين ارتفاع الفيديو بالبكسل.
صورة	[image url="https://alz-bot.com/media/admin.png"]	صورة.
مشاركة	[share fb="https://alz-bot.com/" tw="https://alz-bot.com/" li="https://alz-bot.com/" pi="https://alz-bot.com/" wa="https://alz-bot.com/"]	أزرار مشاركة اجتماعية.

معلمات عالمية

تدعم جميع رسائل الغنية البارامترات التالية:

المعلمات	الوصف
id="123"	معرف الرسالة الغنية (يُستخدم أيضًا لحفظ بيانات JSON).
title="ABC"	عنوان الرسالة الغنية.
message="ABC"	وصف الرسالة الغنية التي تظهر أسفل العنوان.
success="ABC"	الرسالة التي تظهر عندما يكمل المستخدم ويقوم بإرسال الرسالة الغنية. يتم إلحاق إدخال المستخدم بهذه الرسالة.
settings="ABC"	حقل إضافي لقيم اختيارية إضافية.

رد الرسالة الغنية

عندما يكمل المستخدم رسالة غنية، يتم حفظ بيانات الرد بتنسيق JSON في قاعدة البيانات تحت الجدول sb_messages والعمود payload. مثال:

{"rich-messages":{"4Voyu":{"type":"email","result":{"email":["[email protected]","Your email ..."]}}}}

رسائل الغنية المخصصة

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

أكواد HTML

عند إنشاء رسالة غنية مخصصة، يمكنك استخدام الأكواد التالية:

الرمز	الوصف
<a href="https://www.google.com" target="_blank" class="sb-rich-btn sb-btn">انقر هنا</a>	رابط بتصميم زر.
<a href="https://www.google.com" target="_blank" class="sb-rich-btn sb-btn-text">انقر هنا</a>	رابط.
<div class="sb-image"><img src="https://via.placeholder.com/1500x600" class="sb-image" /></div>	صورة تكبير عند النقر.

الرمز

الوصف

<a href="https://www.google.com" target="_blank" class="sb-rich-btn sb-btn">انقر هنا</a>

رابط بتصميم زر.

<a href="https://www.google.com" target="_blank" class="sb-rich-btn sb-btn-text">انقر هنا</a>

رابط.

<div class="sb-image"><img src="https://via.placeholder.com/1500x600" class="sb-image" /></div>

صورة تكبير عند النقر.

المرفقات

يتم تعيين امتدادات المرفقات الملفات المسموح بها في ملف alz-bot/include/upload.php. يتم عرض تنسيقات الصور التالية تلقائيًا: .jpg، .jpeg، .png.

أضف امتدادات ملفات مسموح بها جديدة عن طريق إضافة الكود define("SB_FILE_EXTENSIONS", ["exe", "abc", ...]) إلى ملف config.php في مجلد تثبيت Alz-Bot الخاص بك. استبدل ["exe", "abc", ...] بمصفوفة تحتوي على الامتدادات التي ترغب في السماح لها.

المستخدمون

إدارة المستخدمين

قم بإدارة المستخدمين من منطقة المستخدمين في القائمة اليسرى لمنطقة الإدارة.

البحث عن المستخدمين

يمكنك البحث عن المستخدمين حسب الاسم، واللقب، والبريد الإلكتروني، والحقول المخصصة.

حذف المستخدمين

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

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

أعمدة جدول المستخدم الإضافية

لعرض أعمدة إضافية في جدول المستخدمين، انتقل إلى Settings > Admin > Users table additional columns وأضف الأعمدة الجديدة. قيمة كل عمود هي الشارة لتفاصيل المستخدم أو تفاصيل المستخدم الإضافية التي ترغب في عرضها. الشارة هي بأحرف صغيرة ومع الفراغات المستبدلة بالحرف -. على سبيل المثال، الشارة لتفاصيل المستخدم الإضافية "تاريخ الميلاد" هي "date-of-birth".

أنواع المستخدمين

النوع	الوصف
user	المستخدم هو أي مستخدم يمتلك بريد إلكتروني.
lead	"الزبون المتوقع" هو أي مستخدم ليس لديه تفاصيل مستخدم، والذي يتم تسجيله تلقائيًا، ولديه محادثة واحدة على الأقل.
visitor	"الزائر" هو أي مستخدم لم يبدأ في محادثة. ملاحظة: يتم حذف الزوار تلقائيًا كل 24 ساعة.

إدارة الوكلاء

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

إذا كنت تستخدم نسخة وورد بريس من Alz-Bot، يتم إنشاء مسؤول عند تنشيط المكون الإضافي بنفس اسم المستخدم وكلمة المرور للمستخدم المسجل الحالي.

المعلومات

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

الإعدادات

ساعات العمل

يمكنك ضبط جدول ساعات العمل من الإعدادات > متفرقات. تُستخدم ساعات العمل لأغراض:

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

مزيد من المعلومات

تُعتبر القيم الفارغة في إعدادات الجدول كساعات عمل خارجية.
ساعات العمل معترف بها في تنسيق توقيت عالمي (UTC). يتم إنشاء توقيت UTC الخاص بك تلقائيًا عند النقر فوق الحقل الإعدادات > متفرقات > تعويض UTC. للحصول يدويًا على تعويض UTC لمنطقتك، انتقل إلى: https://browserspy.dk/ أو wikipedia.org/wiki/List_of_UTC_time_offsets وانسخ التعويض (مثل UTC −12:00، أدخل -12). يتم قبول الأعداد الصحيحة فقط. إذا لم يكن تعويضك صحيحًا (مثل UTC -12:30 أو UTC -12:45)، حاول البحث عن تعويض UTC بديل. إذا كنت لا تستطيع العثور على تعويض صحيح، يجب عليك ضبط الأوقات يدويًا في جدول ساعات العمل لتصحيح الفجوة.
تتناسب تنسيقات التاريخ والوقت في الجدول مع تلك المستخدمة تلقائيًا في بلد لغة متصفح المستخدم.
لا يتم إرسال رسالة العدم الحاضر تلقائيًا إذا كان الإعدادات > روبوت الدردشة (Dialogflow) > استيلاد الإنسان نشطًا. عندما يكون خيار استيلاد الإنسان في Dialogflow نشطًا، يتم إرسال رسالة العدم الحاضر فقط عند استيلاد الإنسان.
لا يتم إرسال رسالة العدم الحاضر إذا كنت تستخدم تطبيق Slack وكنت أو أي وكيل آخر متصل عبر Slack.

مقالات قاعدة المعرفة

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

الاسم	الشيفرة
زر	<a href="https://www.google.com" target="_blank" class="sb-rich-btn sb-btn">انقر هنا</a>
صورة	<img src="https://via.placeholder.com/1500x600" />
صورة مع معرض الصور	<div class="sb-image"><img src="https://via.placeholder.com/1500x600" class="sb-image" /></div>
فيديو	<video controls><source src="video.mp4" type="video/mp4"></video>
YouTube و Vimeo	أدخل شيفرة التضمين المقدمة من YouTube أو Vimeo

عرض المقالات

يمكن عرض المقالات في لوحة الدردشة عن طريق تمكينها من الإعدادات > الدردشة.
يمكن عرض المقالات في صفحة مخصصة عن طريق إدراج الشيفرة <script>var SB_ARTICLES_PAGE = true;</script> في أي صفحة تعرض الدردشة. لتحديد موقع منطقة المقالات، أدخل الشيفرة <div id="sb-articles" class="sb-loading"></div>. إذا كنت تستخدم إصدار ورد بريس يمكنك استخدام الشورتكود [sb-articles].
بديلًا لذلك، يمكن مشاركة المقالات عبر رسالة غنية باستخدام الشورتكود، [articles].

مزيد من المعلومات

قم بترجمة الفئات من الإعدادات > الترجمات عن طريق إضافة اسم الترجمة وترجمتها.
إذا استخدمت الفئات، يتم عرض المقالات فقط التي تم تعيينها إلى فئة.
إذا كان هناك مقالة مترجمة على الأقل بلغة المستخدم، يتم عرض المقالات المترجمة فقط.
تتم مزامنة المقالات تلقائيًا مع قاعدة المعرفة في Dialogflow إذا تم تثبيت تطبيق Dialogflow.
يمكنك إنشاء رابط دردشة داخلي إلى مقال باستخدام رسالة الزر الغنية.
يمكنك إنشاء روابط خارجية للمقالات باستخدام خاصية URL article=ID، قم بتبديل ID بمعرف المقال. مثال: https://alz-bot.com/articles-demo?article=Ucsx6.

اللغة والترجمات

Alz-Bot متعدد اللغات بالكامل ويوفر ميزات قوية لاكتشاف لغة المستخدم على الطاير.

تحرير الترجمات

لتحرير لغتي الدردشة والإدارة، انتقل إلى الإعدادات > الترجمات. بعض الإعدادات، مثل محتويات البريد الإلكتروني، قابلة للترجمة مباشرة وبالتالي لا تحتاج إلى الترجمة هنا.

لغة الدردشة

Alz-Bot مترجمة بالفعل إلى 41 لغة. هناك العديد من الخيارات المتاحة لتعيين اللغة:

الخيار 1: انتقل إلى الإعدادات > الدردشة وحدد ترجم تلقائياً. سيستخدم هذا الخيار تلقائياً لغة الدردشة في متصفح المستخدم.
الخيار 2 - PHP فقط: أضف معلمة عنوان URL lang=LANGUAGE-CODE إلى السكريبت الذي يحمل الدردشة، حيث يتم استبدال "LANGUAGE-CODE" برمز اللغة المكون من حرفين الذي ترغب في عرضه. مثال: https://alz-bot.com/alz-bot/js/main.js?lang=en. انتقل إلى wikipedia.org/wiki/List_of_ISO_639-1_codes للحصول على قائمة كاملة برموز اللغات (انظر العمود 639-1).
الخيار 2 - ورد بريس فقط: انتقل إلى الإعدادات > ورد بريس وقم بتعيين الخيار فرض اللغة.
الخيار 3 - ورد بريس فقط: نسخة ورد بريس من آلزا بوت تستخدم اللغة الافتراضية لتثبيت ورد بريس؛ أو لغة الصفحة أو المقالة الحالية إذا كان الموقع متعدد اللغات. تتوافق هذه الميزة مع WPML وPolylang وغيرها من الإضافات متعددة اللغات. ملاحظة: يتم تعطيل هذه الميزة تلقائيًا إذا كان الخيار الدردشة > ترجمة تلقائية نشطًا.

لغة الإدارة

لترجمة منطقة الإدارة، اتبع الخطوات التالية:

قم بترجمة النصوص بلغتك من الإعدادات > الترجمات.

لتعيين لغة منطقة الإدارة لديك ثلاث خيارات:

قم بتفعيل الخيار الإعدادات > الإدارة > ترجمة منطقة الإدارة تلقائياً. يقوم هذا الخيار بترجمة منطقة الإدارة تلقائيًا لتتناسب مع لغة ملف تعريف الوكيل أو لغة متصفح الوكيل.
قم بتحرير ملف config.php داخل دليل تثبيت آلزا بوت وأدخل الرمز define('SB_ADMIN_LANG', 'LANGUAGE-CODE'); في نهاية محتوى الملف. استبدل LANGUAGE-CODE برمز اللغة الذي ترغب في استخدامه، استخدم حرفين فقط، على سبيل المثال، أدخل es فقط، وليس es_ES.

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

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

إضافة لغة جديدة

لإضافة لغة جديدة، اتبع الخطوات التالية:

عبر FTP أو مدير الملفات، انتقل إلى alz-bot\resources\languages\front.
قم بتكرار (انسخ والصق في نفس الدليل) ملف alz-bot\resources\languages\front\source.json.
أعد تسمية الملف باستخدام رمز اللغة الذي ترغب في إضافته. انتقل إلى wikipedia.org/wiki/List_of_ISO_639-1_codes للحصول على قائمة كاملة برموز اللغات (انظر العمود 639-1).
انتقل إلى الإعدادات > الترجمات ويجب أن تظهر اللغة الجديدة تلقائياً.

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

معلومات

إذا كانت سلسلة الترجمة مفقودة، قم بإضافتها بالنقر على زر إضافة ترجمة جديدة.
إذا لم تعمل سلسلة الترجمة، تأكد من إزالة جميع المسافات البيضاء والأسطر الفارغة في بداية ونهاية السلسلة.
لا تحفظ التعديلات على الترجمات في قاعدة البيانات ولكن مباشرة في ملفات الترجمة. عند تحرير الترجمة وحفظها، يتم إنشاء نسخة احتياطية في مجلد التحميلات. يتم استعادة النسخة الاحتياطية تلقائيًا عند تحديث الإضافة وتفعيلها.
بعض الرموز الخاصة مثل & يتم استبدالها بالشيفرة المكافئة في HTML (انظر https://www.w3schools.com/html/html_entities.asp). على سبيل المثال، & يتم استبدالها بـ &
يمكنك أيضًا إضافة سلاسل ترجمة مفقودة عن طريق الكود. قم بتحرير ملفات اللغة الموجودة في alz-bot\resources\languages. بمجرد تحرير الملف، ستظهر السلاسل الجديدة في الإعدادات > الترجمات.

الأقسام

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

انتقل إلى الإعدادات > متنوعة وأضف الأقسام المطلوبة. بعد الحفظ، أعد تحميل الصفحة.
انتقل إلى المستخدمين > وكلاء وقم بتحرير وكيل، سترى حقلًا جديدًا حيث يمكنك تعيين قسم الوكيل.
أعد تحميل الصفحة وانتهيت! في منطقة المحادثات، سترى الآن خيارًا لتعيين القسم.

الإعدادات

عرض في لوحة المعلومات يعرض قائمة الأقسام في لوحة المحادثة ويجبر المستخدمين على اختيار قسم قبل بدء المحادثة.
عرض الصور يعرض صورة القسم بدلاً من لون القسم.
التسمية استبدل التسمية الأقسام (الجمع) بنص آخر. يتم عرض الاسم في منطقة الإدارة ومنطقة التذاكر.
التسمية الفردية استبدل التسمية القسم (المفرد) بنص آخر. يتم عرض الاسم في منطقة الإدارة ومنطقة التذاكر.
عنوان لوحة المعلومات قم بتعيين عنوان قائمة المحادثة. الافتراضي: الأقسام.

كيف يعمل ذلك

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

كيفية تعيين قسم

يمكنك تعيين قسم للمحادثة بعدة طرق:

عبر الإعدادات > متنوعة > إعدادات الأقسام > عرض في لوحة المعلومات. يجبر هذا الإعداد المستخدم على اختيار قسم عند بدء محادثة جديدة.
عبر الإعدادات > الأتمتة > المزيد.
عبر متغير جافا سكريبت var SB_DEFAULT_DEPARTMENT = ID;. أدخل الكود في الصفحات التي يتم عرض الدردشة فيها واستبدل ID بمعرف القسم. لمزيد من التفاصيل، راجع واجهة البرمجة هنا.
عبر واجهة البرمجة.

الطابور

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

مزيد من المعلومات

يتم احتساب الوكلاء عبر الإنترنت فقط كـ "وكلاء متاحين"؛ فقط الوكلاء عبر الإنترنت سيتلقون محادثات جديدة.
المشرفون غير مدرجين؛ المشرفون يرون دائماً جميع المحادثات.
يجب على الوكلاء أرشفة المحادثة لتعليمها كمكتملة؛ وهذا سيمنحهم تلقائيًا وصولًا إلى المحادثة التالية في الطابور.
يمكن للوكلاء تغيير حالتهم بين الاتصال وعدم الاتصال عن طريق تحريك مؤشر الماوس فوق صورتهم الشخصية ثم النقر على تسمية الفقاعة في أسفل يسار منطقة الإدارة.
يمكن للوكلاء رؤية محادثاتهم فقط؛ ومع ذلك، يمكنهم رؤية جميع محادثات مستخدم واحد.
يمكن للوكلاء البحث وتصفية محادثاتهم فقط.
يتم عرض وقت الانتظار بالدقائق ويتم حسابه كالتالي: موقف الطابور X وقت الرد = وقت الانتظار. على سبيل المثال، إذا كان المستخدم في المرتبة 5 في الطابور، وتم تعيين وقت الرد إلى 4 دقائق (عبر الإعدادات > متنوعة > الطابور)، سيكون الوقت الإجمالي المعروض للمستخدم 20 دقيقة.
إذا كان المستخدم في الطابور وغادر (على سبيل المثال، عند إغلاق المستعرض) لأكثر من دقيقة واحدة، يتم حفظ المحادثة؛ ومع ذلك، بمجرد عودة المستخدم، يتم إعادة تعيين الطابور وسيفقد المستخدم موقعه السابق.
الطابور متوافق مع الأقسام.
إذا كانت استلام البشر من ديالوجفلو نشطة، يتم تنشيط الطابور فقط عند الاستيلاء البشري.
بالنسبة للمحادثات التي تبدأ من تطبيقات المراسلة مثل WhatsApp، لا يمكن احترام الحد الأقصى للمحادثات لكل وكيل، سيتم تعيين جميع المحادثات فورًا وبنسبة متناسبة لوكيل.
استخدم الإعدادات > الرسائل > الرسالة في وضع عدم الاتصال لمنع ظهور رسالة تحديث الطابور في الدردشة للمستخدم.
عند تفعيل خيار الصوت، يتم تشغيل صوت عندما يحين دور المستخدم.

كيفية اختبار الطابور

لتحاكي عدة مستخدمين ووكلاء، افتح الدردشة في متصفحات متعددة مختلفة (مثل Opera، Firefox، Brave، Chrome، إلخ). يمكن لكل متصفح تحاكي مستخدمين/وكلاء اثنين: واحد في الوضع العادي وواحد في الوضع "الخاص" أو "التصفح الخفي".
لإعادة تعيين الدردشة وبدء جلسة مستخدم جديدة، افتح وحدة التحكم في المتصفح، أدخل SBF.reset()، واضغط على ENTER.

توجيه المحادثات

عند تفعيل توجيه المحادثات عبر الإعدادات > متفرقات > توجيه المحادثات، يقوم Alz-Bot بتعيين محادثات المستخدمين تلقائيًا لجميع وكلاء المتاحين بنسبة متناسبة.

معلومات

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

التوجيه اليدوي

عند تفعيل التوجيه عبر الإعدادات > متفرقات > إخفاء محادثات الوكلاء الآخرين، يرى الوكلاء فقط محادثاتهم الخاصة ويمكنهم اختيار تلك التي لم يتم تعيينها.

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

إرسال البريد الإلكتروني

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

التفعيل

لتفعيل إرسال البريد الإلكتروني، انتقل إلى الإعدادات > الإشعارات > إرسال البريد الإلكتروني وأدخل معلومات خادم البريد الإلكتروني الخاص بك، ثم قم بتعيين عنوان البريد الإلكتروني لاستخدامه في إرسال البريد الإلكتروني في الإعدادات > الإشعارات > SMTP وانتهى! يجب أن يكون عنوان البريد الإلكتروني هو الذي يتصل به خادم إرسال البريد الإلكتروني. سيقوم Alz-Bot بإرسال جميع الرسائل البريدية من هذا العنوان البريدي وستتمكن من الرد عليها أنت ووكلاؤك ومستخدميك.

معلومات

يجب تمكين إعداد الإشعارات > إشعارات البريد الإلكتروني للمستخدم لإرسال الردود إلى بريد المستخدم.
إذا كنت تستخدم تطبيق Dialogflow وكانت إعدادات الإعدادات > Dialogflow > استيلاء البشر نشطة، لا يتم إرسال أي رسائل بريد إلكتروني إذا كان الدردشة الآلية تعرف الإجابة.
إذا كانت إعدادات تحويل جميع الرسائل البريدية نشطة، سيتم تحويل جميع رسائل البريد الواردة إلى صندوق الدردشة، انتبه إلى أن جميع رسائل البريد، بما في ذلك الرسائل العشوائية والرسائل الترويجية وغيرها، قد يتم تحويلها بشكل خاطئ.
إذا كانت إعدادات تحويل جميع الرسائل البريدية نشطة، سيتم تجاهل الرسائل البريدية المرسلة من عناوين بريد الوكلاء والمسؤولين، استخدم عنوان بريد آخر للفحص.
إذا كانت إعدادات تحويل جميع الرسائل البريدية نشطة، ستؤدي كل رسالة بريدية مرسلة مباشرة إلى عنوان البريد الإلكتروني لتحرير محادثة مستخدم جديدة.
لا يمكنك استخدام نفس عنوان البريد الإلكتروني الذي تم استخدامه للإجابة عبر أنابيب البريد الإلكتروني. يجب على جميع وكلاء ومشرفي Alz-Bot استخدام عنوان بريد إلكتروني مختلف.
يجب على الوكلاء الرد عبر البريد الإلكتروني من نفس عنوان البريد الإلكتروني المسجل في Alz-Bot.
عندما يرد الوكلاء في Alz-Bot، يتم إرسال رسائل البريد الإلكتروني دائمًا إلى المستخدم، حتى إذا تم تعطيل إشعارات البريد الإلكتروني للمستخدم.
يتم إرسال البريد الإلكتروني إلى الوكلاء فقط إذا كانوا غير متصلين. إذا كانوا متصلين، لا يتم إرسال أي رسائل بريد إلكتروني.
بالنسبة لبريد Gmail وبريد Google Workspace، يجب عليك استبدال كلمة مرور Google الخاصة بك بكلمة مرور تطبيق Google، التفاصيل على https://support.google.com/accounts/answer/185833 (قسم إنشاء واستخدام كلمات المرور للتطبيقات). أدخل imap.gmail.com كمضيف و 993 كمنفذ.
يتطلب أنابيب البريد الإلكتروني وحدة php5-imap (وحدة IMAP). إذا لم يتم تثبيتها على خادمك، يمكنك تثبيتها باستخدام الأمر apt-get install php5-imap. إذا كانت لديك مشكلات، اتصل بدعم الاستضافة/الخادم الخاص بك.
تضيف خيار Delimiter نصًا في أعلى جميع رسائل البريد الإلكتروني:
### يرجى كتابة ردك أعلاه على هذا الخط ###
. يُخبر هذا النص Alz-Bot بحذف جميع المحتوى أدناه، وهو مفيد لقص جميع اقتباسات الرد. قم بتفعيله إذا رأيت رسائل مكررة في الدردشة. إذا كان هذا الخيار نشطًا، فلا يمكنك ولا يمكن للمستخدمين استخدام سلسلة ### في الرسائل البريدية.
يتم دعم مرفقات البريد الإلكتروني.
من أجل أن تعمل أنابيب البريد الإلكتروني، يجب أن تحتوي ردود البريد الإلكتروني على اسم مستلم Alz-Bot. على سبيل المثال، Alz-Bot | SB2457-4734 <[email protected]>. جميع العملاء الرئيسيين للبريد الإلكتروني مثل Outlook Web، Outlook، Gmail، Yahoo Mail يدعمون اسم المستلم تلقائيًا عبر أزرار رد الدردشة أو رد الجميع.
بسبب طبيعة كيفية عمل البريد الإلكتروني، يستخدم كل عميل بريد إلكتروني رموزه وفواصله وسلاسله الآلية الخاصة، وأكثر. لهذا السبب، قد تحتوي بعض رسائل الدردشة المحولة من البريد الإلكتروني على نصوص غير صالحة. نعمل على تحسين أكبر عدد ممكن من عملاء البريد الإلكتروني، وفي الوقت الحالي، يتم تحسين العملاء التالية ويجب أن لا تعود بأي نص غير صالح: Outlook Web، Outlook، Gmail، Yahoo Mail.
تدعم أنابيب البريد الإلكتروني الأقسام، إذا كانت محادثة المستخدم مخصصة إلى قسم، يتم إرسال إشعارات البريد الإلكتروني فقط إلى الوكلاء المخصصين لذلك القسم.

وظيفة Cron

يحاول Alz-Bot معالجة رسائل البريد الإلكتروني عبر مهام cron كل 60 ثانية، التفاصيل هنا.
يمكنك تشغيل التنفيذ يدويًا وتسريع مهام cron عبر واجهة برمجة التطبيقات (API) باستخدام الدالة الـ PHP sb_email_piping()، أو وظيفة واجهة برمجة التطبيقات عبر الويب email-piping.
يمكنك إنشاء مهمة cron تشغيل عنوان URL [ALZ-BOT-INSTALLATION-URL]/include/api.php?piping=true *. استخدم الأمر */59 * * * * wget [ALZ-BOT-INSTALLATION-URL]/include/api.php?piping=true لتشغيله عبر أمر. قم بتبديل [ALZ-BOT-INSTALLATION-URL] بعنوان URL الخاص بـ Alz-Bot *.
يمكنك أيضًا استخدام هذا الملف cron job: تنزيل. أمر مهمة cron هو php -f YOUR-FILE-PATH/cron.php.
إذا قمت بتشغيل مهمة cron يدويًا، تحقق من الإعداد تعطيل مهمة cron لمنع Alz-Bot من تشغيلها يدويًا وتحسين الأداء.
* إذا كنت تستخدم الإصدار السحابي، يكون العنوان URL هو https://alz-bot.techn-oviz.com/script/include/api.php?piping=true&cloud=API-TOKEN، قم بتبديل API-TOKEN برمز API الخاص بك (https://alz-bot.techn-oviz.com/account/?tab=installation)

Pusher

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

التنشيط

انتقل إلى https://dashboard.pusher.com/accounts/sign_up وأنشئ حسابًا جديدًا.
من لوحة التحكم الخاصة بك على https://dashboard.pusher.com، اختر منتج Channels بالنقر فوق ابدأ.
أدخل اسم تطبيقك واختر أقرب مجموعة إلى موقعك.
من قائمة اليسار في لوحة التحكم، انقر على إعدادات التطبيق وقم بتمكين أحداث العميل.
من قائمة اليسار في لوحة التحكم، انقر على Keys، انسخ App ID، Key، Secret، Cluster.
اذهب إلى الإعدادات > متفرقات > Pusher والصق معرّف التطبيق، المفتاح، السرّ، والمجموعة.
انتهيت.

معلومات

يمكن استخدام Pusher مجانًا لما يصل إلى 200 ألف رسالة و100 اتصال متزامن في اليوم. تُستخدم الرسائل للوظائف التالية وغيرها: تسجيل المستخدم، حالة المستخدم عبر الإنترنت، رسائل الدردشة، ورسائل الروبوت الدردشة. يُشرح حساب قنوات Pusher هنا.
عندما يكون Pusher نشطًا، يتم استبدال الطلبات AJAX التالية بواسطة WebSockets: التحقق من وجود رسائل جديدة، التحقق من وجود محادثات جديدة، حالة الاتصال عبر الإنترنت/غير عبر الإنترنت، حالة الكتابة، قائمة المستخدمين عبر الإنترنت.
عندما يكون Pusher نشطًا، يتم تحديث قيمة آخر نشاط للمستخدمين والوكلاء فقط عند تحميل الصفحة أو عند إرسالهم لرسائل جديدة.
عندما يكون Pusher نشطًا، يتم تفعيل الخيار الإعدادات > المستخدمين > تسجيل جميع الزوار تلقائيًا ولا يمكن تعطيله.

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

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

عامة

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

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

تُرسل رسالة الدردشة إلى المحادثة النشطة، إذا كانت موجودة، وإلا إلى محادثة جديدة.
إذا كان الخيار الإعدادات > إشعارات البريد الإلكتروني للمستخدمين نشطًا، يتم إعلام جميع المستخدمين الذين لديهم عنوان بريد إلكتروني عبر البريد الإلكتروني.
إذا كان الخيار الإعدادات > إشعارات الرسائل النصية > نشط للمستخدمين نشطًا، يتم إعلام جميع المستخدمين الذين لديهم رقم هاتف عبر رسالة نصية.
إذا كان الخيار الإعدادات > إشعارات الدفع نشطًا، يتم إرسال إشعار دفع إلى جميع المستخدمين.
يتم إرسال الرسالة أيضًا إلى تطبيقات الرسائل مثل WhatsApp وMessenger إذا كان المستخدم متصلاً بها.
لإرسال رسالة إلى جميع مستخدمي تطبيق واحد للرسائل، أدخل أحد السلاسل التالية: whatsapp, messenger, instagram, telegram, twitter, google, wechat. أدخل tickets لإرسال رسالة فقط إلى المستخدمين الذين قاموا بإنشاء تذكرة Alz-Bot عبر تطبيق Tickets.

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

تُضمن رأس البريد الإلكتروني وتوقيع البريد الإلكتروني تلقائيًا في جميع الرسائل البريدية، قم بتعيينهما من الإعدادات > الإشعارات.
يتم دعم لغة HTML.
يدعم الموضوع حقول الدمج.

الرسائل النصية المباشرة

لتمكين الرسائل النصية المباشرة، يجب تمكين رسائل الرسائل النصية في الإعدادات > الإشعارات > إشعارات الرسائل النصية.

التلقائيات

تتيح التلقائيات تشغيل مهام تلقائية متعددة اللغات عندما تتحقق الشروط التي حددتها.

لحذف شرط، قم بتعيينه إلى قيمة فارغة. لتعطيل تلقائية، احذف جميع الشروط.
يتم إرسال التلقائيات مرة واحدة فقط إلى المستخدمين.
إذا استخدمت تلقائية في الماضي، وتلقى المستخدمون بالفعل، فيجب حذف التلقائية وإنشاء واحدة جديدة لعرضها للمستخدمين.
التكرار يعمل فقط إذا تم استخدامه بالتزامن مع التاريخ والوقت.
عند استخدام التاريخ والوقت بالتزامن مع معيار بالضبط، يجب ألا تحتوي القيمة على ساعات ودقائق (hh:mm). على سبيل المثال، 25/10/2021 (25/10/2021 10:30 لن يعمل).
يجب تفعيل الإعداد Settings > Users > Register all visitors إذا كانت هناك أتمتة في الرسائل تُنفذ عند تحميل الصفحة.
المدينة، الدول، اللغات تعمل تلقائيًا فقط إذا تم تمكين كل من الإعدادات Settings > Users > Register all visitors و Settings > Users > Full visitor details.
المدن تعمل فقط إذا تم تعيين تفاصيل المستخدم الموقع وتكون متساوية لـ المدينة، الدولة، أو إذا تم تعيين تفاصيل المستخدم المدينة.
الدول تعمل فقط إذا تم تعيين تفاصيل المستخدم country_code أو country، أو إذا تم تعيين تفاصيل المستخدم الموقع وتكون متساوية لـ المدينة، الدولة. يجب أن يكون اسم الدولة باللغة الإنجليزية.
اللغات تعمل فقط إذا تم تعيين تفاصيل المستخدم browser_language أو language.
يُعتبر الزائر زائرًا عائدًا فقط إذا قام بزيارة الموقع مرة أخرى بعد مرور 24 ساعة أو أكثر.
تظهر النوافذ المنبثقة فقط إذا تم إغلاق الدردشة، وتستبدل النوافذ المنبثقة الافتراضية. يمكنك التحقق من خيار message fallback لإرسال رسالة بدلاً من عرض النافذة المنبثقة إذا كانت الدردشة مفتوحة.
قد تحتاج إلى تمكين Settings > Users > Register all visitors إذا كنت ترغب في إرسال رسالة تلقائية إلى المستخدمين الجدد.
تُرسل رسائل الدردشة ورسائل الاحتياطية للنوافذ المنبثقة فقط إذا كانت آخر رسالة من المستخدم أو الوكيل في المحادثة أقدم من 10 دقائق. تمنع هذه الميزة إرسال رسائل آلية غير مرغوب فيها خلال محادثة بين الوكيل والمستخدم.
فحص شرط المتغير المخصص للتحقق من المتغيرات الجافا سكريبت بالأسماء والقيم المعطاة. على سبيل المثال، يتم تلبية الشرط example=ABC إذا كان هناك هذا الكود الجافا سكريبت في صفحة الدردشة: var example = "ABC";. أضف متغيرات متعددة مفصولة بفواصل.

اتبع الخطوات أدناه لإكمال التزامن مع خدمة النشرة الإخبارية الخاصة بك. يتم الاشتراك في المستخدم في الحالات التالية: نموذج التسجيل، تحديث المستخدم، رسالة المتابعة، رسالة الاشتراك، shortcode البريد الإلكتروني.

Mailchimp

للحصول على Key، اتبع الوثائق على https://mailchimp.com/help/about-api-keys/.
للحصول على List ID، اتبع الوثائق على https://mailchimp.com/help/find-audience-id/.

Sendinblue

للحصول على Key، اتبع الوثائق على https://account.sendinblue.com/advanced/api.
للحصول على List ID، اتبع الوثائق على https://my.sendinblue.com/lists.

SendGrid

للحصول على Key، اتبع التوجيهات في الوثائق على https://app.sendgrid.com/settings/api_keys.
للحصول على List ID، ادخل إلى SendGrid وانقر على Marketing > Contacts (https://mc.sendgrid.com/contacts)، ثم انقر على قائمة أو أنشئ قائمة جديدة. الجزء الأخير من عنوان URL هو معرف القائمة. على سبيل المثال، https://mc.sendgrid.com/contacts/lists/8558c1e7-3c99-4428-a68f-78df2e437f8e (معرف القائمة هو 8558c1e7-3c99-4428-a68f-78df2e437f8e).

Elastic Email

للحصول على Key، ادخل إلى Elastic Email، ثم انقر على Settings من قائمة الملف الشخصي في أعلى اليمين. انقر على Create Additional API key (https://elasticemail.com/account#/settings/new/create-api)، قم بتعيين اسمًا واختر Plugin أو Full access، أو Custom وتأكد من أن إذن Contacts مُعين إلى View & Modify.
List ID هو اسم القائمة. مهم! يجب ألا يحتوي أسماء القوائم أو القطاعات الحالية على أي مسافات فيها.

Campaign Monitor

للحصول على Key، ادخل إلى Campaign Monitor، ثم انقر على Account settings من قائمة الملف الشخصي في أعلى اليمين. انقر على API keys > Generate API key.
للحصول على List ID، ادخل إلى Campaign Monitor، ثم انقر على List and subscribers من القائمة العلوية. حدد قائمة ثم انقر على Settings من القائمة اليسرى وانسخ List API ID.

HubSpot

للحصول على Key، ادخل إلى HubSpot، ثم احصل عليه من Settings > Integrations > API key.
للحصول على List ID، ادخل إلى HubSpot، ثم احصل عليه من Contacts > List > List details.

Moosend

للحصول على Key، ادخل إلى Moosend، ثم انقر على Settings > API key .
للحصول على List ID، ادخل إلى Moosend، ثم احصل عليه من Audience > Email lists.

GetResponse

للحصول على List ID، ادخل إلى GetResponse، ثم احصل عليه من Lists > Your list > Settings (https://app.getresponse.com/lists). انسخ قيمة List token.
للحصول على Key، قم بزيارة https://app.getresponse.com/api.

ConvertKit

للحصول على Key، ادخل إلى ConvertKit، ثم احصل عليه من Settings > Advanced > API secret .
للحصول على List ID، ادخل إلى ConvertKit، ثم احصل عليه من Grow > Landing Pages & Forms. افتح النموذج الخاص بك وانسخ الجزء الرقمي من عنوان URL. على سبيل المثال، ID للنموذج بعنوان URL https://app.convertkit.com/forms/designers/3003412/edit هو 3003412.

ActiveCampaign

للحصول على Key، ادخل إلى ActiveCampaign، ثم احصل عليه من Account settings > Developer.
للحصول على List ID، ادخل إلى ActiveCampaign، ثم احصل عليه من Left menu > Lists أو Left menu > Contacts > Lists. افتح القائمة الخاصة بك وانسخ معرف القائمة في عنوان URL. على سبيل المثال، ID للقائمة بعنوان URL https://activehosted.com/app/contacts/?listid=1&status=1 هو 1. يجب أن يكون معرف القائمة بهذا الشكل: domain:list-ID. الـ domain هو الجزء الأول من عنوان URL لوحة القيادة الخاصة بك. على سبيل المثال، الـ domain لـ https://activehosted.com/ هو والقيمة النهائية لإدراجها في Alz-Bot هي :1.

MailerLite

للحصول على Key، ادخل إلى MailerLite، ثم احصل عليه من Left menu > Integrations > MailerLite API.
للحصول على List ID، ادخل إلى MailerLite، ثم احصل عليه من Left menu > Subscribers > Groups. عرض مجموعة وانسخ معرف المجموعة من العنوان URL (على سبيل المثال، ....group=18783408688903967...).

Mailjet

للحصول على Key، قم بزيارة https://app.mailjet.com/account/apikeys، أو ادخل إلى Mailjet، ثم احصل عليه من Account settings > Account settings.
للحصول على List ID، ادخل إلى MailerLite، ثم احصل عليه من Contacts > Contacts lists > Your list. احصل على معرف القائمة عن طريق النقر على رمز ? بجوار عناوين البريد الإلكتروني للقوائم. على سبيل المثال، 1202546.

Grammarly

اتبع الخطوات أدناه لبدء استخدام Grammarly.

قم بتسجيل حساب مطور على https://developer.grammarly.com/.
أنشئ تطبيقًا جديدًا، انتقل إلى منطقة Credentials وانسخ Client ID. في Origins، يجب أيضًا إضافة النطاق الذي تم تثبيت Alz-Bot فيه.
الصق Client ID في Settings > Admin > Grammarly > Client ID.
تأكد من إيقاف تشغيل إضافة Grammarly في متصفحك.

Amazon Web Services

Amazon S3

قم بتحميل المرفقات إلى حاوية Amazon S3 الخاصة بك بدلاً من الخادم الذي تم تثبيت Alz-Bot عليه. اتبع الخطوات أدناه لإعدادها.

قم بتسجيل الدخول إلى AWS كمستخدم رئيسي من https://aws.amazon.com/.
ادخل لوحة تحكم IAM وانقر على Left menu > Access management > Users.
انقر على إضافة مستخدم جديد، أدخل اسم المستخدم واستمر.
اختر إضافة مستخدم إلى مجموعة وعلى مجموعات المستخدمين في الأسفل انقر على إنشاء مجموعة. في سياسات الصلاحيات، ابحث عن AmazonS3FullAccess وحددها. انقر على إنشاء مجموعة مستخدم.
قم بتعيين المجموعة الجديدة للمستخدم الذي تقوم بإنشائه واستمر، ثم انقر على إنشاء مستخدم.
حدد المستخدم الذي تم إنشاءه حديثًا وافتح علامة التبويب بيانات الأمان.
في منطقة مفاتيح الوصول، انقر على إنشاء مفتاح وصول وحدد تطبيق يعمل خارج خدمات الويب أمازون. استمر حتى تحصل على المفاتيح واحفظها في Alz-Bot > الإعدادات > متنوع > أمازون S3.
قم بزيارة لوحة تحكم أمازون S3 وانقر على إنشاء دلو.
حدد اسم الدلو والمنطقة التي تريدها. احفظ المنطقة والاسم في Alz-Bot > الإعدادات > متنوع > أمازون S3. قم بالتحقق من تمكين ACLs و تفضيل صاحب الدلو. قم بإلغاء تحديد منع جميع الوصول العام وجميع الخانات ذات الصلة.
انقر على إنشاء دلو.
هذه الميزة هي تقنية واختيارية. لا يغطي الدعم أي مساعدة متعلقة بهذه الميزة.

الإشعارات

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

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

يمكن للوكلاء والمستخدمين تلقي إشعار عبر البريد الإلكتروني عند استلام رسالة جديدة.

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

عندما يرسل المستخدم رسالته الأولى، إذا تم تعيين المحادثة إلى قسم، يتم إرسال بريد إلكتروني فقط إلى الوكلاء المعينين في ذلك القسم، إذا تم تعيين المحادثة إلى وكيل محدد، يتم إرسال بريد إلكتروني فقط إلى ذلك الوكيل، وإلا يتم إرسال بريد إلكتروني إلى جميع الوكلاء الذين ليسوا متصلين في تلك اللحظة. يتم إرسال البريد الإلكتروني في الرسائل التالية فقط إلى آخر وكيل في المحادثة.
يتم إرسال إشعارات البريد الإلكتروني فقط إذا كان آخر وكيل في المحادثة غير متصل.
إذا كنت تستخدم تطبيق Dialogflow، وكان الإعدادات > Dialogflow > الاستيلاء البشري نشطًا، فإنه لا يتم إرسال أي رسائل بريد إلكتروني إذا كان الشاتبوت يعرف الإجابة.
إذا لم تتلقى البريد الإلكتروني، تأكد من أنه يعمل عن طريق إرسال بريد إلكتروني تجريبي من الإعدادات > الإشعارات > اختبار بريد المستخدم أو اختبار بريد الوكيل. إذا لم تتلق البريد الاختباري، فإن خادمك أو خادم SMTP الخاص بك لا يعمل. افتح وحدة التحكم في المتصفح للحصول على مزيد من التفاصيل حول الخطأ. لأن هذا ليس مشكلة متعلقة بـ Alz-Bot، لا يغطي الدعم هذا الأمر، يرجى الاتصال بدعم الخادم/الاستضافة/SMTP الخاص بك بدلاً من ذلك.

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

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

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

لإدارة البريد الإلكتروني وإنشاء المحتويات، انتقل إلى الإعدادات > الإشعارات. يمكنك استخدام النصوص وHTML. يتم تحويل الأسطر الجديدة تلقائيًا إلى <br />. يمكنك استخدام حقول الدمج التالية في البريد الإلكتروني. تُستبدل حقول الدمج تلقائيًا بالمعلومات المحدثة.

الرمز	الوصف
{recipient_name}	اسم المستخدم أو الوكيل الذي يتلقى البريد الإلكتروني.
{sender_name}	اسم المستخدم أو الوكيل الذي كان يرسل الرسالة التي أثارت إشعار البريد الإلكتروني.
{sender_profile_image}	صورة الملف الشخصي للمستخدم أو الوكيل الذي كان يرسل الرسالة التي أثارت إشعار البريد الإلكتروني.
{message}	الروابط إلى أي مرفقات كانت جزءًا من الرسالة التي أثارت إشعار البريد الإلكتروني.
{attachments}	قد لا تتم تسليم البريد الإلكتروني لعدة أسباب؛ أدناه هي الأكثر شيوعًا:

هل هناك مشاكل؟

قد لا يتم تسليم البريد الإلكتروني لعدة أسباب؛ أدناه هي الأكثر شيوعًا:

السبب	الوصف	الحل
مشاكل الاستضافة	خادم البريد الإلكتروني لمزود خدمة استضافة موقع الويب الخاص بك غير قادر على إرسال رسائل البريد الإلكتروني أو يتم إرسال الرسائل ولكن يتم اعترافها تلقائيًا كرسائل غير مرغوبة وحذفها بواسطة عملاء البريد الإلكتروني.	يرجى الاتصال بمزود خدمة استضافة موقع الويب الخاص بك بشأن دعم البريد الإلكتروني أو استخدام خادم SMTP الخاص بك عن طريق تنشيطه في الإعدادات > الإشعارات > SMTP.
مشاكل SMTP	البريد الإلكتروني لا يتم إرساله أيضًا إذا كنت قد قمت بتنشيط خيار SMTP في الإشعارات.	لا نقدم دعمًا للمشكلات المتعلقة بـ SMTP الخاص بك. قم بإرسال رسالة اختبار للحصول على تفاصيل حول المشكلة أو استخدم sendgrid.com ، يمكنك إرسال 40000 رسالة لمدة 30 يومًا مجانًا، ثم 100/يوم إلى الأبد مجانًا. ملحوظة: إذا كنت تستخدم Gmail، أدخل smtp.gmail.com كمضيف وقم بتعيين 465 أو 587 كمنفذ. يجب أيضًا السماح بالوصول إلى Gmail لتطبيقات أقل أمانًا، يمكنك القيام بذلك من خلال https://myaccount.google.com/lesssecureapps.

إشعارات الدفع

إشعارات الدفع مثل إشعارات سطح المكتب ولكن مع بعض الفروق الرئيسية. إشعارات سطح المكتب، المعروفة أيضًا باسم إشعارات الويب، يتم طلبها مباشرة من العميل بينما تأتي إشعارات الدفع من الخادم. الفرق الرئيسي هو أن إشعارات الدفع تعمل دائمًا، حتى إذا كان جهازك غير متصل بالإنترنت، أو Alz-Bot غير مفتوح. أيضًا، فهي دائمة ومرئية دائمًا حتى يتم إغلاقها. إشعارات الدفع تتطلب خدمة خارجية للعمل. نحن نستخدم Pusher، وهو مجاني للاستخدام لإشعارات الإدارة المرسلة إلى الوكلاء، وهو مجاني للاستخدام لما يصل إلى 2000 مستخدم/جهاز عند إرسال الإشعارات إلى المستخدمين. للأسف، لم تقدم Apple دعم iOS حتى الآن، ولكن نأمل أن يأتي قريبًا.

التفعيل

انتقل إلى https://dashboard.pusher.com/accounts/sign_up وأنشئ حسابًا جديدًا.
من لوحة التحكم الخاصة بك على https://dashboard.pusher.com ، اختر منتج Beams بالنقر فوق ابدأ.
أدخل اسم الحالة وأنشئ الحالة. يمكنك إدخال أي قيمة تريدها.
من القائمة اليسرى للوحة التحكم، انقر فوق Keys ، انسخ معرف الحالة و المفتاح الأساسي.
انتقل إلى منطقة الإدارة في Alz-Bot ، اذهب إلى الإعدادات > الإشعارات > إشعارات الدفع، والصق معرف الحالة والمفتاح الرئيسي.
انتهيت.

التفعيل للمستخدمين

قم بتنزيل ملف خدمة العامل هنا.
قم بتحميل هذا الملف إلى موقعك في الموقع التالي: https://your-site.com/service-worker.js
انتقل إلى الإعدادات > الإشعارات > إشعارات الدفع > عنوان ملف الخدمة وأدخل عنوان URL للملف. على سبيل المثال، https://your-site.com/service-worker.js. إذا كنت تستخدم الإصدار السحابي، أدخل https://alz-bot.techn-oviz.com/sw.js. إذا كنت تستخدم الإصدار SaaS، قم بتبديل alz-bot.techn-oviz.com بنطاقك.
انتهيت.

المعلومات

يمكن استخدام Pusher مجانًا لما يصل إلى 1000 مشترك في وقت واحد. على الرغم من أنه يجب أن يكون بإمكانك استخدام الخطة المجانية لمنطقة الإدارة وجميع الوكلاء، قد تحتاج إلى خطة مدفوعة لإشعارات الدفع المرسلة إلى المستخدمين اعتمادًا على حركة المرور في موقعك.
إشعارات الدفع غير معتمدة حاليًا على أجهزة iPhone وأجهزة iOS. إشعارات الدفع معتمدة فقط على أجهزة Mac وWindows وAndroid.
تعمل إشعارات الدفع فقط لمواقع الويب الآمنة بشكل كامل تستخدم HTTPS. الاستثناء الوحيد هو localhost لتسهيل عملية التطوير.
عندما ينقر المستخدم على الإشعار، يتم فتح آخر صفحة قام المستخدم بزيارتها ويتم فتح المحادثة تلقائيًا.
على سطح المكتب، يجب أن يكون المستعرض قيد التشغيل لأنه هذه هي العملية التي تستقبل رسائل الدفع.
عندما تكون إشعارات الدفع نشطة، تحل محل إشعارات سطح المكتب.
في Android والأجهزة المحمولة، قد لا تعمل إشعارات سطح المكتب، وفي هذه الحالة، يجب عليك استخدام إشعارات الدفع.
إذا كانت إشعارات الدفع نشطة وغير متوفرة، قم بتعطيلها وحاول مرة أخرى.
لا يمكن استلام إشعارات الدفع على جهاز كمبيوتر شخصي بشكل دقيق ما لم يكن هناك متصفح قيد التشغيل.

إشعارات الدفع للمسؤول والوكلاء

عندما ينقر الوكيل على الإشعار، يتم فتح منطقة الإدارة ويتم تحديد المحادثة الصحيحة. إذا كانت منطقة الإدارة قيد التشغيل بالفعل، لن يتم فتح تبويب جديدة.
عندما يرسل المستخدم رسالته الأولى، يتم إرسال إشعار دفع إلى جميع الوكلاء المحققين؛ يتم إرسال الإشعارات التالية فقط إلى آخر وكيل في المحادثة.
إذا كنت تستخدم تطبيق Dialogflow، وكان الإعدادات > Dialogflow > الاستيلاء البشري فعالة، لا يتم إرسال إشعارات إذا كان الدردشة الآلية تعرف الإجابة.
إذا كنت تستخدم نسخة WordPress، لا يتم دعم إشعارات الدفع في منطقة إدارة WordPress، يجب عليك الوصول إلى منطقة الإدارة الخاصة بـ Alz-Bot مباشرةً، المزيد من التفاصيل هنا.
إذا كانت إعدادات الـ توجيه فعالة، يتلقى الإشعار الوكيل المعين للمحادثة فقط، يرى المشرفون جميع المحادثات ولكنهم لا يتلقون الإشعارات.
إذا كانت إعدادات الـ طابور الانتظار فعالة، يتلقى الإشعار الوكيل المعين للمحادثة فقط. لا ترسل الإشعارات للرسائل التي يتم إرسالها بواسطة المستخدم أثناء الانتظار في الطابور. يرى المشرفون جميع المحادثات ولكنهم لا يتلقون الإشعارات.
إذا كانت محادثة المستخدم معينة لقسم، يتلقى الإشعار فقط الوكلاء المعينون لتلك الإدارة.
إذا كانت محادثة المستخدم ليست معينة لأي قسم، يتلقى الإشعار فقط الوكلاء الذين ليس لديهم إدارة معينة.
لا تدعم الإشعارات على iPhone وأجهزة iOS.
ترسل الإشعارات فقط إذا كان آخر وكيل في المحادثة غير متصل.
و الإعدادات > Dialogflow > الاستيلاء البشري فعالة، لا يتم إرسال إشعارات إذا كان الدردشة الآلية تعرف الإجابة.
إذا لم تعمل إشعارات الدفع، تأكد من أنك سمحت بالإشعارات، في Chrome يمكنك التحقق من ذلك من الخصوصية والأمان > إعدادات الموقع > الإشعارات. إذا لم تعمل على جهاز محمول، جرب هذه الخطوات أيضًا: قم بتثبيت تطبيق PWA أو حذفه وتثبيته مرة أخرى، أعد تشغيل الجهاز المحمول.

إشعارات سطح المكتب

لا ترسل الإشعارات إذا كان المستخدم يعرض صفحة تحتوي على الدردشة (متصفح المستخدم مفتوح وواضح، والصفحة النشطة تحتوي على الدردشة).
لا تدعم الإشعارات على iPhone وأجهزة iOS.
تعمل الإشعارات فقط لعناوين URL الآمنة التي تستخدم HTTPS (ليس HTTP). يجب أن يكون عنوان URL الخاص بالإدارة Alz-Bot HTTPS.
عندما تكون إشعارات الدفع نشطة، تحل محل إشعارات سطح المكتب.

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

يمكن إشعار كل من الوكلاء والمستخدمين عبر الرسائل النصية عند ورود رسالة جديدة. يتم توفير إشعارات الرسائل النصية بواسطة Twilio. Twilio هو خدمة مدفوعة، ولكنها رخيصة، ويمكنك استخدام الإصدار التجريبي لاختبار إشعارات الرسائل النصية مجانًا.

التفعيل

انتقل إلى https://www.twilio.com وأنشئ حسابًا جديدًا.
قم بالتحقق من رقم هاتفك.
أكمل النموذج واختر رسائل نصية قصيرة (SMS).
بمجرد الدخول إلى لوحة التحكم، انقر فوق الحصول على رقم تجريبي، ثم اختيار هذا الرقم.
انتقل إلى منطقة الإدارة Alz-Bot ، اذهب إلى الإعدادات > الإشعارات > إشعارات الرسائل النصية، والصق مُعرِّف الحساب ورمز المصادقة والرقم التجريبي (أو رقم الهاتف المشترى). ابحث عن جميع التفاصيل في لوحة تحكم Twilio.
إذا كنت تستخدم الإصدار التجريبي، يمكنك إرسال إشعارات فقط إلى الأرقام المتحققة. انتقل إلى لوحة تحكم Twilio وانقر على الزر الأيسر # (أرقام الهاتف)، ثم انقر على هويات المتصلين المتحققة وأضف رقم هاتفك.
لبدء استخدام الخدمة بشكل حي وتلقي الرسائل النصية في Alz-Bot ، يجب عليك شراء رقم هاتف. بعد الشراء، انتقل إلى أرقام الهواتف > إدارة > الأرقام النشطة، انقر فوق رقمك، وأدخل عنوان URL Alz-Bot ، احصل عليه من Alz-Bot > الإعدادات > الإشعارات > إشعارات الرسائل النصية > الحصول على عنوان تكوين الURL.
انتهيت.

المعلومات

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

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

تعمل الأصوات فقط بعد تفاعل المستخدم أو الوكيل مع الوثيقة (قام المستخدم أو الوكيل بالنقر في مكان ما).

ورد بريس

الإعدادات أدناه تتعلق بنسخة ورد بريس من Alz-Bot.

مزامنة المستخدم

يمكن مزامنة مستخدمي ورد بريس تلقائيًا مع Alz-Bot عند تحديد "ورد بريس" تحت نظام المستخدمين في الإعدادات > ورد بريس. عند التفعيل، يتعرف الدردشة الأمامية تلقائيًا على جميع مستخدمي ورد بريس المسجلين الذين يقومون بإنشاء حساب مستخدم جديد في Alz-Bot بنفس التفاصيل (الاسم، اللقب، البريد الإلكتروني، وكلمة المرور). أيضًا، يتعرف نموذج تسجيل الدخول على البريد الإلكتروني وكلمة المرور لكل مستخدم ورد بريس. عند تسجيل الدخول إلى Alz-Bot، يتم تسجيل الدخول تلقائيًا إلى ورد بريس أيضًا.

لإنشاء مستخدم ورد بريس عندما يقوم الزائر بالتسجيل في Alz-Bot، قم بتمكين الخيار الإعدادات > ورد بريس > تسجيل الدخول لورد بريس وتضمين حقول كلمة المرور والبريد الإلكتروني في نموذج التسجيل، حيث يتطلب ذلك. سيتم تسجيل دخول مستخدم ورد بريس تلقائيًا.

مزيد من المعلومات

الوصول المباشر وتطبيق PWA

يمكنك الوصول إلى منطقة الإدارة مباشرة دون الذهاب من خلال ورد بريس عن طريق التنقل إلى /wp-content/plugins/alz-bot/alz-bot/admin.php وتسجيل الدخول باستخدام حساب البريد الإلكتروني وكلمة المرور الافتراضية الخاصة بك. يرجى ملاحظة أن مجلد wp-content الخاص بك قد يكون مختلفًا. من خلال الوصول المباشر إلى الإدارة، ستكون أيضًا قادرًا على استخدام منطقة الإدارة كتطبيق ويب تقدمي. يمكنك العثور على مزيد من التفاصيل حول هذا عند النقر هنا.

تسجيل الدخول وتسجيل الخروج

لتسجيل الخروج من منطقة الإدارة في Alz-Bot، قم بتسجيل الخروج من ورد بريس من منطقة الإدارة في Alz-Bot، وعندما تقوم بتسجيل الخروج، ستكون قادرًا على تسجيل الدخول بحساب ورد بريس آخر. للوصول إلى منطقة الإدارة من داخل ورد بريس، يجب أن تقوم بتسجيل الدخول بأحد أدوار مستخدمي ورد بريس التالية: المسؤول، الكاتب، المحرر.

الحصول على معرف الصفحة أو نوع المنشور

للحصول على معرف صفحة أو نوع محدد، انتقل إلى منطقة الإدارة في ورد بريس وقم بتحرير الصفحة أو المنشور. يتم عرض المعرف في شريط العنوان. مثال: http://your-site.com/wp-admin/post.php?post=11&action=edit&lang=en (معرف الصفحة/المنشور هو 11).

الحصول على عنوان Post Type

عنوان Post Type لأرشيف المدونة والمنشورات هو post. Post Type للصفحات هو page. للحصول على عنوان Post Type مخصص، انتقل إلى منطقة الإدارة في ورد بريس وافتح صفحة Post Type المخصصة من القائمة اليسرى. يتم عرض العنوان في شريط العنوان. مثال: http://your-site.com/wp-admin/edit.php?post_type=food (العنوان هو food).

تعطيل ورد بريس 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");

ورد بريس Multisite

إذا كنت تستخدم التثبيت متعدد المواقع، يجب عليك تثبيت Alz-Bot في الموقع الرئيسي.

WOOCOMMERCE

WooCommerce

الإعدادات أدناه تتعلق بتطبيق WooCommerce لنسخة ورد بريس من Alz-Bot.

Dialogflow

البدء

لبدء استخدام تطبيق الدردشة Dialogflow، انتقل إلى الإعدادات > WooCommerce > مزامنة Dialogflow وانقر على مزامنة الكيانات الآن ، ثم انقر على إنشاء النوايا الآن. بمجرد الانتهاء من المزامنة، أنت تقوم بذلك. سيبدأ الدردشة في الرد على أسئلة المستخدمين.

قائمة أسئلة النوايا المدمجة

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

هل تبيع أحذية بأقل من 299 دولارًا؟
أرني حقائبك
هل لديك أي شيء للنساء في الترقية؟
ما هي أفضل الأحذية لعام 2020؟
إضافة Abstract Print إلى السلة
إزالة Abstract Print من السلة
ماذا تبيع

ما هو حالة طلبي؟
أين سيتم شحن طلبي؟
عرض المنتجات في سلة التسوق الخاصة بي!
هل تشحنون في أستراليا؟
إلى أين تشحنون؟
افتح صفحة الأحذية.
انتقل إلى صفحة القميص الكشمير، من فضلك.

الإجراءات

تتيح الإجراءات التالية للروبوت الدردشة التفاعل مع المتجر بشكل ذاتي نيابة عن المستخدم. لاستخدام إجراء، انتقل إلى Dialogflow، قم بتحرير النية وأضف استجابة تخصيص الحمولة باستخدام الصيغة التالية: { "ACTION-NAME": ACTION-VALUE }.

رمز الإجراء	الوصف
{ "woocommerce-update-cart": [ "cart-add", "PRODUCT-NAME-OR-ID" ] }	يضيف منتجًا إلى سلة المستخدم. استبدل PRODUCT-NAME-OR-ID بمعرف المنتج أو الاسم الكامل للمنتج.
{ "woocommerce-update-cart": [ "cart-remove", "PRODUCT-NAME-OR-ID" ] }	يزيل منتجًا من سلة المستخدم. استبدل PRODUCT-NAME-OR-ID بمعرف المنتج أو الاسم الكامل للمنتج.
{ "woocommerce-checkout": true }	يوجه المستخدم إلى صفحة الخروج.

متعدد اللغات

تتوافق ميزة متعدد اللغات مع الإضافات WPML و Polylang.
لتفعيل ميزة متعدد اللغات، انتقل إلى الإعدادات > ورد بريس > إضافة لغة واختر WPML أو Polylang. يقوم التزامن تلقائيًا بإنشاء الكيانات في جميع اللغات المتاحة على موقع الويب الخاص بك. لتعمل الروبوت الدردشة بلغة ما، يجب ترجمته إلى تلك اللغة في Dialogflow، للمزيد من التفاصيل هنا.
النيات الرئيسية المدمجة في Dialogflow هي باللغة الإنجليزية فقط، لترجمتها انتقل إلى وحدة التحكم في Dialogflow، اختر اللغة التي تريد ترجمتها، انتقل إلى صفحة النيات وقم بترجمة نيات WooCommerce الحالية.
ميزة متعددة اللغات لـ WooCommerce سمات المنتجات تتطلب إضافة WPML إذا كنت تستخدم WPML أو إضافة Polylang for WooCommerce إذا كنت تستخدم Polylang.

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

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

الدمج والشرائح في WooCommerce

يمكن استخدام حقول الدمج والشرائح التالية في رسائل البريد الإلكتروني والرسائل.

الرمز	الوصف	التوافق
{product_images}	شريط صور المنتجات. إذا لم يكن هناك نتائج، يتم استبدال الرسالة الكاملة بـ "لم يتم العثور على نتائج".	Dialogflow
{shipping_location_check}	تحقق مما إذا كان المتجر يشحن إلى البلد المحدد.	Dialogflow
{product_attribute_terms}	قائمة مصطلحات سمة المنتج.	Dialogflow
{product_attribute_name}	اسم سمة مصطلح.	Dialogflow
{category_link}	رابط صفحة الفئة.	Dialogflow
{tag_link}	رابط صفحة العلامة.	Dialogflow
{product_name}	اسم المنتج.	Dialogflow, الرسائل الآلية
{product_image}	صورة المنتج.	Dialogflow, الرسائل الآلية
{product_price}	سعر المنتج.	Dialogflow, الرسائل الآلية
{product_description}	وصف المنتج.	Dialogflow, الرسائل الآلية
{product_rating}	تقييم المنتج. إذا لم يكن للمنتج تقييمات بعد، يتم استبدال الرسالة الكاملة بـ "[اسم المنتج] ليس لديه تقييمات أو آراء حتى الآن".	Dialogflow, الرسائل الآلية
{product_link}	رابط المنتج.	Dialogflow, الرسائل الآلية
{shipping_locations}	قائمة ببلدان الشحن.	Dialogflow, Messages, Automated Messages
{shop_link}	رابط المتجر.	Dialogflow, Messages, Automated messages
{cart_link}	رابط السلة.	Dialogflow, Messages, Automated Messages
{cart}	قائمة المنتجات في سلة المستخدم. إذا كانت السلة فارغة، يتم استبدال الرسالة بـ "سلة التسوق الخاصة بك فارغة حاليًا".	Dialogflow, Automated Messages
{order_status}	حالة طلب المستخدم الأخير. إذا لم يقم المستخدم بتقديم طلب بعد، يتم استبدال الرسالة بـ "لم تقم بتقديم طلب بعد".	Dialogflow, Automated Messages
{order_details}	تفاصيل الطلب الأخير للمستخدم. إذا لم يقم المستخدم بتقديم طلب بعد، يتم استبدال الرسالة بـ "لم تقم بتقديم طلب بعد".	Dialogflow, Automated Messages
{product_card}	بطاقة المنتج. سمات اختيارية: id معرف المنتج. link-type العمل عند نقر المستخدم. القيم المتاحة: شراء، الخروج، رابط. الافتراضي: شراء. link-text نص الزر. الافتراضي: شراء.	Dialogflow, Messages, Automated Messages
{products_slider}	البحث عن المنتجات المطابقة للسمات المعطاة وعرضها في سلايدر من بطاقات المنتجات. إذا لم يكن هناك نتائج، يتم استبدال الرسالة بـ "لم يتم العثور على نتائج". سمات اختيارية: id معرف المنتجات مفصولة بفواصل. إذا تم تعيين هذه السمة، يتم تجاهل جميع السمات الأخرى. tag عرض فقط المنتجات ذات العلامة المعينة. category عرض فقط المنتجات في الفئة المعينة. discounted قم بتعيينها إلى صحيح لعرض فقط المنتجات في التخفيضات. rating عرض فقط المنتجات بتقييم يساوي أو يزيد عن القيمة المعطاة. أدخل قيمة من 1 إلى 5. max-price عرض فقط المنتجات بسعر يساوي أو أقل من القيمة المعطاة. أدخل رقماً. min-price عرض فقط المنتجات بسعر يساوي أو يزيد عن القيمة المعطاة. أدخل رقماً. attribute عرض فقط المنتجات ذات السمة المعينة. link-type العمل عند نقر المستخدم. القيم المتاحة: شراء، الخروج، رابط. الافتراضي: شراء. link-text نص الزر. الافتراضي: شراء. language رمز لغة المنتجات التي سيتم عرضها.	Dialogflow, Messages, Automated Messages
{payment_methods}	طرق الدفع المتاحة.	Dialogflow, Messages, Automated Messages
{coupon}	إنشاء رمز كوبون. سمات اختيارية: discount خصم الكوبون بالنسبة المئوية. expiration انتهاء صلاحية الكوبون. مثال: '60 ثانية'، '5 ساعات'، '2 أيام'.	Dialogflow, Messages, Automated Messages
{product_names}	أسماء المنتجات.	فقط حينما يتم تحديدها
{discount_price}	سعر المنتج المخفض أو السعر الإجمالي المخفض لعدة منتجات.	فقط حينما يتم تحديدها
{original_price}	السعر الأصلي للمنتج أو السعر الأصلي الإجمالي لعدة منتجات.	فقط حينما يتم تحديدها
{carts}	قائمة سلات المستخدمين مع المنتجات.	فقط حينما يتم تحديدها
{purchase_button}	زر شراء المنتج.	فقط حينما يتم تحديدها
{html_product_card}	بطاقة تفاصيل المنتج.	البريد الإلكتروني
{html_products_list}	قائمة ببطاقات تفاصيل المنتجات.	البريد الإلكتروني

رسائل غنية

الشورتكود	الوصف
[woocommerce-button name="" ids="" coupon="" checkout="true"]	أضف منتجًا أو عدة منتجات إلى سلة التسوق الخاصة بالمستخدم. قم بتطبيق رمز القسيمة اختياريًا وأعد توجيه المستخدم إلى صفحة الخروج.

مزيد من المعلومات

قائمة الانتظار

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

إشعار إزالة العنصر من سلة التسوق

إذا تم تضمين رمز القسيمة، يتم إرسال رسالة الدردشة فقط لأول عنصر تمت إزالته، ثم مرة أخرى بعد انتهاء صلاحية القسيمة.
القسيمة صالحة فقط للعناصر التي تمت إزالتها.
يمكن استخدام حقول الدمج التالية أيضًا في موضوع البريد الإلكتروني: {coupon}، {discount_price}، {original_price}، {product_names}، {customer_name}.
سيتم إشعار المستخدمين الذين لديهم بريد إلكتروني فقط عبر البريد الإلكتروني.

إشعار للزوار العائدين

تُرسل رسالة الدردشة بعد 15 ثانية.
تُرسل رسالة الدردشة إلى المحادثة النشطة، إذا كانت موجودة، وإلا إلى محادثة جديدة.
يُعتبر الزائر "زائرًا عائدًا" فقط إذا مضى على الأقل 24 ساعة من آخر زيارة.
تُرسل رسالة الدردشة مرة واحدة فقط، إذا عاد الزائر مرة أخرى، لن يتم إرسال الرسالة.

رسالة متابعة

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

متنوع

عندما يكمل الزائر عملية الشراء، يتم إنشاء مستخدم جديد لـ Alz-Bot بناءً على التفاصيل المقدمة في استمارة الخروج تلقائيًا.
تُرسل الرسائل التلقائية (رسالة سلة التسوق المهجورة، رسائل المتابعة، ...) إلى المحادثة النشطة، إذا كانت موجودة، وإلا إلى محادثة جديدة.
قيم القسائم الافتراضية هي خصم 0% وصلاحية لمدة 7 أيام.
تظل القسائم في سلة المهملات سارية، يجب حذفها بشكل دائم.
يمكن استخدام جميع القسائم مرة واحدة فقط.
تُحذف القسائم التي انتهت صلاحيتها تلقائيًا عبر الوظائف المجدولة.
تبحث نافذة منتجات منطقة المحادثات الإدارية عن اسم المنتج والوصف والسعر.
نافذة منتجات منطقة المحادثات الإدارية متعددة اللغات وتعرض تلقائيًا منتجات لغة المستخدم إذا كانت متاحة.
لعرض طلبات المستخدمين الضيوف الذين لم يرسلوا أي رسالة دردشة قبل الشراء، يجب تمكين الإعدادات > المستخدمين > تسجيل جميع الزوار.
إعداد محدد منتجات التذاكر > استثناء المنتجات يقبل معرفات منتجات WooCommerce مفصولة بفواصل.

متجر WhatsApp

للسماح للمستخدم بشراء منتجات متجر WooCommerce على WhatsApp، يجب أن يكون معرف المنتج لمنتجات متجر WhatsApp نفس معرف المنتج لمنتجات WooCommerce الخاصة بك. بمجرد أن يرسل المستخدم طلب WhatsApp، يحفظ WooCommerce ذلك تلقائيًا، استخدم حقل الدمج {catalog_checkout} لإرسال رابط الخروج إلى المستخدم.

استخدم البرنامج المساعد https://ورد بريس.org/plugins/facebook-for-woocommerce/ لمزامنة منتجات WooCommerce تلقائيًا مع منتجات متجر WhatsApp.

التذاكر

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

التثبيت والاستخدام

تثبيت PHP

لعرض منطقة التذاكر، قم بتضمين البرنامج النصي التالي في صفحتك.

        <script src="alz-bot/js/min/jquery.min.js"></script> <!-- Not required if jQuery is already loaded -->
        <script id="sbinit" src="alz-bot/js/main.js?mode=tickets"></script>

لا يمكنك تضمين كل من منطقة الدردشة ومنطقة التذاكر في نفس الصفحة. تأكد من إزالة البرنامج النصي الذي يحمل الدردشة. يمكنك عرض منطقة التذاكر أيضًا عن طريق إدراج الكود <script>SB_TICKETS = true;</script> في أي صفحة تعرض الدردشة.
لتحديد موقع منطقة التذاكر، أدخل الكود <div id="sb-tickets"></div>. ستظهر منطقة التذاكر داخل عنصر div هذا. بشكل افتراضي، يتم إلحاق منطقة التذاكر بالـ body.

تثبيت ووردبريس

لعرض التذاكر، استخدم الشورتكود [sb-tickets]. أدرجه في أي صفحة، منشور، أو عنصر نوع منشور.

تثبيت الإصدار السحابي

لعرض منطقة التذاكر، قم بتضمين نص سكريبت الدردشة السحابية في صفحتك وأضف السمة &mode=tickets إلى عنوان السكريبت، مثل <script id="chat-init" src="https://alz-bot.techn-oviz.com/account/js/init.js?id=65895623&mode=tickets"></script>. يمكنك أيضًا عرض منطقة التذاكر عن طريق إدراج الكود <script>SB_TICKETS = true;</script> في أي صفحة تظهر فيها الدردشة.

المعلومات

التذاكر هي نفسها في محادثات الدردشة والرسائل، الفارق الوحيد عن الدردشة هو لوحة العرض الأمامية.
معظم إعدادات الدردشة متوافقة مع تطبيق التذاكر ولكن ليست كلها. إعدادات لوحة التحكم ورسالة الظهور المنبثقة وغيرها ليست متوافقة.
تتوفر واجهات برمجة التطبيقات المخصصة لتطبيق التذاكر في قسم الواجهة البرمجية.
لإزالة نموذج 'تذكرة جديدة' الإلزامي للمستخدمين الجدد، قم بتفعيل رسالة الترحيب في الإعدادات > الرسائل > رسالة الترحيب. تتجاهل تأخير رسالة الترحيب في منطقة التذاكر، وترسل الرسالة فورًا..
لتعطيل التسجيل الإلزامي يدويًا على صفحة واحدة فقط، استخدم رمز JavaScript var SB_REGISTRATION_REQUIRED = true. قم بتعيينها إلى true لفرض التسجيل.

DIALOGFLOW

Dialogflow

الإعدادات أدناه متعلقة بتطبيق Dialogflow.

المزامنة

لبدء استخدام Dialogflow مع Alz-Bot، اتبع الخطوات أدناه.

انتقل إلى console.cloud.google.com وقم بتسجيل الدخول.
قم بتنشيط واجهة برمجة التطبيقات Dialogflow عن طريق إدخال واجهة برمجة تطبيقات Dialogflow في شريط البحث العلوي. انقر فوق واجهة برمجة تطبيقات Dialogflow ثم انقر على تمكين.
أنشئ مشروعك الأول بالنقر فوق زر اختيار مشروع في أعلى اليسار. قم بتسمية المشروع كما تريد.
حدد المشروع وانتقل إلى القائمة اليسرى > واجهات برمجة التطبيقات والخدمات > موافقة OAuth. حدد External وانقر على إنشاء. في اسم التطبيق، أدخل ما تريد، في البريد الإلكتروني لدعم المستخدم ومعلومات الاتصال بالمطور، أدخل بريدك الإلكتروني. انقر فوق حفظ ومتابعة.
في منطقة النطاقات، انقر فوق إضافة أو إزالة النطاقات، انتقل إلى الأسفل وأدخل https://www.googleapis.com/auth/dialogflow,https://www.googleapis.com/auth/cloud-language,https://www.googleapis.com/auth/cloud-translation في منطقة أضف النطاقات يدويًا. انقر فوق إضافة إلى الجدول ثم تحديث و حفظ ومتابعة.
في منطقة مستخدمي الاختبار، انقر فوق إضافة مستخدمين وأضف بريدك الإلكتروني من Google، استخدم نفس البريد الإلكتروني الذي تم تسجيل الدخول به حاليًا. انقر فوق حفظ ومتابعة.
انتقل إلى القائمة اليسرى > واجهات برمجة التطبيقات والخدمات > بيانات اعتماد وانقر فوق إنشاء بيانات اعتماد، حدد معرف عميل OAuth. باعتبار نوع التطبيق، حدد تطبيق ويب. أدخل أي اسم تريده. في معرف الإعادة الموجهة المصرح به، أدخل عنوان URL للإعادة المصرح به، احصل عليه من Alz-Bot > الإعدادات > Dialogflow > Synchronization > معرف الإعادة المصرح به. انقر فوق إنشاء.
انسخ معرف العميل و السر الخاص بالعميل والصقهم في Alz-Bot > الإعدادات > Dialogflow > مزامنة. حفظ الإعدادات.
انقر فوق Alz-Bot > الإعدادات > Dialogflow > مزامنة > مزامنة. قم بتسجيل الدخول بنفس حساب Google الذي قمت باستخدامه حتى الآن. في الشاشة التالية، انقر فوق متابعة. في الشاشة التالية، حدد جميع النطاقات وانقر فوق متابعة.
قم بنسخ رمز التحديث والصقه في Alz-Bot > الإعدادات > Dialogflow > التزامن > رمز التحديث.
أنت على وشك الانتهاء! الآن يجب عليك إدخال معرف مشروع الدردشة الخاص بك أو اسم الوكيل، للحصول عليه اتبع الخطوات أدناه. يرجى ملاحظة أن التطبيق لا يحتاج إلى الموافقة من قبل Google.

الحصول على معرف المشروع

قم بتسجيل الدخول إلى وحدة تحكم Dialogflow ES عبر الانتقال إلى dialogflow.cloud.google.com. يجب عليك تسجيل الدخول بنفس حساب Google المستخدم أثناء التزامن.
انقر على رمز العتاد في الجزء العلوي الأيسر، بالقرب من اسم الدردشة، وافتح منطقة الإعدادات. . إذا لم تقم بإنشاء دردشة بعد، اتبع التعليمات أدناه لإنشاء أول دردشة لك.
قم بنسخ معرف المشروع .
تأكد من اختيار US / GLOBAL في أعلى اليسار من لوحة التحكم في Dialogflow .

الحصول على اسم وكيل Dialogflow CX

قم بتسجيل الدخول إلى وحدة تحكم Dialogflow CX عبر الانتقال إلى https://dialogflow.cloud.google.com/cx/.
حدد مشروع الوكيل المرغوب وانتقل إلى صفحة الوكلاء. يمكنك الوصول إلى صفحة الوكلاء عن طريق تحديد الوكيل والنقر على الزر العلوي وكلاء > عرض جميع الوكلاء .
انقر فوق قائمة الخيارات للوكيل المرغوب فيها وانقر فوق نسخ الاسم .
المزيد من التفاصيل على https://cloud.google.com/dialogflow/cx/docs/quick/api#detect-intent-drest.

إنشاء دردشة

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

إنشاء دردشة أساسية

لإنشاء دردشتك الأولى، ادخل وحدة تحكم Dialogflow وأنشئ وكيلًا. كـ مشروع Google، حدد نفس المشروع المستخدم خلال التزامن.
أضف نية جديدة من القائمة اليسرى وافتحها.
في منطقة عبارات التدريب، أضف سؤال المستخدم الذي ترغب في أن يرد عليه الدردشة، أضف قدر الإمكان من الأشكال المتغيرة. على سبيل المثال، إذا كنت تريد من الدردشة الرد على المستخدمين الذين يسألون عن عنوان أعمالك، أضف أشكالًا متغيرة مثل "ما هو عنوانك"، "العنوان"، "أين أنت".
في منطقة الردود، أضف إجابة الدردشة كـ رد نصي.
لقد قمت بإنشاء سؤالك وجوابك الأول! اختبره من المنطقة اليمنى أو من دردشة Alz-Bot. أضف نياتًا جديدة لملء دردشتك بالأسئلة والأجوبة التي تريدها. يمكنك تضمين أسئلة وأجوبة مبنية مسبقًا من خلال تمكين ميزة الدردشة الصغيرة من القائمة اليسرى.

إليك بعض الموارد الرائعة لمساعدتك في بناء دردشة أكثر تعقيدًا:

الإجراءات

تعطي الإجراءات التالية للدردشة القدرة على التفاعل مع الموقع بشكل ذاتي نيابةً عن المستخدم. لاستخدام إجراء، انتقل إلى Dialogflow، قم بتحرير النية، وأضف استجابة حمولة مخصصة جديدة بالصيغة التالية: { "اسم-الإجراء": قيمة-الإجراء }.

رمز الإجراء	الوصف
{ "human-takeover": true }	تعطيل الدردشة الآلية لمدة 5 دقائق، وإعلام الوكلاء، وترك المحادثة كما هو، مُعلَّمة بأنها غير مقروءة.
{ "disable-bot": true }	تعطيل الدردشة الآلية لمدة 5 دقائق.
{ "redirect": "URL" }	إعادة توجيه المستخدم إلى الرابط المحدد. أضف القيمة "new-window": true لفتح الرابط في نافذة جديدة.
{ "open-article": ID }	فتح المقالة ذات الهوية المحددة.
{ "transcript": true }	إنشاء نص للحديث كملف وتنزيله. قم بتعيينه إلى email لإرسال الحديث إلى بريد المستخدم، وأضف القيمة message: "رسالتك" لتضمين رسالة في البريد.
{ "department": ID }	تغيير أو تعيين قسم المحادثة وإعلام الوكلاء.
{ "agent": ID }	تغيير أو تعيين الوكيل المخصص للمحادثة وإعلام الوكيل.
{ "send-email": { "recipient": "active_user", "message": "", "attachments": [] } }	إرسال بريد إلكتروني إلى المستخدم النشط أو الوكلاء. صيغة المرفقات: [["الاسم", "الرابط"], ["الاسم", "الرابط"], ...]]. يمكن أن تكون قيمة المستلم active_user أو agents.
{ "update-user": true }	يُخبر منطقة الإدارة بتحديث مستخدم المحادثة النشط. استخدم هذا الإجراء بالتزامن مع إجراءات أخرى لتحديث تفاصيل المستخدم في منطقة الإدارة في الوقت الحقيقي.
{ "archive-chat": true }	أرشفة الدردشة وإرسال رسالة الإغلاق إذا كانت نشطة.
{ "update-user-details": { "email": "", "last_name": "", "first_name": "", "extra": { "phone": ["+123456789", "الهاتف"] }}}	تحديث تفاصيل المستخدم النشط. يمكنك تحديث جميع التفاصيل، بما في ذلك first_name، last_name، email، user_type، password. يمكنك تحديث تفاصيل المستخدم الإضافية، مثل رقم الهاتف، عن طريق إدخال القيم في مفتاح extra، ويجب أن تستخدم القيم الصيغة التالية: "slug": [القيمة، "التسمية"]. قم بتنزيل مثال هنا. لتحميل نية، انتقل إلى منطقة النوايا وانقر على رمز القائمة المكعبة الموجود في أعلى اليمين، ثم انقر على تحميل النية. ابدأ المحادثة بإرسال الرسالة "start".

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

لتمكين ميزة اكتشاف اللغة وترجمة الرسائل التلقائية من لغة الوكيل إلى لغة المستخدم، ورسائل المستخدم إلى لغة الوكيل، قم بالتحقق من الخيار الإعدادات > Dialogflow > الترجمة التلقائية ومزامنة Dialogflow. يجب أن يكون لدى حساب Google المستخدم لمزامنة Dialogflow فواتير وتفعيل خدمة cloud-translation، للقيام بذلك اتبع الخطوات التالية:

قم بتسجيل الدخول إلى https://console.cloud.google.com باستخدام حساب Google الخاص بك وحدد مشروع وكيل Dialogflow الخاص بك.
على شريط البحث العلوي، اكتب cloud translation، اختر خدمة Cloud Translation API وقم بتفعيلها. يرجى ملاحظة أن هذه خدمة مدفوعة مع طبقة مجانية، قد تحدث تكاليف إضافية.
قم بتفعيل الفوترة عن طريق النقر فوق القائمة اليسارية > الفوترة ومن ثم بتفعيل حساب الفوترة بوسيلة دفع صالحة. قم بتفعيل الفوترة لمشروع وكيل Dialogflow الخاص بك.

بمجرد إكمال إعداد حساب Google، تبدأ الترجمات التلقائية بالعمل فوراً. فيما يلي المزيد من التفاصيل:

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

اكتشاف اللغة

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

التحكم البشري

معلومات عامة

عند تفعيل التحكم البشري، يتم تعطيل الروبوت الدردشة تلقائياً طالما يكون الوكيل متصلاً. بعد ذلك، يتم تفعيل الروبوت مرة أخرى ولكن لن يتم إرسال أي رسائل افتراضية افتراضية في غضون 10 أيام من التحكم البشري إذا لم يكن الروبوت يعرف الإجابة على سؤال المستخدم في نفس المحادثة. يمكنك إجبار رسالة Dialogflow للإرسال دائمًا عن طريق إضافة القيمة المخصصة "force-message": true إلى النية.
يتم تفعيل الروبوت بالكامل مرة أخرى عند أرشفة المحادثة أو حذفها.
إذا كنت تستخدم Slack، لن تتم إرسال رسائل إذا كان الروبوت يعرف الإجابة. بمجرد تفعيل التحكم البشري، يتم إرسال جميع رسائل المحادثة إلى Slack.
عندما يرد وكيل بشري على مستخدم، يتم تفعيل التحكم البشري تلقائيًا.

خيار التحكم البشري

عند تفعيل الخيار التحكم البشري، يحدث ما يلي:

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

عندما يؤكد المستخدم التحكم البشري، أو إذا كان ذلك تلقائيًا، يحدث ما يلي:

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

التحكم البشري اليدوي

يمكنك تشغيل التحكم البشري يدويًا عن طريق إنشاء نية جديدة مع الاستجابة التالية بالنيابة عن الحمل المخصص: { "human-takeover": true }.
يتم تنبيه الوكلاء يدويًا تلقائيًا ويتم ترك المحادثة معلمة كغير مقروءة.
لإرسال طلب تحكم بشري يدويًا، استخدم رسالة الرقائق الغنية بالرقم التعريفي sb-human-takeover. على سبيل المثال: [chips id="sb-human-takeover" options="دعم بشري، إلغاء" message=""].

واتساب، ماسنجر، تلغرام

لجعل طلب التحكم البشري يعمل على واتساب، ماسنجر، تلغرام، يجب عليك إنشاء نية جديدة مع human-takeover كـ سياق الإدخال، ولا شيء كـ سياق الإخراج، وقائمة من رسائل التأكيد الشائعة للمستخدم كـ عبارات التدريب (مثل موافق، نعم) و { "human-takeover": true } كـ استجابة الحمولة المخصصة .

الرد الذكي

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

اقتراحات الروبوت

لاستخدام اقتراحات الروبوت، قم بمزامنة Dialogflow بشكل طبيعي وق train the chatbot كالمعتاد. سيتم استخدام نفس الروبوت المستخدم للمستخدمين.

اقتراحات مساعد الوكيل

تتطلب مساعد الوكيل معرفة تقنية للعمل ومخصصة فقط للأعمال التجارية ذات البيانات بحد أدنى من 30،000 محادثة. إذا لم تستخدم مساعد الوكيل من قبل، فمن المرجح أنك لا تمتلك المعرفة والبيانات اللازمة لاستخدامه، وبالتالي يمكنك تجاهله. المزيد من التفاصيل على https://cloud.google.com/agent-assist/docs/conversation-profile.

المعلومات

يبحث الرد الذكي أولاً عن اقتراح من الروبوت، إذا كان هناك على الأقل واحد يعود بالنتائج، وإلا يبحث عن الاقتراح عبر مساعد الوكيل إذا كان متاحًا. لا يتم استخدام مساعد الوكيل أبدًا إذا قدم الروبوت على الأقل تلميحًا واحدًا.

OpenAI

تمنحك تكامل OpenAI (ChatGPT) القدرة على الرد على الأسئلة العامة حول أي شيء تقريبًا يمكنك أن تتخيله. لبدء الاستخدام، اتبع الخطوات أدناه.

قم بالتسجيل على https://beta.openai.com/signup.
احصل على مفتاح API من https://beta.openai.com/account/api-keys والصقه في الإعدادات > Dialogflow > OpenAI > مفتاح الواجهة

إنشاء تعبيرات المستخدم - الخيار

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

إنشاء تعبيرات المستخدم - زر

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

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

المعلومات

يتم تنفيذ استعلام OpenAI فقط إذا لم يكن الروبوت يعرف إجابة على سؤال المستخدم وإذا كانت طول رسالة المستخدم أكبر من 6 أحرف.

البحث في Google

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

قم بالتسجيل على https://programmablesearchengine.google.com/.
قم بإنشاء بحث وقم بإعداده كما تريد. نوصي بإضافة موقع الويب الخاص بك فقط وويكيبيديا إذا كنت تريد أن يرد الروبوت على أسئلة عامة، اترك خيار البحث في الويب بأكمله معطلًا. استخدم إعداد الكيانات لاستبعاد النتائج غير الصالحة.
انتقل إلى تحرير محرك البحث > إعداد > أساسي وانسخ قيمة معرف محرك البحث، والصقه في Alz-Bot.
للحصول على مفتاح API، قم بزيارة https://developers.google.com/custom-search/v1/overview وانقر على الحصول على مفتاح.

الكيانات

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

قم بتسجيل الدخول إلى https://console.cloud.google.com بحساب Google الخاص بك وحدد مشروع وكيل Dialogflow الخاص بك.
أدخل واجهة برنامج Cloud Natural Language API في شريط البحث في الأعلى، وحدد واجهة برنامج Cloud Natural Language API وفعل الواجهة البرمجية .
فعل الفوترة عن طريق النقر على القائمة اليسرى > الفوترة وفعل حساب فوترة بطريقة دفع صالحة. قم بتفعيل الفوترة لمشروع وكيل Dialogflow الخاص بك.

المعلومات

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

الوفاء

بيانات الوفاء التي يتم إرسالها إلى عنوان URL الخاص بالويب هي كما يلي:

{
    "responseId": "4a58fc4f...",
    "queryResult": {
        "queryText": "الوفاء",
        "parameters": [],
        "allRequiredParamsPresent": true,
        "fulfillmentText": "مثال",
        "fulfillmentMessages": [{
            "text": {
                "text": ["الاستجابة"]
            }
        }],
        "outputContexts": [{
            "name": "projects/schiocco...",
            "parameters": {
                "no-input": 0,
                "no-match": 0
            }
        }],
        "intent": {
            "name": "projects/schiocco...",
            "displayName": "الوفاء"
        },
        "intentDetectionConfidence": 1,
        "languageCode": "en"
    },
    "originalDetectIntentRequest": {
        "payload": {
            "support_board": {
                "conversation_id": "3002",
                "user_id": "3777"
            }
        }
    },
    "session": "projects/example/agent/sessions/3777-3002"
}

تحتوي الحقول payload و session على معرف المستخدم ومعرف المحادثة لـ Alz-Bot.

معلومات

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

يتم تمكين قاعدة المعرفة تلقائيًا. قاعدة المعرفة هي ميزة تمنح الدردشة الخاصة بك القدرة على البحث داخل الوثائق (مثل ملف PDF) أو صفحات الويب للعثور على إجابة. لإنشاء أول قاعدة معرفة خاصة بك، انتقل إلى cloud.google.com/dialogflow/docs/knowledge-connectors

استجابة Dialogflow

يتم حفظ استجابة JSON الكاملة من Dialogflow تلقائيًا في قاعدة البيانات، sb_messages، في العمود payload.

مرفقات المستخدم

يتم إرسال مرفقات المستخدم إلى Dialogflow عن طريق إلحاق المرفقات بتفاصيل الرسالة في الشكل التالي:

[name:file-name.ext,url:URL,extension:file-extension]

مثال:

        [name:archive.zip,url:https://alz-bot.com/archive.zip,extension:zip]
        [name:license.pdf,url:https://alz-bot.com/license.pdf,extension:pdf]

مرفقات الروبوت

للسماح للروبوت بإرسال المرفقات، أضف استجابة Custom Payload وأدخل هذا الكود JSON:

        { "attachments": [["name", "YOUR-LINK"], ["name", "YOUR-LINK"], ["name", "YOUR-LINK"]]}

استبدل "name" بالاسم الفعلي للمرفق للعرض واستبدل "YOUR-LINK" بعنوان URL الفعلي للملف. يتم عرض مرفقات الصور تلقائيًا كصور.

رسائل الغنية

للسماح لـ Dialogflow بإرسال رسائل غنية، قم ببساطة بإدخال رمز الرسالة الغنية في TEXT RESPONSE أو أضف استجابة Custom Payload جديدة وأدخل هذا الكود JSON: { "rich-message": "shortcode" }. استبدل "shortcode" برمز الرسالة الغنية، ولكي يكون لديك رمز JSON صالح يجب أن تقوم بتبديل جميع الرموز " ب \". للحصول على رموز قصيرة أو لمعرفة كيفية إنشاء رسالة غنية، يرجى النقر هنا.

استجابة رسالة غنية

عندما يتفاعل المستخدم مع رسائل غنية عبر دردشة Alz-Bot (على سبيل المثال، عن طريق النقر على زر)، يتم إرسال استجابة رسالة الغنية إلى Dialogflow في الشكل التالي: ID|response، أو ID إذا كان نوع رسالة الغنية هو التسجيل، البريد الإلكتروني، المتابعة، في هذه الحالة يتم إرسال قيم رسالة الغنية كمصفوفة في مفتاح queryParams['payload']. ID هو معرف رسالة الغنية، والذي يمكن تعيينه عن طريق إضافة السمة id="YOUR-ID" إلى رمز الاختصار. إذا لم يتم تعيين أي معرف، سيتم استخدام معرف عشوائي بدلاً من ذلك. response هو إدخال أو اختيار المستخدم. لمنع Dialogflow من الرد على رسالة غنية، أضف قاعدة جديدة بـ ID كما هو الحال مع التعبير الوحيد للمستخدم وبدون رد.

إذا كان المستخدم يتفاعل مع الروبوت عبر تطبيق الرسائل (على سبيل المثال، WhatsApp)، فإن استجابة رسالة الغنية لا تحتوي على معرف رسالة الغنية ويجب استخدام السياقات في Dialogflow للسماح لـ Dialogflow بفهم أي النية لتنشيطها لاستجابة رسالة غنية محددة.

الحصول على استجابة رسالة غنية للتسجيل، البريد الإلكتروني، المتابعة

من القائمة اليسرى > الوفاء، قم بتمكين Webhooks، حيث يكفي إدخال عنوان URL الملف الذي سيستقبل بيانات الويب هذه من Dialogflow.
أنشئ نية باستخدام معرف رسالة الغنية، على سبيل المثال، لنموذج التسجيل، قم بإدخال registration، لنموذج المتابعة أدخل sb-follow-up-form، لنماذج البريد الإلكتروني أدخل email.
قم بتمكين الوفاء للنية.
انتهيت! سيتلقى ملف عنوان URL الويب تفاصيل مستخدم رسالة الغنية من Alz-Bot.

تحسين الروبوت في Dialogflow

إذا كان الروبوت يرد بالأنماط الخاطئة، انتقل إلى Dialogflow Console > chatbot Settings > ML Settings واضبط ML CLASSIFICATION THRESHOLD إلى رقم أكبر، مثل 0.6.

استطلاع تسلسلي

لإنشاء استطلاع تسلسلي مثل تلك التي في العرض التوضيحي، يجب عليك إدخال Rich message ID في Training phrases، تحقق من المثال أدناه.

انتقل إلى Dialogflow وأنشئ نية جديدة. في منطقة Training phrases، أدخل تعبير المستخدم survey example. في منطقة Responses، أدخل الكود [buttons id="test-survey-1" options="Software,Physical products,Services" title="What is your type of business?" message="Please choose the type that best suits your company." success="Your company type is "]
أنشئ نية جديدة. أدخل تعبير المستخدم test-survey-1 وكاستجابة أدخل [select id="seq-survey-2" options="Priority post, Express courier, International courier" title="Shipping methods" message="Choose the preferred shipping method of your customers" success="Your customers preferred shipping method is"]
قم بإنشاء نية جديدة. أدخل تعبير المستخدم test-survey-2 وكرد قم بإدخال شكرًا لك على إكمال استبياننا!.
انتهيت.

تدريب البوت

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

ربط الأقسام

احصل على معرفات الأقسام من الإعدادات > متفرقات > الأقسام.
احصل على معرفات المشروع من منطقة إعدادات Dialogflow لوكلائك.

مزيد من المعلومات

يمكنك تنشيط البوت عبر واجهة برمجة التطبيقات (API) بإرسال رسالة بدون نص وبيانات تحميل { "event": "activate-bot" }.
اللغة الصينية المعتمدة هي الصينية المبسطة فقط. يرجى استخدام لغة Dialogflow الصينية المبسطة (zh-CN) فقط. ستكون رموز اللغات zh-HK و zh-TW غير فعالة.
يتم إرسال التفاصيل التالية إلى Dialogflow في معلمة queryParams عند اكتشاف نية: conversation_id، user_id.
لتشغيل حدث الترحيب في Dialogflow CX، قم بإنشاء معالج الحدث وأدخل Welcome كـ Custom Event.
تتم مزامنة مقالات Alz-Bot تلقائيًا مع قاعدة المعرفة في Dialogflow.
استخدم المتغير JS SB_DIALOGFLOW_AGENT = "AGENT ID" لتغيير وكيل Dialogflow الافتراضي، قم بتبديل "AGENT ID" بـ معرف المشروع.

واتساب

الإعدادات أدناه تتعلق بتطبيق WhatsApp.

التثبيت

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

إعداد API السحابية لواتساب

أنشئ حسابًا للمطور وتطبيق Facebook جديد كما هو موضح في https://developers.facebook.com/docs/whatsapp/cloud-api/get-started#set-up-developer-assets.
في Alz-Bot > الإعدادات > واتساب > Cloud API > Secret key، أدخل سلسلة عشوائية ثم انتقل إلى https://developers.facebook.com/apps وحدد تطبيقك. انقر على إضافة منتج وأضف واتساب، ثم انتقل إلى واتساب > التكوين وأدخل عنوان Webhook URL الذي حصلت عليه من Alz-Bot > الإعدادات > واتساب > Cloud API > تكوين عنوان URL. في Verify token، أدخل المفتاح السري الذي أدخلته مسبقًا في Alz-Bot. انقر فوق Verify واحفظ، انقر على Webhook fields > Manage، قم بتمكين حقول Webhook التالية: messages.
في Alz-Bot > الإعدادات > واتساب > Cloud API > Token، أدخل رمز الاختبار للاختبار، واتبع التعليمات أدناه للحصول على رمز الوصول الدائم.
- قم بزيارة https://business.facebook.com وانتقل إلى Left menu > Settings > More system settings، ثم انتقل إلى Users > System Users لعرض مستخدم النظام الذي أنشأته، أو قم بإنشاء مستخدم جديد. انقر فوق ذلك المستخدم وحدد Add Assets. يجب أن يكون مستخدم النظام مسؤولًا.
- انقر على Left menu > Apps وتحت Select Assets، اختر تطبيقك. قم بتمكين Develop App لذلك التطبيق واحفظ.
- انقر على Generate Token وحدد تطبيقك، قم بتمكين الصلاحيات التالية: whatsapp_business_management، whatsapp_business_messaging، business_management. انقر على Generate Token واحفظ. الصق الرمز في Alz-Bot > الإعدادات > واتساب > Cloud API > Token.
للحصول على هوية الهاتف، أدخل https://developers.facebook.com، حدد تطبيقك وانتقل إلى Left menu > WhatsApp > Getting started.
يمكنك اختبار التكامل من https://developers.facebook.com، حدد تطبيقك وانتقل إلى Left menu > WhatsApp > Getting started.

إعداد حساب 360dialog

انتقل إلى https://www.360dialog.com/ وأنشئ حسابًا جديدًا.

أدخل إلى لوحة التحكم الخاصة بك ومن القائمة اليسرى > حسابات واتساب قم بإنشاء مفتاح API وانسخه والصقه في Alz-Bot > الإعدادات > واتساب > إعدادات 360dialog.
انقر على Alz-Bot > الإعدادات > واتساب > إعدادات 360dialog > مزامنة الآن.
تم! يجب أن يبدأ Alz-Bot في استقبال رسائل واتساب المرسلة إلى رقمك، ويمكنك الرد على تلك الرسائل من خلال Alz-Bot.
يرجى ملاحظة أنه يمكنك أيضًا استخدام حساب الاختبار المجاني لإجراء اختبارات، لمزيد من التفاصيل انظر هنا. يحتوي حساب الاختبار على قيود وقد لا تعمل بعض الميزات، مثل مرفقات الوسائط.

إعداد حساب Twilio

انتقل إلى https://www.twilio.com وأنشئ حسابًا جديدًا.
قم بتحقق رقم هاتفك.
أكمل النموذج واختر واتساب، تنبيهات وإشعارات، بدون كود، تكاملات الطرف الثالث.
انسخ معرف الحساب (ACCOUNT SID) و رمز المصادقة (AUTH TOKEN) من لوحة التحكم في Twilio والصقهما في Alz-Bot > الإعدادات > واتساب > إعدادات Twilio، واحفظ التغييرات.
ستقوم الآن بإعداد حساب اختبار مجاني لتشغيل بعض الاختبارات والتأكد من أن التكامل يعمل مع Alz-Bot. انقر من القائمة اليسرى على الرسائل > الإعدادات > إعدادات الحوض الرملي لواتساب، وأدخل إلى عندما يأتي رسالة و عنوان URL للرد على الحالة عنوان URL لـ Alz-Bot، احصل عليه من Alz-Bot > الإعدادات > واتساب > إعدادات Twilio > الحصول على عنوان URL للتكوين. تذكر أن الـ localhost لن يعمل، تحتاج إلى عنوان URL عام وخادم حي.
انقر من القائمة اليسرى على الرسائل > جربها > إرسال رسالة واتساب. اتبع التعليمات وأرسل الرسالة مع الرمز إلى رقم واتساب المقدم. انقر على الأزرار التالية حتى يتم الانتهاء من التكوين.
تم! يجب أن يبدأ Alz-Bot في استقبال رسائل واتساب المرسلة إلى حساب الحوض الرملي، ويمكنك الرد على تلك الرسائل من Alz-Bot.
لاستخدام تكامل واتساب بشكل عام مع عملائك، تحتاج إلى تحديث حسابك وتمكين الفوترة، يمكنك القيام بذلك هنا. بعد ذلك، ستحتاج إلى شراء رقم Twilio، والذي سيكون رقم هاتف حساب واتساب الخاص بك الرسمي. المزيد من التفاصيل هنا. لا يمكنك استخدام رقم هاتف حساب واتساب الخاص بك الحالي، يجب أن تستخدم رقم Twilio. المزيد من التفاصيل هنا.

رسائل الاستبدال

وفقًا لـ سياسة الأعمال في واتساب، لا يمكنك إرسال رسائل تسويقية واستجلاب للمستخدمين نشطين من جانبك. يجب على المستخدمين نشطين الوصول إليك أولاً. لديك 24 ساعة من وقت إرسال المستخدم لرسالة واتساب للرد على الرسالة. إذا كنت ترغب في إرسال رسالة بعد 24 ساعة من آخر رسالة للمستخدم، يجب عليك استخدام رسالة النص البديل أو رسالة القالب لواتساب.

رسالة النص البديل

لتمكين رسالة النص البديل، يجب عليك إعداد الرسائل النصية في الإعدادات > الإشعارات > إشعارات الرسائل النصية.
المزيد من التفاصيل هنا

رسائل القوالب لواتساب

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

API السحابية لواتساب

للحصول على اسم القالب وإدارة القوالب، قم بزيارة https://business.facebook.com وانتقل إلى القائمة اليسرى > الإعدادات > إعدادات النظام الإضافية، ثم انتقل إلى الحسابات > حسابات واتساب > الإعدادات وانقر على مدير واتساب.
في لغات القالب، أدخل جميع رموز اللغات المدعومة بواسطة القالب الخاص بك، مفصولة بفواصل. إذا لم يتم العثور على لغة، يتم استخدام رمز اللغة الأول. يمكن العثور على قائمة رموز اللغات هنا (انسخ فقط رمز اللغة، على سبيل المثال، it، es، en_US).
في معلمات الرأس و معلمات الجسم، أدخل حقول الدمج المدعومة مفصولة بفواصل، على سبيل المثال: {recipient_name}، {conversation_url_parameter}. يجب أن يتطابق عدد الحقول المدخلة هنا مع عدد حقول القالب. استخدم هذه الميزة إذا كان قالبك يستخدم قيمًا ديناميكية. الترتيب مهم، حيث يتم استخدام حقل الدمج الأول كمعلمة أولى للقالب.

Twilio

أدخل رمز القالب في Alz-Bot > الإعدادات > WhatsApp > القالب الاحتياطي إذا كنت تستخدم رمل Twilio للاختبار، يمكنك استخدام قوالب معتمدة مسبقًا مثل Your {{1}} code is {{2}}, يمكنك استبدال المتغيرات بمتغيرات Alz-Bot مثل {recipient_name}، على سبيل المثال، Your {recipient_name} code is {recipient_email}. المزيد من التفاصيل هنا.

360dialog

احصل على قيمة النطاق من القائمة اليسرى > حسابات WhatsApp > تفاصيل.
احصل على اسم القالب و لغة القالب الافتراضية من منطقة القوالب الخاصة بك في 360dialog.
في المعلمات المخصصة، أدخل حقول الدمج المدعومة مفصولة بفواصل، مثال: {recipient_name}، {conversation_url_parameter}. استخدم هذه الميزة إذا كان قالبك يستخدم قيمًا ديناميكية. الترتيب مهم، حيث يتم استخدام حقل الدمج الأول كقيمة ديناميكية أولى للقالب.
سيحاول Alz-Bot استخدام القالب بنفس لغة المستخدم، إذا لم يكن متاحًا، سيتم استخدام القالب باللغة الافتراضية. اللغات التالية للقوالب غير متوافقة: en_GB (استخدم en_US)، pt_PT (استخدم pt_BR)، zh_HK و zh_TW (استخدم zh_CN)، es_AR و es_MX (استخدم es_ES).

متجر WhatsApp

لعرض منتجات متجرك، استخدم حقول الدمج أدناه.

حقل الدمج	الوصف
{catalog id="123" product_id="123" body="" footer=""}	عرض منتج واحد. استبدل id بمعرف الفهرس و product_id بمعرف المنتج. تكون السمات body و footer اختيارية.
{catalog id="123" product_id_1_1="123" product_id_1_2="123" product_id_2_1="123" section_1="" section_2="" header="" body="" footer=""}	عرض عدة منتجات. استبدل id بمعرف الفهرس. أضف منتجات عن طريق تجميعها في أقسام، عبر السمات product_id_[A]_[B]، استبدل [A] بفهرس القسم، بدءًا من 1، واستبدل [B] بفهرس المنتج، بدءًا من 1 لكل قسم. يجب أن تضيف أيضًا السمة section_[A]="" لكل قسم، استبدل [A] بفهرس القسم. تكون السمات header و body إلزامية، و footer اختيارية.

حقل الدمج

الوصف

{catalog id="123" product_id="123" body="" footer=""}

عرض منتج واحد. استبدل id بمعرف الفهرس و product_id بمعرف المنتج. تكون السمات body و footer اختيارية.

{catalog id="123" product_id_1_1="123" product_id_1_2="123" product_id_2_1="123" section_1="" section_2="" header="" body="" footer=""}

عرض عدة منتجات. استبدل id بمعرف الفهرس. أضف منتجات عن طريق تجميعها في أقسام، عبر السمات product_id_[A]_[B]، استبدل [A] بفهرس القسم، بدءًا من 1، واستبدل [B] بفهرس المنتج، بدءًا من 1 لكل قسم. يجب أن تضيف أيضًا السمة section_[A]="" لكل قسم، استبدل [A] بفهرس القسم. تكون السمات header و body إلزامية، و footer اختيارية.

عندما يرسل المستخدم الطلب، يتم إرسال معلومات الطلب إلى عنوان URL المحدد في الإعدادات > WhatsApp > سلك الطلب. يجب على الصفحة في ذلك العنوان تجهيز الطلب وإرسال رسالة إلى المستخدم عبر وظيفة واجهة برمجة التطبيقات الخاصة بـ PHP sb_whatsapp_send_message().
لربط المتجر بـ WooCommerce انقر هنا.

مزيد من المعلومات

إذا لم تتلقى رسائل WhatsApp، تأكد من أنك لا تخصص محادثات WhatsApp إلى قسم وأن رقم WhatsApp المستخدم للاختبار ليس رقم هاتف لمسؤول أو وكيل Alz-Bot. تأكد أيضًا من إعداد سلك الويب هاتف WhatsApp بشكل صحيح.
إذا لم تتمكن من إرسال رسائل، يجب أن يظهر خطأ في منطقة الإدارة عند محاولتك إرسال رسالة إلى المستخدم.
لا يمكننا توفير الدعم لتكوين Twilio أو 360dialog، بما في ذلك جميع المشكلات المتعلقة.
لا يمكننا توفير الدعم في الحصول على حساب WhatsApp الخاص بك أو قالب رسالة WhatsApp الموافق عليه.
المحادثات والرسائل على WhatsApp متوافقة مع التوجيه والانتظار.
إذا كنت تقوم بالاختبار مع الرمل وبعد 72 ساعة لم يعد بإمكانك إرسال رسائل إلى رقم هاتفك، يجب أن تقوم بربط رقم هاتفك مرة أخرى برملك.
إذا قمت بإرسال رسائل غنية برقاقات أو أزرار أو رسائل تحتوي على أكثر من 3 خيارات، يمكنك استخدام سمة الاختصار whatsapp="Your menu text" لتحديد نص رسالة WhatsApp.

MESSENGER

Messenger

الإعدادات أدناه تتعلق بتطبيق Messenger.

التثبيت

من الإعدادات > التطبيقات، انقر فوق Messenger وأدخل مفتاح الترخيص لتثبيت وتنشيط التطبيق. إذا كنت تستخدم النسخة السحابية، فإن التطبيق نشط بالفعل.
بمجرد تثبيت التطبيق، انتقل إلى الإعدادات > Messenger وانقر بدء المزامنة.
أكمل المزامنة باختيار صفحة Facebook وأدخل المعلومات المرجعية في الإعدادات > Messenger > صفحات Facebook.
انتهيت. ستظهر جميع الرسائل المرسلة إلى صفحات Facebook وحسابات Instagram التي اخترتها في منطقة الدردشة الإدارية لـ Alz-Bot.

Instagram

لربط Instagram بصفحتك على Facebook و Alz-Bot، اتبع الخطوات التالية.

ادخل إلى منطقة الإعدادات في صفحتك على Facebook وانقر على Left Menu > Instagram (https://www.facebook.com/YOUR-PAGE-SLUG/settings/).
انقر على Connect account وأكمل الإعداد.
قم بمزامنة Messenger مع Alz-Bot مرة أخرى وانتهيت.

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

إذا لم تتلق رسائل Instagram، تأكد من تمكين Settings > Privacy > Messages > Connected tools - Allow access من تطبيق Instagram الخاص بك. تأكد أيضًا من أن حساب Instagram الخاص بك ليس مُعدًا كحساب احترافي، يجب أن يكون حساب تجاري.
يحصل كل مستخدم Alz-Bot على محادثة واحدة فقط على Facebook وInstagram.
تُحول رسائل Alz-Bot الغنية تلقائياً إلى رسائل Facebook الغنية عند الإمكان، وقد يتم إزالة أو تغيير جزء من الرسالة الغنية.
سترسل فقط الرسائل الخاصة على Facebook إلى صندوق الوارد الخاص بفريقك. إذا قام شخص بنشر رسالة على حائطك على Facebook، فلن تظهر في صندوق الوارد الخاص بك.
عندما يرسل شخص ما رسالة إلى صفحة شركتك على Facebook أو حساب Instagram الخاص بك، سيتم تعيينه كعميل محتمل في Alz-Bot. ستكون قادرًا فقط على رؤية اسم العميل وصورة ملفه الشخصي على Facebook أو Instagram.
المحادثات والرسائل على Messenger متوافقة مع التوجيه والانتظار في الطابور.
يتم دعم Dialogflow لـ Facebook وInstagram، بما في ذلك الميزات التالية: Human takeover، رسائل Alz-Bot الغنية، اكتشاف اللغة ومحول لغة الدردشة.
يتم دعم رسالة المتابعة، ولكن يتم تجاهل إعداد التأخير، ويتم إرسال الرسالة فورًا.
تتم دعم رسالة الخدمة غير المتصلة، ولكن لا يتم إرسال الجدول الزمني.
يمكن مزامنة حساب Facebook واحد فقط، ولربط صفحات من حسابات Facebook متعددة، يجب أن يكون الحساب المتزامن في Alz-Bot هو مسؤول لجميع صفحات Facebook في الحسابات الأخرى على Facebook.

TWITTER

تويتر

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

التثبيت

قم بالتسجيل في https://developer.twitter.com. تأكد من التحقق من رقم هاتفك في https://twitter.com/settings/phone أو سيفشل التسجيل.
أنشئ تطبيقك الأول عن طريق إدخال اسم التطبيق وانقر على Get keys، انسخ API Key (Consumer key) و API Key Secret (Consumer secret) وألصقهم في Alz-Bot > Settings > Twitter.
اطلب Elevated access من https://developer.twitter.com/en/portal/products/elevated. انقر على Apply for Elevated وأكمل النموذج كالتالي: في المنطقة الأولى In your words وفي Will your app use Tweet, Retweet, Like, Follow, or Direct Message functionality? أدخل I need access to the Account Activity API to start receiving Twitter Direct Messages to my chat software(Alz-Bot ) and to reply to them directly from Alz-Bot , details at https://alz-bot.com/twitter. قم بتعطيل جميع الحقول الأخرى بالنقر على No: Are you planning to analyze Twitter data?, Do you plan to display Tweets or aggregate data about Twitter content outside Twitter?, Will your product, service, or analysis make Twitter content or derived information available to a government entity?
انتظر بضعة أيام حتى يقوم تويتر بمراجعة وموافقة Elevated access، ستتلقى رسالة بريد إلكتروني من تويتر.
بمجرد الحصول على Elevated access، ادخل لوحة تحكم المطورين (https://developer.twitter.com/en/portal/dashboard) ومن القائمة اليسرى انقر على Products > Premium > Dev environments وتحت Account Activity API / Sandbox انقر على Set up dev environment، في Dev environment label أدخل sb أو نفس القيمة التي تم إدخالها في Settings > Twitter > Synchronization > Dev environment label.
ادخل منطقة Settings الخاصة بتطبيقك من Left menu > Projects & Apps > Your project > Your app وتحت User authentication settings انقر على Set up وفعل OAuth 1.0a. في App permissions، حدد Read and write and Direct message، في Callback URI / Redirect URL أدخل الرابط الذي تحصل عليه من Alz-Bot > Settings > Twitter > Get callback URL، في Website URL أدخل رابط موقع الويب الخاص بك.
انتقل إلى منطقة Keys and tokens الخاصة بتطبيقك من Left menu > Projects & Apps > Your project > Your app > Keys and tokens وتحت Authentication Tokens أنشئ Access Token and Secret، انسخ وألصقهم في Alz-Bot > Settings > Twitter.
أدخل اسم مستخدم ملفك الشخصي على Twitter في Alz-Bot > Settings > Twitter > Your username. احصل عليه من صفحة ملفك الشخصي على Twitter، انسخ الاسم الذي يبدأ بـ @ أو جزء الرابط الذي يحتوي على اسم المستخدم الخاص بك. مثال: https://twitter.com/alz-bot1.
احفظ إعدادات Alz-Bot وانقر على الزر Alz-Bot > Settings > Twitter > Subscribe وانتهيت. ستظهر جميع الرسائل المرسلة إلى حساب Twitter الخاص بك في Alz-Bot.

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

إذا كنت تتلقى رسائل مكررة، قد يكون حساب Twitter الذي تستخدمه للفحص هو نفسه الذي قمت بمزامنته. جرب إرسال رسالة من حساب Twitter آخر.
استخدم نطاقًا حيًا، لا يتم دعم Localhost.
عند استلام رسالة من مستخدم Twitter، يمكنك إرسال ما يصل إلى 5 رسائل في الرد خلال نافذة زمنية تستمر 24 ساعة. لا يمكن إرسال رسائل بعد مضي 24 ساعة على استلام رسالة Twitter.
يمكنك إرسال حد أقصى 3 أو 4 مرفقات اعتمادًا على نوع الوسائط.
لا تدعم الرسائل الغنية التالية في Alz-Bot: معرض الصور، المعرض، البطاقة.

GOOGLE BUSINESS MESSAGES

رسائل Google للأعمال

الإعدادات أدناه تتعلق بتطبيق Google Business Messages.

التثبيت

في Alz-Bot > الإعدادات > رسائل الأعمال > تزامن > رمز العميل، أدخل سلسلة عشوائية واحفظها.
افتح وحدة تحكم مطوّري الاتصالات التجارية (https://business-communications.cloud.google.com) وقم بتسجيل الدخول باستخدام حساب Google الخاص برسائل الأعمال الخاصة بك.
انقر فوق إعدادات حساب الشريك في الأعلى.
قم بتكوين Webhook عن طريق إدخال رابط Webhook و رمز العميل واحفظ التغييرات، واحصل على القيم من Alz-Bot > الإعدادات > رسائل الأعمال > تزامن.
ادخل مرة أخرى إلى وحدة تحكم مطوّري الاتصالات التجارية (https://business-communications.cloud.google.com) وافتح حساب الشريك الخاص بك.
انقر على حساب الخدمة من القائمة اليسارية وأنشئ مفتاحًا جديدًا، قم بتنزيل المفتاح وافتحه باستخدام محرر نص مثل Notepad، انسخ private_key و client_email والصق القيم في Alz-Bot > الإعدادات > رسائل الأعمال > تزامن.
انتهيت! لاختبار وكيلك، قم بزيارة https://business-communications.cloud.google.com/console، انقر فوق علامتك التجارية لدخول منطقة نظرة عامة الخاصة بك، وتحت معلومات الوكيل > روابط اختبار الوكيل، انقر على الزر المناسب لجهازك المحمول وافتح الرابط من جهازك المحمول.

مزيد من المعلومات

يجب أن تحتوي قيم رسائل الغنى مثل الرقائق والأزرار واختيار الرسائل على حد أقصى من 25 حرفًا، ويُسمح بأقصى 13 قيمة.
يجب أن تكون صورة الصورة الشخصية صورة JPG بحجم 1024x1024 بكسل مع حجم أقصى قدره 50 كيلوبايت.

تيليغرام

الإعدادات أدناه تتعلق بتطبيق تيليغرام.

التثبيت

انتقل إلى منطقة الإدارة في Alz-Bot ، ثم انتقل إلى الإعدادات > التطبيقات > تيليغرام، وأدخل رمز الشراء لـ Techno Viz لتثبيت وتفعيل التطبيق. إذا كان لديك النسخة السحابية، فإن التطبيق مفعل بالفعل.
اذهب إلى هنا: https://t.me/botfather.
إذا قمت بإنشاء بوت تيليغرام في الماضي، اكتب الأمر /mybots وافتح بوتك، ثم انقر فوق API token.
إذا لم تقم بإنشاء بوت تيليغرام من قبل، اكتب الأمر /newbot لإنشاء بوت جديد. سيطلب منك BotFather إدخال اسم واسم مستخدم، أدخلهما وقم بإنشاء رمز المصادقة. المزيد من التفاصيل على https://core.telegram.org/bots.
انسخ الرمز والصقه في Alz-Bot > تيليغرام > الرمز، ثم انقر على تزامن الآن. يجب أن يكون موقع الويب الخاص بك يستخدم HTTPS (شهادة SSL)، HTTP غير مدعوم.
أنت قد انتهيت. ستظهر جميع الرسائل المرسلة إلى بوت تيليغرام الخاص بك في منطقة الإدارة للدردشة في Alz-Bot.

مزيد من المعلومات

تتم تحويل رسائل الغنى في Alz-Bot تلقائيًا إلى رسائل غنية في تيليغرام عند الإمكان، وإلا فإنها تُزال من الرسالة.
تتوافق محادثات تيليغرام والرسائل مع التوجيه والطابور.
يتم دعم Dialogflow، بما في ذلك الميزات التالية: استيلاء بشري، رسائل Alz-Bot الغنية، كشف اللغة ومفتاح تبديل لغة الدردشة.
يتم دعم رسالة المتابعة، ولكن إعداد التأخير يتم تجاهله، وتُرسل الرسالة فورًا.
يتم دعم رسالة الخطوة التالية، ولكن لا يتم إرسال الجدول الزمني.

فايبر

الإعدادات أدناه تتعلق بتطبيق فايبر.

التثبيت

من الإعدادات > التطبيقات، انقر فوق فايبر وأدخل مفتاح الترخيص الخاص بك لتثبيت وتفعيل التطبيق. إذا كان لديك النسخة السحابية، فإن التطبيق مفعل بالفعل.
قم بإنشاء البوت على https://partners.viber.com/account/create-bot-account.
انسخ الرمز والصقه في Alz-Bot > فايبر > الرمز، ثم انقر على تزامن الآن. يجب أن يكون موقع الويب الخاص بك يستخدم HTTPS (شهادة SSL)، HTTP غير مدعوم.
أنت قد انتهيت. ستظهر جميع الرسائل المرسلة إلى بوت Viber الخاص بك في منطقة الإدارة للدردشة في Alz-Bot.

مزيد من المعلومات

تتم تحويل رسائل الغنى في Alz-Bot تلقائيًا إلى رسائل غنية في Viber عند الإمكان، وإلا فإنها تُزال من الرسالة.
تتوافق محادثات Viber والرسائل مع التوجيه والطابور.
يتم دعم Dialogflow، بما في ذلك الميزات التالية: استيلاء بشري، رسائل Alz-Bot الغنية، كشف اللغة ومفتاح تبديل لغة الدردشة.
يتم دعم رسالة المتابعة، ولكن إعداد التأخير يتم تجاهله، وتُرسل الرسالة فورًا.
يتم دعم رسالة الخطوة التالية، ولكن لا يتم إرسال الجدول الزمني.

سلاك

Slack

الإعدادات أدناه تتعلق بتطبيق Slack.

التزامن

لمزامنة Slack، انقر على زر بدء التزامن في الإعدادات > Slack واتبع التعليمات.

هل تواجه مشاكل؟

قد لا يكون التزامن مع Slack ناجحًا لعدة أسباب؛ فيما يلي أكثرها شيوعًا:

وصف المشكلة	الحل
يمكنك استقبال رسائل على Slack، ولكنك لا تستطيع إرسال رسائل من Slack إلى Alz-Bot	انتقل إلى /alz-bot/apps/slack/post.php من متصفحك. إذا تلقيت خطأ 403 - ممنوع ، فيجب عليك الاتصال بمزود خدمة الاستضافة الخاص بك وطلب منهم ضبط أذونات الملف الصحيحة لهذا الملف و/أو إضافة دور جدار الحماية لمنع جدار الحماية من حظر الملف. يجب أن يكون مسموحًا بتنفيذه بحرية دون أي قيود. أيضًا، في إعدادات مساحة العمل > الأذونات يجب أن تسمح لأي شخص بإنشاء قنوات عامة. إذا كان لديك مشكلات إضافية يرجى الاتصال بفريق دعم Slack على https://api.slack.com/support.
تعذرت مزامنة Slack	تحقق مرتين مما إذا كنت قد اخترت قناة عامة عند محاولة مزامنة Slack. إذا لم تفعل ذلك، جرب مزامنة Slack مرة أخرى، هذه المرة اختيار قناة عامة بدلاً من ذلك. القناة العامة هي خيار جيد.

وصف المشكلة

الحل

يمكنك استقبال رسائل على Slack، ولكنك لا تستطيع إرسال رسائل من Slack إلى Alz-Bot

انتقل إلى /alz-bot/apps/slack/post.php من متصفحك. إذا تلقيت خطأ 403 - ممنوع ، فيجب عليك الاتصال بمزود خدمة الاستضافة الخاص بك وطلب منهم ضبط أذونات الملف الصحيحة لهذا الملف و/أو إضافة دور جدار الحماية لمنع جدار الحماية من حظر الملف. يجب أن يكون مسموحًا بتنفيذه بحرية دون أي قيود. أيضًا، في إعدادات مساحة العمل > الأذونات يجب أن تسمح لأي شخص بإنشاء قنوات عامة. إذا كان لديك مشكلات إضافية يرجى الاتصال بفريق دعم Slack على https://api.slack.com/support.

تعذرت مزامنة Slack

تحقق مرتين مما إذا كنت قد اخترت قناة عامة عند محاولة مزامنة Slack. إذا لم تفعل ذلك، جرب مزامنة Slack مرة أخرى، هذه المرة اختيار قناة عامة بدلاً من ذلك. القناة العامة هي خيار جيد.

أرشفة القنوات يدويًا

لأرشفة قناة في Slack، اتبع هذه الخطوات:

افتح القناة في Slack التي تريد أرشفتها.
في أعلى اليمين انقر على أيقونة العتاد وحدد خيارات إضافية.
انقر فوق أيقونة المعلومات في أعلى اليمين من الشاشة، ثم انقر فوق أيقونة إضافية ، ومن ثم انقر فوق خيارات إضافية.... انقر فوق أرشفة هذه القناة.

ربط الأقسام

احصل على معرفات الأقسام من الإعدادات > متفرقات > الأقسام.
احصل على معرفات القنوات عن طريق النقر على زر الحصول على معرفات القنوات.

حقول المستخدم

يتيح لك الإعداد الإعدادات > Slack > حقول المستخدم اختيار التفاصيل التي ترغب في تضمينها في الرسالة المرسلة إلى القناة الرئيسية عندما يرسل مستخدم جديد أول رسالة. يمكنك تضمين سبيكة تفاصيل المستخدم الخاصة بك أو سبيكات الأقسام التالية: browser, browser_language, location, email, user_type, token, creation_time, country_code, current_url, os, city, address, postal_code, phone, birthdate, company, timezone, website. الافتراضي: email, browser, browser_language, location.

معلومات

عندما يرسل مستخدم جديد أول رسالة، يتم إرسال رسالة Slack مع تفاصيل المستخدم وزر للانضمام إلى قناة المستخدم إلى القناة الرئيسية التي تم تحديدها أثناء التزامن، أو إلى القناة المرتبطة بقسم المحادثة. فقط الحساب على Slack المستخدم أثناء التزامن سينضم تلقائيًا إلى قناة المستخدم، سيتعين على أعضاء Slack الآخرين الانضمام يدويًا عبر الزر.
عندما يتم تعيين الإعدادات > Slack > ربط الوكيل، إذا كانت المحادثة مخصصة لقسم، ستتلقى الرسالة فقط الوكلاء المخصصين لذلك القسم، إذا كانت المحادثة مخصصة لوكيل واحد فقط، سيتلقى ذلك الوكيل الرسالة.
Slack مجاني للاستخدام. قد تحتاج الشركات الكبيرة إلى خطة اشتراك مدفوعة، المزيد من التفاصيل هنا.
تتوافق الإشعارات الفورية مع Slack، عندما يرسل الوكلاء رسائل عبر Slack، يتم إرسال إشعارات الفورية إلى المستخدمين.
إذا كنت تستخدم Dialogflow، لن تتم استلام رسائل في Slack إذا كان الروبوت يعرف الجواب. بمجرد تفعيل السيطرة البشرية، يتم إرسال جميع رسائل المحادثة إلى Slack.
تطبيق Slack متوافق مع إرسال البريد الإلكتروني وتطبيقات المراسلة.
لا يتم دعم حذف أو مغادرة القناة، يتم دعم أرشفة القناة فقط.
عند أرشفة محادثة في Alz-Bot، يتم أرشفة القناة المرتبطة في Slack أيضًا.
عند الرد عبر Slack على مستخدم، إذا تم إخطار المستخدم بواسطة البريد الإلكتروني أو رسالة نصية، يتم إرسال رسالة Slack لإعلامك.
استخدم أمر Slack /archive لأرشفة محادثة من Slack.

PERFEX CRM

Perfex

الإعدادات أدناه تتعلق بتطبيق Perfex.

التثبيت

يتطلب التثبيت خطوتين:

من الإعدادات > التطبيقات، انقر على Perfex وأدخل رمز الشراء الخاص بك من Techno Viz لتثبيت وتنشيط التطبيق. بمجرد تثبيت التطبيق، انتقل إلى الإعدادات > Perfex وأدخل معلومات قاعدة البيانات وعنوان URL Perfex. يمكنك الحصول على المعلومات من ملف application/config/app-config.php في مجلد تثبيت Perfex الخاص بك. إذا كنت لا تعرف بادئة Perfex، اتركها فارغة، حيث أن البادئة الافتراضية هي tbl.
انتقل إلى منطقة الإدارة في Perfex، ثم انتقل إلى الإعدادات > الوحدات وقم بتثبيت وحدة Alz-Bot عن طريق تحميل الملف module.zip. بمجرد تثبيت الوحدة، انتقل إلى الإعدادات > Alz-Bot وأدخل عنوان URL البرنامج المساعد Alz-Bot . إذا كنت تستخدم نسخة ورد بريس، يجب أن يكون عنوان URL كما يلي: https://example.com/wp-content/plugins/alz-bot/alz-bot.

لعرض Alz-Bot داخل منطقة الإدارة Perfex، يجب أن يكون Alz-Bot مثبتًا في نفس النطاق ونفس نظام الملفات لتثبيت Perfex.

إذا كانت لديك مشاكل، أو إذا قمت بتغيير تفاصيل قاعدة بيانات Perfex، تأكد من أن ملف alz-bot/config.php يستخدم تفاصيل قاعدة البيانات الصحيحة لـ Perfex. لن تقوم بتحديث التفاصيل في Alz-Bot بتحديث التفاصيل في ملف config.php.

Zendesk

الإعدادات أدناه تتعلق بتطبيق Zendesk.

التثبيت

احصل على النطاق من URL منطقة الإدارة Zendesk الخاص بك، انسخ الجزء الأول من الرابط: https://domain.zendesk.com/. على سبيل المثال، يكون النطاق لـ https://alz-bot.zendesk.com/agent/get-started/ticketing-system/ticketing-intro هو alz-bot.
احصل على مفتاح API من القائمة اليسرى > الإدارة > القنوات > API > الإعدادات. انقر فوق إضافة رمز API.
البريد الإلكتروني هو بريد حسابك في Zendesk.

مزيد من المعلومات

تتم مزامنة التذاكر التي تم تحويلها بواسطة Alz-Bot تلقائيًا عند إرسال رسائل جديدة واستلامها في Alz-Bot ، ويتم ربطها بمستخدم Zendesk موجود إذا كان هناك، وإلا سيتم إنشاء مستخدم Zendesk جديد.
يقوم Alz-Bot بربط مستخدمي Zendesk بمستخدمي Alz-Bot عبر البريد الإلكتروني أو رقم الهاتف.

WHMCS

الإعدادات أدناه تتعلق بتطبيق WHMCS.

التثبيت

يتطلب العملية تثبيتين، أحدهما هو إضافة WHMCS، والآخر هو تطبيق Alz-Bot .

تثبيت التطبيق

انتقل إلى منطقة الإدارة في Alz-Bot ، ثم انتقل إلى الإعدادات > التطبيقات > WHMCS، وأدخل مفتاح الترخيص لتثبيت التطبيق. بمجرد تثبيت التطبيق، انتقل إلى الإعدادات > Whmcs وأدخل معلومات قاعدة البيانات وعنوان URL WHMCS.

تثبيت إضافة WHMCS

أدخل المجلد alz-bot داخل addon.zip (قم بتنزيلها هنا) في الملف /modules/addons/ الخاص بتثبيت WHMCS الخاص بك.
انتقل إلى التكوين > إعدادات النظام > وحدات الإضافات، ابحث عن وحدة Alz-Bot وانقر على تفعيل. تفاصيل إضافية على https://docs.whmcs.com/Addon_Modules_Management#Installing_An_Addon
انقر فوق زر تكوين وأدخل عنوان URL البرنامج المساعد Alz-Bot .

كيفية التحديث

تحديث تطبيق WHMCS في Alz-Bot سهل، يمكنك تمكين التحديثات التلقائية أو تحديثه يدويًا. التفاصيل هنا. لتحديث إضافة WHMCS ستحتاج إلى تنزيل الإصدار الأحدث من الإضافة من https://alz-bot.com/works/docs/files/whmcs/addon.zip واستبدال مجلد /modules/addons/alz-bot/ في تثبيت WHMCS الخاص بك بالنسخة الجديدة التي تم تنزيلها للتو.

إذا كانت لديك مشاكل، أو إذا قمت بتغيير تفاصيل قاعدة بيانات WHMCS، تأكد من أن ملف alz-bot/config.php يستخدم تفاصيل قاعدة البيانات الصحيحة لـ WHMCS. لن تقوم بتحديث التفاصيل في Alz-Bot بتحديث التفاصيل في ملف config.php.

ULTIMATE MEMBERSHIP PRO

Ultimate Membership Pro

الإعدادات أدناه تتعلق بتطبيق Ultimate Membership Pro.

مزامنة المستخدمين

يتم مزامنة المستخدمين الجدد تلقائيًا. لمزامنة المستخدمين الحاليين يدويًا، انتقل إلى الإعدادات > ورد بريس > مزامنة المستخدمين وانقر فوق استيراد المستخدمين.

مزيد من المعلومات

لتقييد الوصول إلى خطة معينة فقط، استخدم هذا الرمز الاختصاري [ihc-hide-content ihc_mb_type="show" ihc_mb_who="4" ihc_mb_template="2"]<script id="sbinit" src="YOUR-URL/alz-bot/alz-bot/js/main.js"></script>[/ihc-hide-content] قم بتبديل 4 بمستوى المستخدم الذي تريده و YOUR-URL بعنوان ورد بريس الخاص بك في مجلد الإضافات. كما يجب عليك التحقق من الإعدادات > ورد بريس > التهيئة اليدوية.

ARMEMBER

ARMember

الإعدادات أدناه تتعلق بتطبيق ARMember.

مزامنة المستخدمين

يتم تزامن المستخدمين الجدد تلقائيًا. لمزامنة المستخدمين الحاليين يدويًا، انتقل إلى الإعدادات > ورد بريس > مزامنة المستخدمين وانقر على استيراد المستخدمين.

مزيد من المعلومات

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

Active eCommerce

الإعدادات أدناه تتعلق بتطبيق Active eCommerce.

التثبيت

العملية تتطلب تثبيتين، واحد لتطبيق Alz-Bot ، وواحد للتثبيت في Active eCommerce.

تثبيت التطبيق

انتقل إلى منطقة الإدارة في Alz-Bot ، ثم اذهب إلى الإعدادات > التطبيقات > Active eCommerce، وأدخل مفتاح الترخيص لتثبيت التطبيق. بمجرد تثبيت التطبيق، انتقل إلى الإعدادات > Active eCommerce وأدخل معلومات قاعدة البيانات، وعنوان Active eCommerce، والإعدادات الأخرى.
يمكن العثور على المفتاح السري في ملف .env الموجود في الدليل الرئيسي لـ Active eCommerce. انسخ قيمة APP_KEY.
إذا كان لديك مشكلات، تأكد من أن ملف alz-bot/config.php يستخدم تفاصيل قاعدة بيانات Active eCommerce الصحيحة.

التثبيت في Active eCommerce

قم بتحرير الملف \resources\views\frontend\inc\footer.blade.php في دليل Active eCommerce وأدخل الكود أدناه فور افتتاح تسمية <footer. قم بتبديل [YOUR-SITE] بعنوان تثبيت Alz-Bot الخاص بك.

        <script src="https://[YOUR-SITE]/js/min/jquery.min.js"></script>
        <script id="sbinit" src="https://[YOUR-SITE]/js/main.js"></script>
        @php
        $sb_code = '';
        $sb_cart = false;
        if (Auth::check() && !isAdmin()) $sb_code = 'var SB_AECOMMERCE_ACTIVE_USER = ' . Auth::user()->id . ';';
        if (isset($detailedProduct)) $sb_code .= 'var SB_DEFAULT_AGENT = "aecommerce-' . $detailedProduct->user->id . '";';
        if (auth()->user() != null) $sb_cart = \App\Models\Cart::where('user_id', Auth::user()->id)->get(); else { $temp_user_id = Session()->get('temp_user_id'); if ($temp_user_id) { $sb_cart = \App\Models\Cart::where('temp_user_id', $temp_user_id)->get(); }}
        if ($sb_cart && count($sb_cart) > 0) { $sb_code .= 'var SB_AECOMMERCE_CART = ['; foreach ($sb_cart as $key => $item) { $sb_code .= '["' . $item['product_id'] . '", "' . $item['price'] . '", "' . $item['quantity'] . '"],'; } $sb_code = substr($sb_code, 0, -1) . '];'; }
        if ($sb_code != '') echo '<script>' . $sb_code . '</script>';
        @endphp

كيفية التحديث

تحديث تطبيق Active eCommerce في Alz-Bot سهل، يمكنك تمكين التحديثات التلقائية أو التحديث يدويًا. تفاصيل هنا. إذا قمت بتحديث Active eCommerce، ستحتاج إلى إدراج الكود أعلاه مرة أخرى في الملف footer.blade.php.

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

لفرض رؤية البائعين لمحادثات المستخدمين الذين يكتبون من صفحات المنتجات الخاصة بهم، قم بتمكين الخيار الإعدادات > متنوعة > إخفاء محادثات الوكلاء الآخرين . بعد ذلك، انقر فقط على الزر الإعدادات > Active eCommerce > استيراد البائعين وانتهت! سيتم تسجيل البائعين في Alz-Bot ويمكنهم تسجيل الدخول إلى منطقة الإدارة.

يمكن للمسؤولين دائمًا رؤية محادثات جميع الوكلاء (البائعين).

Martfury

الإعدادات أدناه تتعلق بتطبيق Martfury.

التثبيت

انتقل إلى منطقة الإدارة في Alz-Bot، ثم انتقل إلى Settings > Apps > Martfury، وأدخل مفتاح الترخيص لتثبيت التطبيق.
بمجرد تثبيت التطبيق، انتقل إلى Settings > Martfury وأدخل معلومات قاعدة البيانات، Martfury URL، مفتاح السر. احصل على هذه المعلومات من ملف .env الذي يقع في الدليل الرئيسي لـ Martfury.
قم بتحديد مسار Martfury في Settings > Martfury > Martfury path. احصل على هذه المعلومات عن طريق تحميل هذا الملف في الدليل /public/ في الدليل الرئيسي لـ Martfury، بعد التحميل قم بفتحه عبر المتصفح (على سبيل المثال https://shop.com/public/path.php).
لعرض الدردشة على الموقع، أدخل رمز Alz-Bot لـ تثبيت PHP في Martfury Admin > Appearance > Custom JS > Footer JS. لا تتضمن jQuery.
إذا كنت تواجه مشكلات، تأكد من أن ملف alz-bot/config.php يستخدم تفاصيل قاعدة بيانات Martfury الصحيحة.

كيفية التحديث

تحديث تطبيق Martfury في Alz-Bot سهل، يمكنك تمكين التحديثات التلقائية أو تحديثه يدويًا. التفاصيل هنا.

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

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

تحقق من الخيارات Settings > Martfury > Private chat, Settings > Chat > Disable dashboard, Settings > Chat > Allow only one conversation.
في Settings > Martfury > Import vendors قم بتوريد جميع البائعين.
في Settings > Martfury > Private chat linking ربط كل بائع بالمتجر الصحيح. يمكنك الحصول على معرفات البائعين من Users > Agents and Admins.

LINE

الإعدادات أدناه تتعلق بتطبيق LINE.

التثبيت

قم بتسجيل الدخول على https://developers.line.biz/console/ أو قم بإنشاء حساب جديد.
قم بإنشاء موفر جديد ثم قناة واجهة برمجة التطبيقات الرسائل جديدة، واختر واجهة برمجة التطبيقات الرسائل كنوع قناة.
من منطقة Basic settings في القناة، انسخ Channel secret والصقه في Alz-Bot > Settings > Line > Synchronization > Channel secret.
من منطقة Messaging API في القناة، قم بإنشاء Channel access token (long-lived)، انسخه والصقه في Alz-Bot > Settings > Line > Synchronization > Access token.
أدخل عنوان الويب الخاص بك في Webhook URL وانقر فوق Verify. احصل على عنوان الويب هذا من Alz-Bot > Settings > Line > Synchronization > Webhook URL.
قم بتمكين Use webhook.
مسح رمز الاستجابة السريعة (QR code) باستخدام تطبيق LINE الخاص بك لبدء الكتابة إلى قناتك.
انتهيت. ستظهر جميع الرسائل المرسلة إلى حساب LINE الخاص بك في منطقة الدردشة الإدارية في Alz-Bot.

مزيد من المعلومات

لديك 7 أيام من تاريخ إرسال رسالة المستخدم النهائي من WhatsApp للرد على الرسالة.
لا يتم دعم الملصقات.
تحول رسائل Alz-Bot الغنية تلقائيًا إلى رسائل LINE الغنية عند الإمكان، وإلا يتم إزالتها من الرسالة.
تتوافق المحادثات والرسائل في LINE مع التوجيه والانتظار.
يتم دعم Dialogflow، بما في ذلك الميزات التالية: استيلاء الإنسان، رسائل Alz-Bot الغنية، اكتشاف اللغة ومحول لغة الدردشة.
يتم دعم رسالة المتابعة، ولكن يتم تجاهل إعداد التأخير، حيث يتم إرسال الرسالة فورا.
يتم دعم رسالة غير متصلة، ولكن لا يتم إرسال الجدول الزمني.

WECHAT

WeChat

الإعدادات أدناه تتعلق بتطبيق WeChat.

التثبيت

من Settings > Apps، انقر على WeChat وأدخل مفتاح الترخيص لتثبيت وتنشيط التطبيق. إذا كانت لديك النسخة السحابية، فإن التطبيق نشط بالفعل.
قم بزيارة https://mp.weixin.qq.com/cgi-bin/readtemplate?t=register/step1_tmpl&lang=en_US وقم بتسجيل حساب Service account.
بعد التسجيل، انتقل إلى منطقة Official accounts ومن القائمة اليسرى انقر على Settings and development > WeChat verification. يجب عليك إكمال التحقق، ويستغرق الأمر بضعة أسابيع ويكلف 99 دولارًا أمريكيًا، أو 300 يوان للكيانات الصينية.
من القائمة اليسرى انقر على Settings and development > Basic configuration وانسخ Developer ID (App ID)، Developer Password (App Secret). الصق المعلومات في Alz-Bot > Settings > WeChat.
من القائمة اليسرى انقر على Settings and development > Basic configuration وأكمل تكوين الخادم (服务器配置(已启用). في Server Address (URL) أدخل العنوان الذي تحصل عليه من Alz-Bot > Settings > WeChat > Synchronization > Get configuration URL. في Token قم بإدخال أي قيمة تريدها، يجب أن تُدخل نفس القيمة في Alz-Bot > Settings > WeChat > Token.
انتهيت. ستظهر جميع الرسائل المرسلة إلى حساب WeChat الخاص بك في منطقة الدردشة الإدارية في Alz-Bot.

مزيد من المعلومات

إذا كنت قد تلقيت خطأ مثل {"errcode":41001,"errmsg":"access_token missing rid: 631111-470b3b22-48553870"} يجب عليك إضافة عنوان IP لخادمك إلى Official Account > Settings and Development > Basic Configuration > IP whitelist.
لا يتم دعم مرفقات WeChat والموقع ولا يتم استلامها بواسطة Alz-Bot.
لا يتم دعم الروابط في WeChat، حيث يتم تحويلها إلى نصوص.
تُحول رسائل Alz-Bot الغنية تلقائيًا إلى رسائل WeChat الغنية عند الإمكان، وإلا يتم إزالتها من الرسالة.
محادثات ورسائل WeChat متوافقة مع التوجيه والانتظار.
يتم دعم Dialogflow، بما في ذلك الميزات التالية: Human takeover، رسائل Alz-Bot الغنية، كشف اللغة ومحول لغة الدردشة.
يتم دعم رسالة المتابعة، ولكن إعداد التأخير يتم تجاهله، حيث يتم إرسال الرسالة فورًا.
يتم دعم رسالة الخروج عن الخدمة، ولكن لا يتم إرسال الجدول الزمني.

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

تحتوي هذه القسم على مساعدة لإعدادات أخرى غير المذكورة أعلاه.

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

منطقة إدارة Alz-Bot هي تطبيق ويب تقدمي، مما يعني أنه يمكنك تثبيته على أجهزة سطح المكتب وأجهزة Mac أو الهواتف المحمولة واستخدامه كتطبيق كامل الوظائف. ملحوظة: تم تحسين هذه الميزة لمتصفح Google Chrome.

تثبيت على سطح المكتب

ادخل إلى منطقة الإدارة الخاصة بك (على سبيل المثال: https://www.your-site.com/alz-bot/admin.php)، وانقر فوق + على أعلى يمين شريط عنوان URL في متصفح Chrome الخاص بك.

تثبيت على الهاتف المحمول - الإصدار السحابي فقط

إذا كنت تستخدم الإصدار السحابي من Alz-Bot يمكنك استخدام التطبيقات المتاحة على Google Play ومتجر Apple.

Google Play

تثبيت على الهاتف المحمول

ادخل إلى منطقة الإدارة الخاصة بك باستخدام Google Chrome (على سبيل المثال: https://www.your-site.com/alz-bot/admin.php)
افتح إعدادات متصفحك.
انتقل إلى الأسفل وانقر على إضافة إلى الشاشة الرئيسية.
قم بتأكيد العملية بالنقر على إضافة.

تثبيت على ورد بريس

لتثبيت تطبيق الويب التقدمي على ورد بريس، يجب عليك الوصول إلى منطقة الإدارة مباشرة عبر الرابط:

https://www.your-site.com/wp-content/plugins/alz-bot/alz-bot/admin.php

قم بتغيير "your-site" بعنوان URL لموقع الويب الخاص بك وكذلك تذكر أن اسم مجلد "wp-content" قد يكون مختلفًا عن تلك التي تم تثبيتها لديك.

تغيير أيقونة واسم تطبيق الويب التقدمي

قم بتنزيل ملف manifest.json هنا. قم بتحريره واستبدل YOUR NAME باسم العلامة التجارية الخاصة بك، واستبدل YOUR NAME DESCRIPTION بأي نص تريده، واستبدل example.png بعنوان URL النسبي لرمز الخاص بك، يجب أن يكون حجم الرمز 512 × 512 بكسل. بعد الانتهاء من تحرير الملف، قم بنقله إلى مجلد تثبيت Alz-Bot نفسه، نفس المجلد الذي يوجد فيه ملف admin.php. يرجى ملاحظة أنه نظرًا لأن هذه هي تخصيصات، فإن دعمنا لا يغطيها، إذا كنت بحاجة إلى مساعدة يمكنك توظيفنا.

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

اختصارات لوحة المفاتيح في منطقة الإدارة مفعلة على كل من أجهزة الكمبيوتر وأجهزة MAC وتعمل على النحو التالي:

اختصار	الوصف
ENTER أو SPACE	تأكيد أو إغلاق تنبيه الحوار؛ نفس الشيء الذي يحدث عند النقر على OK.
ESC أو CANCEL	رفض تنبيه الحوار وإغلاقه.
SHIFT + ENTER أو CTRL + ENTER	إضافة فاصلة للسطر إلى رسالة. هذا يعمل فقط لمحرر الإدارة.
ESC	إغلاق صندوق الإضاءة.
CANCEL	في منطقة محادثات الإدارة، قم بأرشفة محادثة أو حذفها.
CTRL + UP/DOWN ARROW	في منطقة محادثات الإدارة، انتقل بين محادثات القائمة.
CTRL + RIGHT/LEFT ARROW	في منطقة مستخدمي الإدارة، انتقل بين المستخدمين.
CTRL + V	لصق صورة من الحافظة وإرسالها كرسالة.

ملف التكوين

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

الرمز	الوصف
قم بتغيير دليل التحميل (الدليل الافتراضي هو: /alz-bot/uploads/). أدخل عنوان URL: على سبيل المثال، https://your-site.com/myuploads/. لهذا الإعداد، تحتاج أيضًا إلى تعريف SB_UPLOAD_PATH.
define('SB_UPLOAD_PATH', 'YOUR-PATH')	قم بتغيير مسار دليل التحميل (المسار الافتراضي هو: /alz-bot/uploads/). أدخل المسار: على سبيل المثال، C:\xampp\htdocs\uploads. العثور على المسار الجذري لموقع الويب الخاص بك قد يكون أمرًا صعبًا قليلاً. يمكنك محاولة نسخ المسار المعروض في عميل FTP الخاص بك أو الاتصال بمزود خدمة استضافة الويب للحصول على دعم إضافي.
$GLOBALS['SB_LOCAL_SETTINGS'] = []	قم بتجاوز الإعدادات الافتراضية. القيمة هي مصفوفة من المفاتيح والقيم، كل مفتاح هو إعداد، على سبيل المثال، ["registration-required" => [true]]. اعرض مثالًا هنا. احصل على قائمة الإعدادات من resources/json/settings.json والملفات settings.json داخل مجلدات التطبيق.

وظائف Cron

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

سجلات

يتم حفظ ملف السجل في دليل تثبيت Alz-Bot.
تسجل السجلات الإجراءات التالية للوكلاء والمسؤولين: إرسال رسالة، حذف رسالة، أرشفة محادثة، حذف محادثة، استعادة محادثة، تخصيص محادثة لوكيل، تخصيص محادثة لقسم، تحديث مستخدم، حذف مستخدم.

المشرف

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

معلمات URL

الدردشة الأمامية

تسمح معلمات URL للدردشة بأداء إجراءات معينة عند تحميل الصفحة. لاستخدامها، قم بإلحاق معلمات URL أدناه بأي عنوان URL على موقع الويب الخاص بك الذي يعرض الدردشة. على سبيل المثال، https://example.com/?conversation=1234

معلمة URL	الوصف
?token=TOKEN	قم بتسجيل دخول مستخدم موجود. استبدل TOKEN برمز المستخدم.
?conversation=ID	افتح محادثة. استبدل ID بمعرف المحادثة. السمة token مطلوبة للمستخدمين غير المسجلين.
?chat=open	افتح الدردشة.

منطقة الإدارة

تسمح معلمات URL لمنطقة الإدارة بأداء إجراءات معينة عند تحميل الصفحة. لاستخدامها، قم بإلحاق معلمات URL أدناه بعنوان URL الخاص بالإدارة الخاص بك. على سبيل المثال، https://example.com/alz-bot/admin.php?conversation=1234

معلمة URL	الوصف
?conversation=ID	افتح محادثة في منطقة المحادثات. استبدل ID بمعرف المحادثة.
?user=ID	افتح مربع ملف التعريف لمستخدم. استبدل ID بمعرف المستخدم.
?setting=ID	افتح إعدادًا في منطقة الإعدادات. استبدل ID بمعرف الإعداد.
?report=ID	افتح تقريرًا في منطقة التقارير. استبدل ID بمعرف التقرير.
?area=name	افتح منطقة في الإدارة. استبدل name بالتالي: conversations، users، settings، reports.

Zapier

قم بدمج Zapier مع Alz-Bot عبر اتباع الخطوات أدناه. تعتمد التكامل على webhooks Alz-Bot، حيث يُعتبر كل webhook مشغلًا في Zapier، لذا لديك أكثر من 15 مشغلًا متاحًا في Zapier، لمزيد من التفاصيل، قم بزيارة صفحة الويبهوك.

انتقل إلى https://developer.zapier.com/ وقم بتسجيل الدخول، أو قم بإنشاء حساب جديد.
قم بإنشاء تكامل جديد عن طريق النقر على بدء تكامل Zapier، أو قم بزيارة https://developer.zapier.com/app/new. قم بملء جميع الحقول المطلوبة، مثل الاسم والوصف، وانقر على إنشاء، يمكنك إدخال أي نص تريده، ولكن احفظ اسم التطبيق في اعتبارك لأنك ستحتاج إليه لاحقًا.
انقر على القائمة اليسرى Triggers ثم Add Trigger.
قم بملء جميع الحقول المطلوبة، مثل المفتاح والوصف، وانقر على حفظ والمتابعة، يمكنك إدخال أي نص تريده.
في الأعلى انقر على تكوين API، اختر REST Hook كـ نوع المشغل، وانقر على حفظ.
ارجع إلى منطقة الإعدادات في المشغل، أو انتقل إلى https://zapier.com/app/zaps، وانقر على إنشاء Zap.
ابحث عن تطبيقك الذي تم إنشاؤه حديثًا عن طريق إدخال اسم التطبيق وانقر عليه. في حدث المشغل، حدد المشغل الخاص بك وانقر على المتابعة.
انسخ عنوان URL للويبهوك، ثم انقر على المتابعة، ومن ثم ادخل إلى منطقة إدارة Alz-Bot وأدخله في الإعدادات > متفرقات > ويبهوك > عنوان URL، قم بتفعيل الويبهوك، احفظ الإعدادات وأعد تحميل Alz-Bot.
قم بإجراء شيء لتحفيز ويبهوك مثل إرسال رسالة أو إنشاء مستخدم جديد، ثم انتقل إلى Zapier وانقر على تجربة المشغل ويجب أن ترى بيانات ويبهوك Alz-Bot. انقر على المتابعة.
انقر على الزر الأيمن التصفية وأعد ضبط التصفية لتحفيز التكامل فقط إذا كانت المتغيرات موجودة. تحتاج إلى التصفية لأن Alz-Bot سيُرسل جميع ويبهوك إلى جميع الـ zaps. مثال: إذا كان يرغب زاب الخاص بك في دمج رسائل Alz-Bot ، فستحتاج إلى ضبط التصفية للمتابعة فقط إذا كان المتغير message موجودًا.
انقر على المتابعة، أو + وأضف تكاملك.
لاستخدام عدة zaps وويبهوك، ستحتاج إلى تحديث الإعدادات > متفرقات > ويبهوك > عنوان URL وأضف معرفات zap الجديدة، مفصولة بفواصل. مثال: إذا كان لديك زابين مع عناوين URL https://hooks.zapier.com/hooks/catch/10352851/bbad21f/ و https://hooks.zapier.com/hooks/catch/10352851/aaaa66t/، يجب أن يكون العنوان URL https://hooks.zapier.com/hooks/catch/10352851/bbad21f,aaaa66t/.

مزيد من المعلومات

إذا قمت بتغيير اسم مجلد البرنامج الإضافي بعد التثبيت، يجب عليك تحديثه في الثابتة SB_URL في ملف config.php.
لا تتم إرسال رسائل الترحيب إلى slack ويتم أرشفة المحادثات التي تحتوي فقط على رسالة الترحيب (وبدون استجابة) تلقائيًا.
ترسل رسائل المتابعة مرة واحدة فقط كحد أقصى كل 24 ساعة.
يظهر دائمًا رسالة منبثقة افتراضية، حتى يقوم المستخدم بإغلاقها يدويًا؛ ثم تظل مغلقة.
تستخدم أقسام المستخدمين والمحادثات في منطقة إدارة Alz-Bot التمدد التلقائي على التمرير، والذي يقتصر على 100 نتيجة في التمرير الواحد.
لا تظهر رسالة الخصوصية إذا كانت خيار الطلب للتسجيل قد تم تمكينه.