AI Chat Widget for WordPress AI Chat Widget - إضافة الدردشة الذكية لووردبريس

نظرة عامة

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

---

التثبيت

الطريقة الأولى: الرفع اليدوي

1. قم بتحميل مجلد ai-chat-widget إلى /wp-content/plugins/
2. اذهب إلى الإضافات في لوحة تحكم ووردبريس
3. فعّل إضافة AI Chat Widget

الطريقة الثانية: من لوحة التحكم

1. اذهب إلى الإضافات > أضف جديد
2. ارفع ملف ZIP للإضافة
3. فعّل الإضافة

---

الإعداد والتكوين

الخطوة 1: الحصول على مفتاح API

للحصول على مفتاح OpenAI:

1. اذهب إلى platform.openai.com
2. سجل الدخول أو أنشئ حساباً جديداً
3. اذهب إلى API Keys
4. انقر على Create new secret key
5. انسخ المفتاح واحفظه

للحصول على مفتاح DeepSeek:

1. اذهب إلى platform.deepseek.com
2. أنشئ حساباً وسجل الدخول
3. اذهب إلى إعدادات API
4. أنشئ مفتاحاً جديداً

الخطوة 2: إعداد مزود الذكاء الاصطناعي

1. من لوحة تحكم ووردبريس، اذهب إلى AI Chat Widget > Settings
2. في تبويب 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 لـ:

1. مشاهدة الإحصائيات:
   • إجمالي الرسائل
   • عدد الجلسات الفريدة
   • التوكنات المستهلكة (لحساب التكلفة)
2. مراجعة المحادثات:
   • رسالة المستخدم
   • رد البوت
   • التاريخ والوقت
3. تصدير البيانات:
   • انقر على 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. تحسين تجربة المستخدم

• اكتب رسالة ترحيب جذابة
• أضف صورة للبوت لإضفاء طابع إنساني
• فعّل صوت الإشعارات لجذب الانتباه

---

استكشاف الأخطاء وإصلاحها

المشكلة: البوت لا يرد

الحلول:

1. تأكد من صحة مفتاح API باستخدام زر Test Connection
2. تحقق من أن لديك رصيد كافٍ في حسابك
3. تأكد من أن الموقع يستخدم HTTPS

المشكلة: الردود بطيئة

الحلول:

1. جرب نموذج أسرع مثل GPT-3.5-turbo
2. قلل Max Tokens
3. تحقق من سرعة اتصال الخادم

المشكلة: الردود غير دقيقة

الحلول:

1. أضف المزيد من المعلومات لقاعدة المعرفة
2. حسّن تعليمات البوت
3. قلل قيمة Temperature

المشكلة: النافذة لا تظهر

الحلول:

1. تأكد من أن الصفحة ليست مستبعدة
2. امسح كاش المتصفح والموقع
3. تحقق من تعارضات JavaScript في Console

---

الأسئلة الشائعة

س: هل الإضافة مجانية؟
ج: الإضافة مجانية، لكنك تحتاج لدفع تكلفة استخدام API لـ OpenAI أو DeepSeek.

س: كم تكلفة الاستخدام؟
ج: يعتمد على النموذج وعدد الرسائل. GPT-3.5-turbo حوالي $0.002 لكل 1000 توكن.

س: هل يمكنني استخدام الإضافة على عدة مواقع؟
ج: نعم، لكن كل موقع يحتاج مفتاح API خاص.

س: هل البيانات آمنة؟
ج: نعم، المحادثات تُخزن في قاعدة بيانات موقعك فقط.

س: هل تدعم الإضافة اللغة العربية؟
ج: نعم، الإضافة تدعم العربية بالكامل وتتكيف مع لغة الموقع.

---

الدعم والتواصل

تطوير: م. محمود حسين

الموقع: rawabeti.com/mahmoudhssn

---

سجل التحديثات

الإصدار 1.0.0

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

---

AI Chat Widget - حوّل موقعك إلى منصة تفاعلية ذكية! 🚀

Overview

AI Chat Widget is a WordPress plugin that adds an AI-powered chat window to your website. It supports both OpenAI and DeepSeek, lets you build a custom knowledge base, and gives you control over appearance, bot behavior, and usage tracking.

Key features

Multiple AI providers

• OpenAI support: GPT-4o, GPT-4, and GPT-3.5-turbo
• DeepSeek support: deepseek-chat, deepseek-coder, and deepseek-reasoner
• Switch providers directly from the WordPress admin area

