إنتقل إلى المحتوى الرئيسي

إعداد الدردشة عبر الويب

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

الوصول إلى الدردشة عبر الويب​

  1. اذهب إلى التكاملات في الشريط الجانبي
  2. اضغط على الموقع الإلكتروني — تفتح صفحة تكاملات الويب
  3. اضغط على تكامل جديد

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

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

اسم التكامل​

أعطِ تكاملك اسماً داخلياً. هذا للمرجع عندك فقط — مفيد إذا كان لديك عدة دردشات عبر الويب.

أمثلة:

  • "دردشة الموقع الرئيسي"
  • "دردشة صفحات المنتجات"
  • "أداة مركز الدعم"

النطاق​

أدخل النطاق الذي ستظهر فيه هذه الدردشة (مثل yoursite.com).

الأمان

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

اللون الأساسي​

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

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

نمط المحادثة​

اختر شكل الأداة:

النمطالمظهر
كلاسيكيزر إطلاق دائري تقليدي على شكل فقاعة دردشة
عصريزر إطلاق على شكل كبسولة (Pill)

أيقونة الإطلاق​

اختر ما يظهر على زر إطلاق الدردشة:

  • الافتراضي — أيقونة الدردشة القياسية
  • صورة الوكيل — صورة وكيلك الافتراضي (يجب اختيار وكيل افتراضي أولاً)

رسائل البدء​

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

مثال: "ما هي ساعات العمل؟"

الوكيل الافتراضي​

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

النموذج الأولي​

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

  • تفعيل النموذج — تشغيل النموذج أو إيقافه
  • جمع الاسم
  • جمع البريد
  • جمع الهاتف

نوصي بجمع الاسم على الأقل من أجل:

  • الحماية من البوتات
  • إعطاء وكيلك الذكي سياقاً أكثر
  • السماح بالمتابعة خارج المحادثة
ملاحظة

البريد الإلكتروني وأرقام الهاتف غير مُتحقَّق منها — قد يدخل الزوار معلومات خاطئة. هذا متعمَّد لتقليل الاحتكاك وتسهيل بدء المحادثة على الزوار.

إنشاء التكامل​

اضغط على إنشاء التكامل للحفظ. ستعود إلى صفحة تكاملات الويب حيث ترى تكاملك الجديد.

تثبيت الأداة​

بعد إنشاء تكاملك:

  1. ارجع إلى التكاملات > الموقع الإلكتروني
  2. ابحث عن دردشة الويب التي أنشأتها للتو
  3. اضغط على أيقونة </> لفتح نافذة تثبيت دردشة أوركي

تحتوي النافذة على ثلاثة تبويبات، واحد لكل طريقة تثبيت:

HTML​

يعرض تبويب HTML كود تحميل جاهزاً، معبّأً مسبقاً بمعرّف المؤسسة (Tenant ID) ومعرّف التكامل (Integration ID) ورابط السكربت الصحيح لبيئتك. انسخ الكود من النافذة — لا تكتبه يدوياً — والصقه قبل وسم </body> الختامي في كل صفحة تريد ظهور الدردشة فيها.

Next.js / React​

يستخدم تبويب Next.js / React الحزمة الرسمية على npm:

pnpm add @orki/webchat-react

ضع المكوّن في طبقة التخطيط الرئيسية (تعرض النافذة هذا الكود بمعرّفاتك معبّأة مسبقاً):

import { OrkiWebChat } from '@orki/webchat-react';

export default function RootLayout({ children }) {
  return (
    <>
      {children}
      <OrkiWebChat
        tenantId="YOUR_TENANT_ID"
        integrationId="YOUR_INTEGRATION_ID"
        scriptUrl="SCRIPT_URL_FROM_DIALOG"
      />
    </>
  );
}

للتحكم البرمجي (فتح الدردشة من زر خاص بك)، غلّف تطبيقك بـ OrkiWebChatProvider واستخدم الـ Hook المسمى useOrkiWebChat() — تتضمن النافذة مثالاً قابلاً للنسخ.

ووردبريس​

يوفر تبويب ووردبريس إضافة قابلة للتنزيل — دون الحاجة لتعديل القالب:

  1. اضغط على تنزيل الملف المضغوط في النافذة
  2. من لوحة ووردبريس، اذهب إلى الإضافات ← أضف جديد ← ارفع إضافة
  3. ارفع الملف، ثم اضغط تثبيت الآن، ثم تفعيل
  4. اذهب إلى الإعدادات ← دردشة أوركي والصق معرّف المؤسسة ومعرّف التكامل ورابط السكربت (كلها معروضة في النافذة)

منصات أخرى​

لأي منصة تسمح بإدراج HTML مخصص، استخدم الكود من تبويب HTML:

المنصةأين تضيف الكود
Shopifyالسمات > تعديل الكود > theme.liquid قبل </body>
Wixالإعدادات > كود مخصص > نهاية المتن
Squarespaceالإعدادات > متقدم > حقن الكود > التذييل
Webflowإعدادات المشروع > كود مخصص > التذييل

عناصر التحكم في الأداة​

بعد التثبيت، توفر الأداة للزوار:

  • زر تكبير لتوسيع نافذة الدردشة
  • شارة الرسائل غير المقروءة على زر الإطلاق عند وصول رسائل جديدة والدردشة مغلقة
  • تذكّر حالة الفتح — تبقى الدردشة مفتوحة/مغلقة أثناء التنقل بين الصفحات
  • دعم كامل لاتجاه RTL للغة العربية

إدارة تكاملك​

عناصر التحكم في التكامل​

كل تكامل دردشة ويب يحتوي على عناصر التحكم التالية:

الأيقونة/التحكمالإجراء
</>فتح نافذة التثبيت (كود التضمين، حزمة npm، إضافة ووردبريس)
أيقونة القلمتعديل الإعدادات
مفتاح نشطتفعيل/تعطيل (يخفي الدردشة من الموقع عند التعطيل)
أيقونة سلة المحذوفاتحذف التكامل

الوكيل الافتراضي​

استخدم إعداد الوكيل الافتراضي لاختيار وكيل الذكاء الاصطناعي الذي يردّ على الرسائل.

يمكنك تغيير الوكيل المعيَّن في أي وقت.

تعديل الإعدادات​

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

التغييرات تنطبق فوراً — لا تحتاج لتحديث كود التضمين في موقعك.

التعطيل مقابل الحذف​

التعطيل (موصى به): عطّل لإخفاء الدردشة من موقعك. كود التضمين يمكن أن يبقى في موقعك — هو فقط لن يُحمَّل.

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

لماذا عدة دردشات ويب؟​

معظم العملاء يحتاجون دردشة ويب واحدة فقط. لكن التكاملات المتعددة مفيدة لـ:

وكلاء مختلفون على صفحات مختلفة​

قد ترغب في:

  • وكيل مبيعات على صفحات المنتجات
  • وكيل دعم على صفحات المساعدة/الأسئلة الشائعة
  • وكيل عام على الصفحة الرئيسية

أنشئ دردشات ويب منفصلة، عيّن وكلاء مختلفين، وضع كل كود في الصفحات ذات الصلة.

مواقع مختلفة​

إذا كنت تشغّل عدة مواقع، أنشئ دردشة ويب لكل نطاق.

اختبار A/B​

اختبر ألواناً أو أنماطاً أو تكوينات نماذج مختلفة لترى ما يحقق تحويلاً أفضل.

حدود التكامل​

عدد تكاملات دردشة الويب التي يمكنك إنشاؤها يعتمد على باقتك. تحقق من حدودك في الإعدادات > الفوترة.

الخطوات التالية​