المحادثات

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

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

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

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

معلومات

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

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

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

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

الحقول المدمجة

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


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

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

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

كيف تعمل:


1

إنشاء وإرسال

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

عرض الرسالة

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

استجابة المستخدم تم إرسالها

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

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


الاسم الرمز القصير الوصف
بطاقة
[card image="URL" header="TITLE" description="Lorem ipsum dolor sit amete" link="URL" link-text="شراء" extra="$599" target="_blank"]
بطاقة دعوة لاتخاذ إجراء تحتوي على صورة، عنوان، وصف، رابط، والمزيد.
سلايدر
[slider image-1="URL" header-1="TITLE" description-1="Lorem ipsum dolor sit amete" link-1="URL" link-text-1="شراء" extra-1="$599" image-2="URL" header-2="TITLE" description-2="Lorem ipsum dolor sit amete" link-2="URL" link-text-2="شراء" extra-2="$599" 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="إرسال الآن"]
قائمة من المدخلات النصية.
البريد الإلكتروني
[email name="true" last-name="true" phone="true" phone-required="false" placeholder=""]
نموذج لجمع البريد الإلكتروني ورقم الهاتف من المستخدم. جميع السمات اختيارية. اتبع إعدادات افتراضية. أضف السمة required-messaging-apps="true" لإجبار المستخدمين على تقديم بريدهم الإلكتروني ورقم الهاتف على تطبيقات المراسلة.
تسجيل
[registration]
نموذج التسجيل.
الجدول الزمني
[timetable]
جدول زمني.
مقالات
[articles link="https://alfchatbot.com/articles-demo"]
مقالات مع منطقة بحث. سمة link تستخدم كرسالة بديلة لرسائل Facebook Messenger وWhatsApp وTelegram.
تقييم
[rating label-positive="مفيد" label-negative="غير مفيد" label="قيم وراجع" success-negative=""]
نموذج تقييم الوكيل. لجعل الرمز القصير للتقييم يعمل على WhatsApp وMessenger وTelegram، تحتاج إلى استخدام Dialogflow والدردشة، وإنشاء Intent جديد مع rating كـ input Context، لا شيء كـ output Context، قائمة بالرسائل الشائعة من المستخدم للتقييم الإيجابي كـ Training phrases (مثل: جيد، إيجابي) و{ "rating": 1, "force-message": true } كـ Custom Payload استجابة. للتقييم السلبي، أنشئ Intent جديد بنفس السياق ولكن بدّل العبارات التدريبية والحمولة المخصصة إلى { "rating": -1, "force-message": true } . يجب أن يتضمن الرمز القصير أيضًا title أو message.
قائمة
[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://alfchatbot.com" name="انقر هنا" target="_blank" style="link"]
عرض رابط أو فتح مقال. السمة target="_blank" اختيارية وتفتح الرابط في نافذة جديدة. السمة style="link" اختيارية وتغير تصميم الزر. لفتح مقال عند النقر، يجب أن تكون قيمة الرابط #article-ID، استبدل ID بمعرف المقال.
فيديو
[video type="youtube" id="0TImic4N1ko" height="350"]
عرض فيديو من YouTube أو Vimeo. قيمة السمة type يمكن أن تكون youtube أو vimeo. السمة id هي معرف الفيديو، احصل عليه من الرابط. السمة height اختيارية وتحدد ارتفاع الفيديو بالبكسل.
صورة
[image url="https://alfchatbot.com/media/admin.png"]
صورة.
مشاركة
[share fb="https://alfchatbot.com/" tw="https://alfchatbot.com/" li="https://alfchatbot.com/" pi="https://alfchatbot.com/" wa="https://alfchatbot.com/"]
أزرار مشاركة اجتماعية.

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

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


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

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

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

{"rich-messages":{"4Voyu":{"type":"email","result":{"email":["example@gmail.com","Your email ..."]}}}}


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

يمكنك إنشاء رسائل غنية مخصصة بمحتوى مخصص خاص بك من خلال الذهاب إلى الإعدادات > متنوعات. حاليًا، الرسائل الغنية المخصصة ثابتة ولا توجد خيارات تفاعلية متاحة كما هو الحال مع الرموز المختصرة. ومع ذلك، يمكنك إدراج أكواد 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>
صورة تتكبير عند النقر.

المرفقات

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

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


المستخدمون

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

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


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

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

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

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

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

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

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

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


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

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

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

إذا كنت تستخدم نسخة WordPress من Alfchatbot، يتم إنشاء مدير عند تفعيل المكون الإضافي بنفس المستخدم وكلمة المرور للمستخدم الذي قام بتسجيل الدخول.


معلومات

  • يتم عرض المستخدمين الجدد تلقائيًا في جدول المستخدمين في الوقت الفعلي.
  • لعرض المستخدمين المتصلين واستلام إشعارات المستخدم المتصل، قم بتمكين الإعدادات > المستخدمون > تسجيل جميع الزوار.
  • للحصول على إشعار المستخدم المتصل، تحتاج أيضًا إلى تمكين الإعدادات > متنوعات > Pusher.
  • يتم عرض نموذج تسجيل الدخول فقط إذا كان حقل كلمة المرور للتسجيل معروضًا.
  • يتم عرض حقل كلمة المرور دائمًا عندما يتم تعيين نظام المستخدم على "WordPress".
  • إذا كان الإعدادات > المستخدمون > السماح بتكرار البريد الإلكتروني مفعلًا وأدخل مستخدم بريدًا إلكترونيًا مسجلًا بالفعل، يتم إنشاء مستخدم جديد ويتم إزالة البريد الإلكتروني من المستخدم القديم. لن يتمكن المستخدم الجديد من الوصول إلى رسائل ومحادثات المستخدم القديم. يمكنك أيضًا تسجيل دخول المستخدم تلقائيًا عبر معلمات 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>. إذا كنت تستخدم النسخة الخاصة بـ WordPress، يمكنك استخدام الشيفرة القصيرة [sb-articles].
  • بدلاً من ذلك، يمكن مشاركة المقالات عبر شيفرة الرسائل الغنية، [articles].

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

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

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

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

تعديل الترجمات

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

لغة الدردشة

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

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

لغة الإدارة

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

  • ترجم النصوص إلى لغتك من الإعدادات > الترجمات.

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

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

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

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

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

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

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

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

معلومات

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

الأقسام

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

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

الإعدادات

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

كيفية العمل

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

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

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

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

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

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

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

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

كيفية اختبار قائمة الانتظار

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

التوجيه

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

المعلومات

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

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

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

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

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

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

التفعيل

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

المعلومات

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

مهمة cron

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

Pusher

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

التفعيل

  • اذهب إلى https://dashboard.pusher.com/accounts/sign_up وقم بإنشاء حساب جديد.
  • من لوحة التحكم الخاصة بك على https://dashboard.pusher.com، اختر منتج Channels عن طريق النقر على ابدأ الآن.
  • ادخل اسم تطبيقك واختر الكلاستر الأقرب إلى موقعك.
  • من القائمة الجانبية للوحة التحكم، انقر على إعدادات التطبيق وقم بتمكين أحداث العميل.
  • من القائمة الجانبية للوحة التحكم، انقر على المفاتيح، انسخ معرف التطبيق، المفتاح، السر، الكلاستر.
  • اذهب إلى الإعدادات > متنوع > Pusher، والصق معرف التطبيق، والمفتاح، والسر، والكلاستر.
  • انتهيت.

المعلومات

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

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

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

عام

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

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

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

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

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

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

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

التنظيمات

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

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

النشرة الإخبارية

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

Mailchimp

Sendinblue

SendGrid

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

Elastic Email

  • للحصول على المفتاح، ادخل إلى Elastic Email، ثم انقر على الإعدادات من قائمة الملف الشخصي في أعلى اليمين. انقر على إنشاء مفتاح API إضافي (https://elasticemail.com/account#/settings/new/create-api)، قم بتحديد اسم واختر الإضافة أو الوصول الكامل، أو مخصص وتأكد من أن الإذن جهات الاتصال محدد على عرض وتعديل.
  • معرف القائمة هو اسم القائمة. مهم! يجب ألا تحتوي أسماء القوائم أو الشرائح الموجودة على أي مسافات فيها.

Campaign Monitor

  • للحصول على المفتاح، ادخل إلى Campaign Monitor، ثم انقر على إعدادات الحساب من قائمة الملف الشخصي في أعلى اليمين. انقر على مفاتيح API > إنشاء مفتاح API.
  • للحصول على معرف القائمة، ادخل إلى Campaign Monitor، ثم انقر على القوائم والمشتركين من القائمة العلوية. اختر قائمة ثم انقر على الإعدادات من القائمة الجانبية ونسخ معرف API للقائمة.

HubSpot

  • للحصول على المفتاح، ادخل إلى HubSpot، ثم احصل عليه من الإعدادات > التكاملات > مفتاح API.
  • للحصول على معرف القائمة، ادخل إلى HubSpot، ثم احصل عليه من جهات الاتصال > قائمة > تفاصيل القائمة.

Moosend

  • للحصول على المفتاح، ادخل إلى Moosend، ثم انقر على الإعدادات > مفتاح API.
  • للحصول على معرف القائمة، ادخل إلى Moosend، ثم احصل عليه من الجمهور > قوائم البريد الإلكتروني.

GetResponse

  • للحصول على معرف القائمة، ادخل إلى GetResponse، ثم احصل عليه من القوائم > قائمتك > الإعدادات (https://app.getresponse.com/lists). انسخ قيمة رمز القائمة.
  • للحصول على المفتاح، قم بزيارة https://app.getresponse.com/api.

ConvertKit

  • للحصول على المفتاح، ادخل إلى ConvertKit، ثم احصل عليه من الإعدادات > المتقدم > سر API.
  • للحصول على معرف القائمة، ادخل إلى ConvertKit، ثم احصل عليه من النمو > صفحات الهبوط والنماذج. افتح النموذج الخاص بك ونسخ الجزء الرقمي من عنوان URL. على سبيل المثال، المعرف للنموذج بعنوان URL https://app.convertkit.com/forms/designers/3003412/edit هو 3003412.

ActiveCampaign

  • للحصول على المفتاح، ادخل إلى ActiveCampaign، ثم احصل عليه من إعدادات الحساب > المطورين.
  • للحصول على معرف القائمة، ادخل إلى ActiveCampaign، ثم احصل عليه من القائمة الجانبية > القوائم أو القائمة الجانبية > جهات الاتصال > القوائم. افتح قائمتك ونسخ معرف القائمة في عنوان URL. على سبيل المثال، المعرف للقائمة بعنوان URL https://schiocco.activehosted.com/app/contacts/?listid=1&status=1 هو 1. يجب أن يكون معرف القائمة بهذا التنسيق: النطاق:معرف القائمة. النطاق هو الجزء الأول من عنوان URL الخاص باللوحة. على سبيل المثال، نطاق https://schiocco.activehosted.com/ هو schiocco والقيمة النهائية التي يجب إدخالها في Alfchatbot هي schiocco:1.

MailerLite

  • للحصول على المفتاح، ادخل إلى MailerLite، ثم احصل عليه من القائمة الجانبية > التكاملات > MailerLite API.
  • للحصول على معرف القائمة، ادخل إلى MailerLite، ثم احصل عليه من القائمة الجانبية > المشتركين > المجموعات. عرض مجموعة ونسخ معرف المجموعة من عنوان URL (على سبيل المثال: ....group=18783408688903967...).

Mailjet

  • للحصول على المفتاح، قم بزيارة https://app.mailjet.com/account/apikeys، أو ادخل إلى Mailjet، ثم احصل عليه من إعدادات الحساب > إعدادات الحساب.
  • للحصول على معرف القائمة، ادخل إلى MailerLite، ثم احصل عليه من جهات الاتصال > قوائم جهات الاتصال > قائمتك. احصل على معرف القائمة بالنقر على أيقونة ؟ بجانب بريد القوائم. على سبيل المثال: 1202546.

Grammarly

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

  • قم بتسجيل حساب مطور على https://developer.grammarly.com/.
  • أنشئ تطبيقًا جديدًا، اذهب إلى منطقة المصادقات وانسخ معرف العميل. في الأصول يجب أيضًا إضافة النطاق الذي تم تثبيت Alfchatbot عليه.
  • الصق معرف العميل في الإعدادات > الإدارة > Grammarly > معرف العميل.
  • تأكد من إيقاف تشغيل ملحق Grammarly في متصفحك.

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

أمازون S3

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

  • قم بتسجيل الدخول إلى AWS كمستخدم رئيسي من https://aws.amazon.com/.
  • انتقل إلى لوحة تحكم IAM وانقر على القائمة الجانبية > إدارة الوصول > المستخدمون.
  • انقر على إضافة مستخدم جديد، أدخل اسم المستخدم واستمر.
  • اختر إضافة المستخدم إلى مجموعة وفي قسم مجموعات المستخدمين أدناه انقر على إنشاء مجموعة. في سياسات الأذونات ابحث عن AmazonS3FullAccess وحددها. انقر على إنشاء مجموعة مستخدمين.
  • قم بتعيين المجموعة الجديدة إلى المستخدم الذي تقوم بإنشائه واستمر، ثم انقر على إنشاء مستخدم.
  • اختر المستخدم الذي تم إنشاؤه حديثًا وافتح علامة التبويب بيانات الاعتماد الأمنية.
  • في منطقة مفاتيح الوصول، انقر على إنشاء مفتاح وصول واختر تطبيق يعمل خارج AWS. استمر حتى تحصل على المفاتيح واحفظها في Alfchatbot > الإعدادات > متنوعات > Amazon S3.
  • قم بزيارة لوحة تحكم Amazon S3 وانقر على إنشاء دلو.
  • حدد اسم الدلو والمنطقة التي تريدها. احفظ المنطقة والاسم في Alfchatbot > الإعدادات > متنوعات > Amazon S3. تحقق من تمكين ACLs ومالك الدلو المفضل. ألغِ تحديد حظر الوصول العام بالكامل وجميع المربعات المتعلقة بذلك.
  • انقر على إنشاء دلو.
  • هذه الميزة تقنية واختيارية. لا تغطي الدعم أي مساعدة تتعلق بهذه الميزة.

الإشعارات

الإشعارات

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


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

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


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

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

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

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

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

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


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

مشاكل؟

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

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

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

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

التفعيل

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

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

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

معلومات

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

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

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

الإشعارات المكتبية

الإشعارات المكتبية

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

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

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

التفعيل

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

معلومات

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

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

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


التذاكر

التذاكر

الإعدادات التالية تتعلق بتطبيق التذاكر.


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

تثبيت PHP

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

                                <script src="alfchatbot/js/min/jquery.min.js"></script> <!-- غير مطلوب إذا تم تحميل jQuery بالفعل -->
                                <script id="sbinit" src="alfchatbot/js/main.js?mode=tickets"></script>
                            
  • لا يمكنك تضمين منطقة الدردشة والتذاكر في نفس الصفحة. تأكد من إزالة السكربت الذي يحمل الدردشة. يمكنك عرض منطقة التذاكر أيضاً عن طريق إدراج الكود <script>SB_TICKETS = true;</script> في أي صفحة تعرض الدردشة.
  • لتحديد موقع منطقة التذاكر، أدخل الكود <div id="sb-tickets"></div>. سيتم عرض منطقة التذاكر داخل عنصر div هذا. بشكل افتراضي، يتم إضافة منطقة التذاكر إلى body.

تثبيت WordPress

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

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

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



المعلومات

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

Dialogflow

Dialogflow

الإعدادات التالية تتعلق بتطبيق Dialogflow.


المزامنة

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

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

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

  • سجل الدخول إلى وحدة تحكم Dialogflow ES عن طريق الذهاب إلى dialogflow.cloud.google.com. يجب تسجيل الدخول باستخدام نفس حساب Google المستخدم أثناء المزامنة.
  • انقر على رمز الترس في أعلى اليسار، بجانب اسم الروبوت، وافتح منطقة الإعدادات. . إذا لم تقم بإنشاء روبوت بعد، اتبع التعليمات أدناه لإنشاء أول روبوت لك.
  • انسخ معرف المشروع .
  • تأكد من اختيار الولايات المتحدة / عالمي في أعلى يسار لوحة تحكم 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، اختر نفس المشروع الذي استخدمته أثناء المزامنة.
  • أضف نية جديدة من القائمة الجانبية وافتحها.
  • في منطقة عبارات التدريب، أضف السؤال الذي تريد أن يرد عليه الروبوت، وأضف أكبر عدد من المتغيرات التي يمكنك. على سبيل المثال، إذا كنت تريد أن يرد الروبوت على المستخدمين الذين يسألون عن عنوان عملك، أضف متغيرات مثل "ما هو عنوانك"، "العنوان"، "أين أنت".
  • في منطقة الردود، أضف إجابة الروبوت كـرد نصي.
  • لقد أنشأت أول سؤال وجواب لك! اختبره من المنطقة اليمنى أو من دردشة Alfchatbot. أضف نوايا جديدة لتعبئة الروبوت بالأسئلة والأجوبة التي تريدها. يمكنك تضمين أسئلة وأجوبة أساسية مسبقة البناء عن طريق تفعيل ميزة Small Talk من القائمة الجانبية.

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


الإجراءات

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

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

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

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

التسليم البشري اليدوي

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

WhatsApp، Messenger، Telegram

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


الرد الذكي

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

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

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

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

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

معلومات

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

OpenAI

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

توليد تعبيرات المستخدم - خيار

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

توليد تعبيرات المستخدم - زر

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

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

معلومات

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

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

  • سجل في https://programmablesearchengine.google.com/.
  • أنشئ بحثًا وقم بإعداده كما تريد. نوصي بإضافة موقعك فقط وWikipedia إذا كنت تريد أن يرد الروبوت على الأسئلة العامة، واترك خيار البحث في الويب بالكامل غير مفعل. استخدم إعداد الكيانات لاستبعاد النتائج غير الصحيحة.
  • انتقل إلى تحرير محرك البحث > الإعدادات > الأساسيات ونسخ قيمة معرف محرك البحث، الصقها في Alfchatbot.
  • للحصول على مفتاح 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-search تلقائيًا. يحتوي السياق على السمة link والتي هي رابط الموقع لنتيجة بحث Google. استخدم السياق لإنشاء نية جديدة توفر الرابط، إذا أرسل المستخدم رسالة مثل أخبرني المزيد أو أريد أن أعرف المزيد.
  • ليس من الضروري تفعيل تصحيح التهجئة باستخدام بحث Google. يمكنك تعطيل بحث Google وتفعيل تصحيح التهجئة فقط.
  • إذا كان بحث Google نشطًا، فسوف يكون له الأولوية على OpenAI.

تنفيذ

بيانات التنفيذ المرسلة إلى عنوان URL الخاص بالويب الخاصة بك تكون على النحو التالي:

 {
 	"responseId": "4a58fc4f...",
 	"queryResult": {
 		"queryText": "fullfilment",
 		"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": "ar"
 	},
 	"originalDetectIntentRequest": {
 		"payload": {
 			"alfchatbot": {
 				"conversation_id": "3002",
 				"user_id": "3777"
 			}
 		}
 	},
 	"session": "projects/example/agent/sessions/3777-3002"
 }

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


معلومات

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

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

استجابة Dialogflow

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

المرفقات الخاصة بالمستخدم

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

[name:file-name.ext,url:URL,extension:file-extension]
مثال:
        [name:archive.zip,url:https://alfchatbot.com/archive.zip,extension:zip]
        [name:license.pdf,url:https://alfchatbot.com/license.pdf,extension:pdf]
    

المرفقات الخاصة بالروبوت

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

        { "attachments": [["name", "YOUR-LINK"], ["name", "YOUR-LINK"], ["name", "YOUR-LINK"]]}
    
استبدل "name" بالاسم الفعلي للمرفق الذي تريد عرضه واستبدل "YOUR-LINK" بعنوان URL الفعلي للملف. يتم عرض المرفقات الصور تلقائيًا كصور.

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

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

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

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

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

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

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

تحسين دردشة Dialogflow

  • إذا كان الروبوت يرد بنوايا خاطئة، انتقل إلى لوحة تحكم Dialogflow > إعدادات الروبوت > إعدادات ML، واضبط عتبة تصنيف ML على رقم أكبر، مثل 0.6.

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

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

  • انتقل إلى Dialogflow وأنشئ نية جديدة. في منطقة عبارات التدريب أدخل التعبير مثال استطلاع. في منطقة الردود أدخل الشيفرة [الأزرار id="test-survey-1" الخيارات="البرمجيات، المنتجات المادية، الخدمات" العنوان="ما هو نوع عملك؟" الرسالة="يرجى اختيار النوع الذي يناسب شركتك." النجاح="نوع شركتك هو "]
  • أنشئ نية جديدة. أدخل التعبير test-survey-1 وكرد أدخل [اختر id="seq-survey-2" الخيارات="البريد العاجل، خدمة النقل السريع، خدمة النقل الدولية" العنوان="طرق الشحن" الرسالة="اختر طريقة الشحن المفضلة لعملائك" النجاح="طريقة الشحن المفضلة لعملائك هي"]
  • أنشئ نية جديدة. أدخل التعبير 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، أنشئ معالج حدث وأدخل ترحيب كـ حدث مخصص.
  • مقالات Alfchatbot يتم مزامنتها تلقائيًا مع قاعدة المعرفة في Dialogflow.
  • استخدم المتغير JS SB_DIALOGFLOW_AGENT = "AGENT ID" لتغيير وكيل Dialogflow الافتراضي، استبدل "AGENT ID" بـ معرف المشروع.

WHATSAPP

واتساب

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


التثبيت

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

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

  • أنشئ حساب مطور وتطبيق فيسبوك جديد كما هو موضح في https://developers.facebook.com/docs/whatsapp/cloud-api/get-started#set-up-developer-assets.
  • في Alfchatbot > الإعدادات > واتساب > API السحابية > المفتاح السري أدخل سلسلة عشوائية ثم انتقل إلى https://developers.facebook.com/apps وحدد تطبيقك. انقر على إضافة منتج وأضف واتساب، ثم انتقل إلى واتساب > التكوين وفي عنوان URL للويب هوك أدخل العنوان الذي تحصل عليه من Alfchatbot > الإعدادات > واتساب > API السحابية > عنوان URL للتكوين. في رمز التحقق أدخل المفتاح السري الذي أدخلته مسبقاً في Alfchatbot. انقر على التحقق واحفظ، انقر على حقول ويب هوك > إدارة، وفعّل حقول الويب هوك التالية: الرسائل.
  • في Alfchatbot > الإعدادات > واتساب > API السحابية > الرمز أدخل الرمز التجريبي للاختبار، واتبع التعليمات أدناه للحصول على الرمز الدائم.
    • قم بزيارة https://business.facebook.com وانتقل إلى القائمة الجانبية اليسرى > الإعدادات > إعدادات النظام الإضافية، ثم انتقل إلى المستخدمون > المستخدمون النظاميون لعرض المستخدم النظامي الذي أنشأته، أو أنشئ واحدًا جديدًا. انقر على هذا المستخدم وحدد إضافة الأصول. يجب أن يكون المستخدم النظامي مسؤولاً.
    • انقر على القائمة الجانبية اليسرى > التطبيقات وتحت تحديد الأصول اختر تطبيقك. فعّل تطوير التطبيق لهذا التطبيق واحفظ.
    • انقر على توليد الرمز وحدد تطبيقك، فعّل الأذونات التالية: whatsapp_business_management، whatsapp_business_messaging، business_management. انقر على توليد الرمز واحفظ. الصق الرمز في Alfchatbot > الإعدادات > واتساب > API السحابية > الرمز.
  • للحصول على معرف الهاتف انتقل إلى https://developers.facebook.com, اختر تطبيقك وانتقل إلى القائمة الجانبية اليسرى > واتساب > البدء.
  • يمكنك اختبار التكامل من https://developers.facebook.com, اختر تطبيقك وانتقل إلى القائمة الجانبية اليسرى > واتساب > البدء.

إعداد حساب 360dialog

  • انتقل إلى https://www.360dialog.com/ وأنشئ حسابًا جديدًا.
  • أدخل إلى لوحة التحكم الخاصة بك ومن القائمة الجانبية اليسرى > حسابات واتساب أنشئ مفتاح API ونسخه والصقه في Alfchatbot > الإعدادات > واتساب > إعدادات 360dialog.
  • انقر على Alfchatbot > الإعدادات > واتساب > إعدادات 360dialog > مزامنة الآن.
  • تم! يجب أن يبدأ Alfchatbot في استقبال الرسائل المرسلة إلى رقمك عبر واتساب، ويمكنك الرد على تلك الرسائل من Alfchatbot.
  • لاحظ أنه يمكنك أيضًا استخدام حساب الساندبوكس المجاني للاختبار، تفاصيل أكثر في https://docs.360dialog.com/whatsapp-api/whatsapp-api/sandbox. حساب الساندبوكس له قيود وبعض الميزات، مثل المرفقات الإعلامية، لن تعمل.

إعداد حساب Twilio

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

رسائل الطوارئ

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

رسالة الطوارئ النصية

لتمكين رسالة الطوارئ النصية يجب عليك إعداد SMS في الإعدادات > الإشعارات > إشعارات الرسائل النصية.
تفاصيل أكثر هنا

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

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

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

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

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

متجر واتساب

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

حقل الدمج الوصف
{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 المحدد في الإعدادات > واتساب > ويب هوك الطلبات. يجب أن تقوم الصفحة الموجودة على هذا العنوان بمعالجة الطلب وإرسال رسالة إلى المستخدم عبر وظيفة API الخاصة بـ PHP sb_whatsapp_send_message().
  • لتوصيل المتجر بـ WooCommerce، انقر هنا.

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

  • إذا لم تستلم رسائل واتساب، تأكد من أنك لا تعين محادثات واتساب إلى قسم وأن رقم واتساب المستخدم للاختبار ليس رقم هاتف أحد مديري أو وكلاء Alfchatbot. أيضًا، تأكد من إعداد عنوان URL للويب هوك بشكل صحيح.
  • إذا لم تتمكن من إرسال الرسائل، يجب أن يظهر خطأ في منطقة الإدارة عندما تحاول إرسال رسالة إلى المستخدم.
  • لا يمكننا تقديم الدعم لتكوين Twilio أو 360dialog، بما في ذلك جميع المشكلات ذات الصلة.
  • لا يمكننا تقديم الدعم في الحصول على موافقة حساب واتساب الخاص بك أو قالب رسالة واتساب.
  • محادثات ورسائل واتساب متوافقة مع التوجيه والطابور.
  • إذا كنت تختبر باستخدام الساندبوكس وبعد 72 ساعة لم تتمكن من إرسال الرسائل إلى رقم هاتفك، يجب عليك ربط رقم هاتفك بالساندبوكس مرة أخرى.
  • إذا أرسلت رسائل بها أزرار أو خيارات غنية، بأكثر من 3 خيارات، يمكنك استخدام خاصية whatsapp="نص قائمتك" لتعيين نص قائمة رسائل واتساب.

ماسنجير

ماسنجير

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


التثبيت

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

إنستغرام

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

  • انتقل إلى منطقة الإعدادات في صفحة فيسبوك الخاصة بك وانقر على القائمة الجانبية اليسرى > إنستغرام (https://www.facebook.com/YOUR-PAGE-SLUG/settings/).
  • انقر على ربط الحساب وأكمل الإعداد.
  • قم بمزامنة ماسنجير مع Alfchatbot مرة أخرى وانتهى الأمر.

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

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

تويتر

تويتر

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


التثبيت

  • سجل في https://developer.twitter.com. تأكد من التحقق من رقم هاتفك في https://twitter.com/settings/phone أو ستفشل عملية التسجيل.
  • أنشئ تطبيقك الأول بإدخال اسم التطبيق واضغط على احصل على المفاتيح، انسخ مفتاح API (مفتاح العميل) وسر مفتاح API (سر العميل) والصقهم في Alfchatbot > الإعدادات > تويتر.
  • اطلب الوصول المرتفع من https://developer.twitter.com/en/portal/products/elevated. اضغط على تقديم طلب للوصول المرتفع وأكمل النموذج كما يلي: في المنطقة الأولى بكلماتك و في هل سيستخدم تطبيقك وظيفة تغريد، إعادة تغريد، إعجاب، متابعة، أو رسالة مباشرة؟ أدخل أحتاج إلى الوصول إلى API نشاط الحساب لبدء استلام رسائل تويتر المباشرة إلى برنامج الدردشة الخاص بي (Alfchatbot) والرد عليها مباشرة من Alfchatbot، التفاصيل على https://alfchatbot.com/twitter. قم بإلغاء تحديد جميع الحقول الأخرى بالنقر على لا: هل تخطط لتحليل بيانات تويتر؟، هل تخطط لعرض تغريدات أو تجميع بيانات حول محتوى تويتر خارج تويتر؟، هل سيجعل منتجك أو خدمتك أو تحليلك محتوى تويتر أو المعلومات المشتقة متاحة للجهات الحكومية؟
  • انتظر بضعة أيام حتى تراجع تويتر وتوافق على الوصول المرتفع، ستتلقى رسالة بريد إلكتروني من تويتر.
  • بمجرد حصولك على الوصول المرتفع، ادخل إلى لوحة التحكم الخاصة بالمطورين (https://developer.twitter.com/en/portal/dashboard) ومن القائمة اليسرى اضغط على المنتجات > Premium > بيئات التطوير وتحت API نشاط الحساب / Sandbox اضغط على إعداد بيئة التطوير، في تسمية بيئة التطوير أدخل sb أو نفس القيمة المدخلة في الإعدادات > تويتر > المزامنة > تسمية بيئة التطوير.
  • انتقل إلى منطقة الإعدادات للتطبيق من القائمة اليسرى > المشاريع والتطبيقات > مشروعك > تطبيقك وتحت إعدادات مصادقة المستخدم اضغط على إعداد وفعّل OAuth 1.0a. في أذونات التطبيق تحقق من قراءة وكتابة ورسالة مباشرة، في عنوان URL الخاص بالاسترجاع / إعادة التوجيه أدخل عنوان URL الذي تحصل عليه من Alfchatbot > الإعدادات > تويتر > الحصول على عنوان URL الخاص بالاسترجاع، في عنوان URL للموقع الإلكتروني أدخل عنوان URL لموقعك الإلكتروني.
  • انتقل إلى منطقة المفاتيح والرموز للتطبيق من القائمة اليسرى > المشاريع والتطبيقات > مشروعك > تطبيقك > المفاتيح والرموز وتحت رموز المصادقة أنشئ رمز الوصول والسر، انسخها والصقها في Alfchatbot > الإعدادات > تويتر.
  • أدخل اسم ملفك الشخصي على تويتر في Alfchatbot > الإعدادات > تويتر > اسم المستخدم الخاص بك. احصل عليه من صفحة ملفك الشخصي على تويتر، انسخ الاسم الذي يبدأ بـ @ أو جزء من URL الذي يحتوي على اسم المستخدم الخاص بك. مثال: https://twitter.com/alfchatbot.
  • احفظ إعدادات Alfchatbot واضغط على الزر Alfchatbot > الإعدادات > تويتر > الاشتراك وانتهى الأمر. ستتلقى جميع الرسائل المرسلة إلى حساب تويتر الخاص بك من قبل Alfchatbot.

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

  • إذا تلقيت رسائل مكررة، قد يكون حساب تويتر الذي تستخدمه للاختبار هو نفس الحساب الذي قمت بمزامنته. حاول إرسال رسالة من حساب تويتر آخر.
  • استخدم نطاقاً حياً، localhost غير مدعوم.
  • عند تلقي رسالة من مستخدم تويتر يمكنك إرسال ما يصل إلى 5 رسائل في الرد خلال نافذة 24 ساعة. لا يمكن إرسال أي رسائل بعد 24 ساعة من تلقي رسالة تويتر.
  • يمكنك إرسال ما يصل إلى 3 أو 4 مرفقات حسب نوع الوسائط.
  • الرسائل الغنية من Alfchatbot التالية غير مدعومة: شريط الصور، شريط التمرير، البطاقة.

رسائل جوجل للأعمال

رسائل جوجل للأعمال

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


التثبيت

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

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

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

تليجرام

تليجرام

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


التثبيت

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

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

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

فايبر

فايبر

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


التثبيت

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

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

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

سلاك

سلاك

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


المزامنة

لمزامنة سلاك، انقر على الزر ابدأ المزامنة في منطقة الإعدادات > سلاك واتبع التعليمات.

تواجه مشاكل؟

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

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

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

لأرشفة قناة في سلاك، اتبع الخطوات التالية:

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

ربط الأقسام

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

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

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

معلومات

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

PERFEX CRM

Perfex

الإعدادات التالية تتعلق بتطبيق Perfex.


التثبيت

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

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

لإظهار Alfchatbot داخل منطقة إدارة Perfex، يجب تثبيت Alfchatbot في نفس النطاق ونفس نظام ملفات تثبيت Perfex.

إذا واجهت مشاكل، أو إذا قمت بتغيير تفاصيل قاعدة بيانات Perfex، تأكد من أن الملف alfchatbot/config.php يستخدم تفاصيل قاعدة بيانات Perfex الصحيحة. تحديث التفاصيل في Alfchatbot لن يحدث التفاصيل في ملف config.php.


Zendesk

Zendesk

الإعدادات التالية تتعلق بتطبيق Zendesk.


التثبيت

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

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

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

WHMCS

WHMCS

الإعدادات التالية تتعلق بتطبيق WHMCS.


التثبيت

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

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

  • انتقل إلى منطقة إدارة Alfchatbot، ثم انتقل إلى الإعدادات > التطبيقات > WHMCS، وأدخل رمز الترخيص لتثبيت التطبيق. بعد تثبيت التطبيق، انتقل إلى الإعدادات > WHMCS وأدخل معلومات قاعدة البيانات وعنوان URL لـ WHMCS.

تثبيت إضافة WHMCS

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

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

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

إذا واجهت مشاكل، أو إذا قمت بتغيير تفاصيل قاعدة بيانات WHMCS، تأكد من أن الملف alfchatbot/config.php يستخدم تفاصيل قاعدة بيانات WHMCS الصحيحة. تحديث التفاصيل في Alfchatbot لن يحدث التفاصيل في ملف config.php.

Martfury

Martfury

الإعدادات التالية تتعلق بتطبيق Martfury.


التثبيت

  • انتقل إلى منطقة إدارة Alfchatbot، ثم انتقل إلى الإعدادات > التطبيقات > Martfury، وأدخل مفتاح الترخيص لتثبيت التطبيق.
  • بعد تثبيت التطبيق، انتقل إلى الإعدادات > Martfury وأدخل معلومات قاعدة البيانات، عنوان URL لمارتفوري، المفتاح السري. احصل على المعلومات من الملف .env الموجود في الدليل الجذري لمارتفوري.
  • حدد مسار Martfury في الإعدادات > Martfury > مسار Martfury. احصل على هذه المعلومات عن طريق تحميل هذا الملف في مجلد /public/ في الدليل الجذري لمارتفوري، بعد التحميل افتحه عبر المتصفح (مثل https://shop.com/public/path.php).
  • لعرض الدردشة على الموقع، أدخل كود Alfchatbot من تثبيت PHP في مسؤول Martfury > المظهر > JavaScript مخصص > JavaScript التذييل. لا تقم بتضمين jQuery.
  • إذا واجهت مشكلات، تأكد من أن الملف alfchatbot/config.php يستخدم تفاصيل قاعدة بيانات Martfury الصحيحة.

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

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


محادثة البائعين

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

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

LINE

LINE

الإعدادات التالية تتعلق بتطبيق LINE.


التثبيت

  • سجل الدخول إلى https://developers.line.biz/console/ أو أنشئ حسابًا جديدًا.
  • أنشئ موفرًا جديدًا ثم قناة Messaging API جديدة، اختر Messaging API كنوع القناة.
  • من منطقة الإعدادات الأساسية للقناة، انسخ السر القناة وألصقه في Alfchatbot > الإعدادات > LINE > التزامن > السر القناة.
  • من منطقة Messaging API للقناة، أنشئ رمز وصول القناة (طويل الأمد)، انسخه والصقه في Alfchatbot > الإعدادات > LINE > التزامن > رمز الوصول.
  • أدخل عنوان URL الخاص بك في عنوان URL للويب هوك وانقر على تحقق. احصل على عنوان URL للويب هوك من Alfchatbot > الإعدادات > LINE > التزامن > عنوان URL للويب هوك.
  • قم بتمكين استخدام ويب هوك.
  • امسح رمز QR باستخدام تطبيق LINE على هاتفك المحمول لبدء الكتابة إلى قناتك.
  • انتهيت. ستظهر جميع الرسائل المرسلة إلى حساب روبوت LINE الخاص بك في منطقة إدارة المحادثات في Alfchatbot.

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

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

WECHAT

WeChat

الإعدادات التالية تتعلق بتطبيق WeChat.


التثبيت

  • من الإعدادات > التطبيقات، انقر على WeChat وأدخل مفتاح الترخيص الخاص بك لتثبيت وتفعيل التطبيق. إذا كنت تستخدم النسخة السحابية، فإن التطبيق مفعل بالفعل.
  • قم بزيارة https://mp.weixin.qq.com/cgi-bin/readtemplate?t=register/step1_tmpl&lang=en_US وسجل حساب خدمة.
  • بعد التسجيل، انتقل إلى منطقة الحسابات الرسمية ومن القائمة الجانبية انقر على الإعدادات والتطوير > التحقق من WeChat. يجب عليك إكمال التحقق، يستغرق الأمر بضعة أسابيع ويكلف 99 دولارًا أمريكيًا، أو 300 يوان صيني للكيانات الصينية.
  • من القائمة الجانبية، انقر على الإعدادات والتطوير > التكوين الأساسي ونسخ معرف المطور (معرف التطبيق)، كلمة مرور المطور (السر للتطبيق). الصق المعلومات في Alfchatbot > الإعدادات > WeChat.
  • من القائمة الجانبية، انقر على الإعدادات والتطوير > التكوين الأساسي وأكمل تكوين الخادم (服务器配置(已启用). في عنوان URL للخادم أدخل عنوان URL الذي تحصل عليه من Alfchatbot > الإعدادات > WeChat > التزامن > الحصول على عنوان URL للتكوين. في الرمز أدخل أي قيمة تريدها، ويجب إدخال نفس القيمة في Alfchatbot > الإعدادات > WeChat > الرمز.
  • انتهيت. ستظهر جميع الرسائل المرسلة إلى حسابك في WeChat في منطقة إدارة المحادثات في Alfchatbot.

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

  • إذا تلقيت خطأ مثل {"errcode":41001,"errmsg":"access_token missing rid: 631111-470b3b22-48553870"} تحتاج إلى إضافة عنوان IP الخاص بخادمك إلى القائمة البيضاء من الحساب الرسمي > الإعدادات والتطوير > التكوين الأساسي > القائمة البيضاء لعنوان IP.
  • ملفات WeChat والمرفقات الموقع غير مدعومة وليست مستلمة من قبل Alfchatbot.
  • الروابط غير مدعومة في WeChat، ويتم تحويلها إلى نصوص.
  • يتم تحويل الرسائل الغنية من Alfchatbot تلقائيًا إلى رسائل غنية لـ WeChat عند الإمكان، بخلاف ذلك يتم إزالتها من الرسالة.
  • المحادثات والرسائل الخاصة بـ WeChat متوافقة مع التوجيه والطابور.
  • يتم دعم Dialogflow، بما في ذلك الميزات التالية: استلام الرسائل البشرية، رسائل Alfchatbot الغنية، اكتشاف اللغة ومفتاح تبديل اللغة للروبوت.
  • يتم دعم الرسائل المتابعة، ولكن يتم تجاهل إعداد التأخير، ويتم إرسال الرسالة على الفور.
  • يتم دعم الرسائل غير المتصلة، ولكن جدول التوقيت غير مرسل.


Zapier

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

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

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

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