Custom knowledge base

• Add company, product, service, and support information
• Use that information to answer customer questions more accurately
• Dynamic variables such as {site_name}, {site_url}, {admin_email}, and {current_date}

Full appearance control

• Choose primary and secondary colors
• Set the widget position to the left or right side
• Customize the bot name, avatar, and welcome message

Advanced chat experience

• Conversation memory to keep context between messages
• Clickable links generated automatically from URLs
• Typing indicator while the bot is preparing a response
• Notification sounds for new replies

Responsive and multilingual

• Works across desktop, tablet, and mobile
• Isolated CSS that avoids conflicts with WordPress themes
• Built-in RTL support and Arabic translation
• Adapts automatically to the WordPress site language

Logs and analytics

• Stores conversations in the database
• Tracks total messages, unique sessions, and token usage
• Exports logs as CSV

Security

• XSS protection
• AJAX nonce validation
• Per-minute message limits to reduce abuse
• Customizable rate limiting

System requirements

• WordPress 6.0 or newer
• PHP 8.0 or newer
• An API key from OpenAI or DeepSeek

Installation

Manual upload

1. Upload the ai-chat-widget folder to /wp-content/plugins/.
2. Open Plugins in WordPress admin.
3. Activate AI Chat Widget.

ZIP upload from the dashboard

1. Go to Plugins > Add New.
2. Upload the plugin ZIP file.
3. Activate the plugin.

Setup

1. Get an API key

Create an API key from platform.openai.com or platform.deepseek.com, then save it in a secure place.

2. Configure the AI provider

1. Open AI Chat Widget > Settings.
2. Choose your provider in the AI Provider tab.
3. Paste the API key, pick a model, and run Test Connection.

Recommended model choices

• GPT-4o for the strongest responses and advanced support flows
• GPT-4 for premium customer-service quality
• GPT-3.5-turbo for faster, lower-cost answers
• deepseek-chat for balanced general conversations
• deepseek-coder for developer or technical support use cases

3. Build the knowledge base

Add your company profile, product details, pricing, working hours, support information, and frequently asked questions in the Knowledge Base tab.

4. Define bot instructions

Use the Bot Instructions tab to shape tone and behavior. You can configure the assistant for customer service, sales, technical support, or general help.

5. Customize appearance

Control the widget colors, screen position, bot name, welcome message, and avatar from the Appearance tab.

6. Review advanced settings

Use Advanced Settings for excluded pages, per-minute message limits, notification sound, and conversation logging.

Working with chat logs

Open AI Chat Widget > Chat Logs to review conversation history, unique sessions, token consumption, and export data to CSV.

Best practices

• Keep the knowledge base specific, structured, and up to date.
• Use a lower temperature for technical support and a higher one for conversational use cases.
• Watch token usage and pick lighter models for simple questions.
• Write a clear welcome message and use an avatar for a more human product feel.

Troubleshooting

The bot is not responding

1. Test the API key again.
2. Make sure your provider account has enough balance.
3. Confirm the site is using HTTPS.

Responses are slow

1. Try a faster model such as GPT-3.5-turbo.
2. Lower the max token count.
3. Check server and network performance.

Responses are inaccurate

1. Improve the knowledge base content.
2. Refine the bot instructions.
3. Reduce the temperature setting.

The widget does not appear

1. Make sure the current page is not excluded.
2. Clear site and browser caches.
3. Check the browser console for JavaScript conflicts.

FAQ

Is the plugin free?
The plugin is free, but API usage from OpenAI or DeepSeek is billed separately by the provider.

How much does usage cost?
Cost depends on the selected model and total message volume. Lighter models stay significantly cheaper.

Can I use it on multiple websites?
Yes, but each site should use its own API configuration.

Is the data safe?
Conversations are stored in your own WordPress database, not on a third-party dashboard.

Does it support Arabic?
Yes. The plugin includes Arabic support and works correctly in RTL environments.

Support

Developer: Mahmoud Hussein

Website: rawabeti.com/mahmoudhssn

Changelog

Version 1.0.0

• Initial release
• OpenAI and DeepSeek support
• Custom knowledge base
• Custom bot instructions
• Multilingual interface
• Conversation logs and analytics
• Responsive layout
• Conversation memory
• Clickable links

AI Chat Widget helps turn a static site into an interactive support experience.

Download AI Chat Widget