نظرة عامة
AI Chat Widget هي إضافة ووردبريس احترافية تتيح لك إضافة نافذة دردشة ذكية مدعومة بالذكاء الاصطناعي إلى موقعك. تدعم الإضافة مزودي الذكاء الاصطناعي الرائدين OpenAI و DeepSeek، مما يمنحك مرونة في اختيار النموذج الأنسب لاحتياجاتك.
المميزات الرئيسية
🤖 دعم متعدد لمزودي الذكاء الاصطناعي
- OpenAI: دعم نماذج GPT-4o, GPT-4, GPT-3.5-turbo
- DeepSeek: دعم نماذج deepseek-chat, deepseek-coder, deepseek-reasoner
- إمكانية التبديل بين المزودين بسهولة من لوحة التحكم
📚 قاعدة معرفة مخصصة
- أضف معلومات شركتك ومنتجاتك وخدماتك
- البوت يستخدم هذه المعلومات للإجابة على أسئلة العملاء بدقة
- دعم المتغيرات الديناميكية:
{site_name},{site_url},{admin_email},{current_date}
🎨 تخصيص كامل للمظهر
- اختيار الألوان الرئيسية والثانوية
- تحديد موضع النافذة (يمين/يسار)
- تخصيص اسم البوت وصورته
- رسالة ترحيب مخصصة
💬 تجربة محادثة متطورة
- ذاكرة المحادثة: البوت يتذكر سياق المحادثة السابقة
- الروابط القابلة للنقر: تحويل URLs تلقائياً إلى روابط
- مؤشر الكتابة: يظهر عندما يكتب البوت رده
- صوت الإشعارات: تنبيه صوتي عند وصول رد جديد
📱 تصميم متجاوب
- يعمل بشكل مثالي على جميع الأجهزة (سطح المكتب، تابلت، موبايل)
- CSS معزول لا يتعارض مع قوالب ووردبريس
- دعم كامل للغات RTL (العربية، العبرية، إلخ)
🌍 دعم متعدد اللغات
- واجهة بالإنجليزية كلغة أساسية
- ترجمة عربية كاملة مضمنة
- يتكيف تلقائياً مع لغة موقع ووردبريس
📊 إحصائيات وسجلات
- تسجيل جميع المحادثات في قاعدة البيانات
- إحصائيات: إجمالي الرسائل، الجلسات الفريدة، التوكنات المستخدمة
- تصدير البيانات بصيغة CSV
🔒 الأمان
- حماية ضد هجمات XSS
- تحقق AJAX Nonce
- حد للرسائل في الدقيقة لمنع إساءة الاستخدام
- Rate Limiting قابل للتخصيص
متطلبات النظام
| المتطلب | الحد الأدنى |
|---|---|
| WordPress | 6.0+ |
| PHP | 8.0+ |
| مفتاح API | OpenAI أو DeepSeek |
التثبيت
الطريقة الأولى: الرفع اليدوي
- قم بتحميل مجلد ai-chat-widget إلى
/wp-content/plugins/ - اذهب إلى الإضافات في لوحة تحكم ووردبريس
- فعّل إضافة AI Chat Widget
الطريقة الثانية: من لوحة التحكم
- اذهب إلى الإضافات > أضف جديد
- ارفع ملف ZIP للإضافة
- فعّل الإضافة
الإعداد والتكوين
الخطوة 1: الحصول على مفتاح API
للحصول على مفتاح OpenAI:
- اذهب إلى platform.openai.com
- سجل الدخول أو أنشئ حساباً جديداً
- اذهب إلى API Keys
- انقر على Create new secret key
- انسخ المفتاح واحفظه
للحصول على مفتاح DeepSeek:
- اذهب إلى platform.deepseek.com
- أنشئ حساباً وسجل الدخول
- اذهب إلى إعدادات API
- أنشئ مفتاحاً جديداً
الخطوة 2: إعداد مزود الذكاء الاصطناعي
- من لوحة تحكم ووردبريس، اذهب إلى AI Chat Widget > Settings
- في تبويب AI Provider:
- اختر المزود (OpenAI أو DeepSeek)
- أدخل مفتاح API
- اختر النموذج المناسب
- انقر على Test Connection للتأكد من صحة المفتاح
اختيار النموذج المناسب:
| النموذج | المميزات | الاستخدام المثالي |
|---|---|---|
| GPT-4o | الأحدث والأذكى | محادثات معقدة، دعم فني متقدم |
| GPT-4 | ذكي جداً | خدمة عملاء احترافية |
| GPT-3.5-turbo | سريع واقتصادي | استفسارات بسيطة، حجم كبير |
| deepseek-chat | متوازن | محادثات عامة |
| deepseek-coder | متخصص بالبرمجة | دعم فني تقني |
الخطوة 3: إعداد قاعدة المعرفة
في تبويب Knowledge Base، أضف معلومات عن:
- نبذة عن شركتك
- المنتجات والخدمات مع الأسعار
- ساعات العمل
- طرق التواصل
- الأسئلة الشائعة
مثال:
## عن الشركة
نحن {site_name}، شركة متخصصة في تقديم حلول التقنية منذ 2015.
## ساعات العمل
الأحد - الخميس: 9 صباحاً - 6 مساءً
الجمعة - السبت: عطلة
## التواصل
البريد الإلكتروني: {admin_email}
الهاتف: +966 XX XXX XXXX
الموقع: {site_url}
## خدماتنا
1. تصميم المواقع - تبدأ من 5000 ريال
2. تطوير التطبيقات - تبدأ من 15000 ريال
3. التسويق الرقمي - باقات شهرية من 2000 ريال
## الأسئلة الشائعة
س: ما هي مدة تنفيذ المشروع؟
ج: تعتمد على حجم المشروع، عادة من 2-8 أسابيع.
س: هل تقدمون دعم فني؟
ج: نعم، نقدم دعم فني مجاني لمدة 3 أشهر بعد التسليم.
الخطوة 4: تعليمات البوت (System Prompt)
في تبويب Bot Instructions، حدد شخصية البوت:
قوالب جاهزة:
- خدمة العملاء: ودود ومهذب، يركز على حل المشاكل
- المبيعات: يركز على إبراز المميزات وإقناع العميل
- الدعم الفني: تقني ودقيق، يقدم حلول خطوة بخطوة
- مساعد عام: متعدد المهام، يتكيف مع أي موضوع
مثال على تعليمات مخصصة:
أنت مساعد خدمة العملاء لشركة {site_name}.
- كن ودوداً ومهذباً دائماً
- أجب بشكل مختصر ومفيد
- إذا لم تعرف الإجابة، اطلب من العميل التواصل معنا
- استخدم الإيموجي بشكل معتدل 😊
- ختم كل رد بسؤال للتأكد من رضا العميل
الخطوة 5: تخصيص المظهر
في تبويب Appearance:
| الإعداد | الوصف |
|---|---|
| Primary Color | لون زر الدردشة والعناصر الرئيسية |
| Secondary Color | لون الخلفية والنصوص |
| Widget Position | يمين أو يسار الشاشة |
| Bot Name | الاسم الذي يظهر في رأس النافذة |
| Welcome Message | أول رسالة تظهر للزائر |
| Bot Avatar | صورة البوت (اختياري) |
الخطوة 6: الإعدادات المتقدمة
في تبويب Advanced Settings:
| الإعداد | الوصف | القيمة الافتراضية |
|---|---|---|
| Excluded Pages | صفحات لا تظهر فيها الدردشة | فارغ |
| Messages Per Minute | حد الرسائل لمنع الإساءة | 10 |
| Notification Sound | صوت عند وصول رد | مفعّل |
| Log Conversations | حفظ المحادثات | مفعّل |
استخدام سجل المحادثات
اذهب إلى AI Chat Widget > Chat Logs لـ:
- مشاهدة الإحصائيات:
- إجمالي الرسائل
- عدد الجلسات الفريدة
- التوكنات المستهلكة (لحساب التكلفة)
- مراجعة المحادثات:
- رسالة المستخدم
- رد البوت
- التاريخ والوقت
- تصدير البيانات:
- انقر على Export CSV
- حمّل الملف لتحليله
نصائح للاستخدام الأمثل
1. تحسين قاعدة المعرفة
- كن محدداً ودقيقاً
- أضف الأسئلة الشائعة الفعلية من عملائك
- حدّث المعلومات بانتظام
- استخدم تنسيق Markdown للتنظيم
2. ضبط Temperature
- 0.3-0.5: ردود دقيقة ومتسقة (دعم فني)
- 0.6-0.7: توازن بين الدقة والإبداع (خدمة عملاء)
- 0.8-1.0: ردود إبداعية ومتنوعة (محادثات عامة)
3. إدارة التكاليف
- راقب استهلاك التوكنات من سجل المحادثات
- استخدم GPT-3.5-turbo للاستفسارات البسيطة
- حدد Max Tokens المناسب (500-1000 للردود القصيرة)
4. تحسين تجربة المستخدم
- اكتب رسالة ترحيب جذابة
- أضف صورة للبوت لإضفاء طابع إنساني
- فعّل صوت الإشعارات لجذب الانتباه
استكشاف الأخطاء وإصلاحها
المشكلة: البوت لا يرد
الحلول:
- تأكد من صحة مفتاح API باستخدام زر Test Connection
- تحقق من أن لديك رصيد كافٍ في حسابك
- تأكد من أن الموقع يستخدم HTTPS
المشكلة: الردود بطيئة
الحلول:
- جرب نموذج أسرع مثل GPT-3.5-turbo
- قلل Max Tokens
- تحقق من سرعة اتصال الخادم
المشكلة: الردود غير دقيقة
الحلول:
- أضف المزيد من المعلومات لقاعدة المعرفة
- حسّن تعليمات البوت
- قلل قيمة Temperature
المشكلة: النافذة لا تظهر
الحلول:
- تأكد من أن الصفحة ليست مستبعدة
- امسح كاش المتصفح والموقع
- تحقق من تعارضات JavaScript في Console
الأسئلة الشائعة
س: هل الإضافة مجانية؟
ج: الإضافة مجانية، لكنك تحتاج لدفع تكلفة استخدام API لـ OpenAI أو DeepSeek.
س: كم تكلفة الاستخدام؟
ج: يعتمد على النموذج وعدد الرسائل. GPT-3.5-turbo حوالي $0.002 لكل 1000 توكن.
س: هل يمكنني استخدام الإضافة على عدة مواقع؟
ج: نعم، لكن كل موقع يحتاج مفتاح API خاص.
س: هل البيانات آمنة؟
ج: نعم، المحادثات تُخزن في قاعدة بيانات موقعك فقط.
س: هل تدعم الإضافة اللغة العربية؟
ج: نعم، الإضافة تدعم العربية بالكامل وتتكيف مع لغة الموقع.
الدعم والتواصل
تطوير: م. محمود حسين
الموقع: rawabeti.com/mahmoudhssn
سجل التحديثات
الإصدار 1.0.0
- الإصدار الأول
- دعم OpenAI و DeepSeek
- قاعدة معرفة مخصصة
- تعليمات بوت قابلة للتخصيص
- واجهة متعددة اللغات
- سجل محادثات وإحصائيات
- تصميم متجاوب
- ذاكرة المحادثة
- روابط قابلة للنقر
AI Chat Widget - حوّل موقعك إلى منصة تفاعلية ذكية! 🚀