المفاهيم الأساسية

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

كيف يعمل FRENZY.BOT

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  بياناتك    │ ──→ │   الفهرسة    │ ──→ │   Qdrant    │
│ ملفات، روابط│     │ (Embeddings) │     │ (قاعدة بيانات│
│أسئلة شائعة  │     └──────────────┘     │  موجهة)     │
└─────────────┘                          └──────┬──────┘
                                                │
                                                │ استرجاع
┌─────────────┐     ┌──────────────┐     ┌──────┴──────┐
│   سؤال      │ ──→ │  FRENZY.BOT  │ ──→ │ نموذج الذكاء │
│  المستخدم   │     │ (محرك RAG)   │ ←── │ الاصطناعي   │
└─────────────┘     └──────┬───────┘     │(عبر OpenRouter)
                           │             └─────────────┘
                    ┌──────┴──────┐
                    │   الرد      │
                    │+ بيانات العميل│
                    │ + التحليلات │
                    └─────────────┘

تقوم برفع بياناتك — الملفات، وروابط المواقع الإلكترونية، وأزواج الأسئلة الشائعة تُحفظ في قاعدة المعرفة.
يقوم النظام بفهرستها — يتم تحويل المحتوى إلى تضمينات عددية (embeddings) وتخزينها في Qdrant (قاعدة بيانات موجهة) بحيث يمكن البحث عنها من خلال المعنى، وليس فقط الكلمات المفتاحية.
يسأل المستخدم سؤالاً — عبر الأداة (widget)، أو واتساب، أو تليجرام، أو أي قناة متصلة أخرى.
يقوم FRENZY.BOT باسترجاع المحتوى ذي الصلة — يجد النظام الأجزاء الأكثر صلة من قاعدة المعرفة الخاصة بك باستخدام البحث الدلالي.
يقوم نموذج الذكاء الاصطناعي بتوليد الرد — يتم إرسال المحتوى المسترجع + سؤال المستخدم إلى نموذج الذكاء الاصطناعي (Claude، GPT، Gemini، إلخ) عبر OpenRouter.
يتم تتبع كل شيء — يتم تخزين المحادثة، ووقت الاستجابة، واستهلاك الرموز (tokens)، وأي بيانات عملاء (leads) تم التقاطها لأغراض التقارير.

البوت (Bot)

البوت الخاص بك هو المساعد الذكي الذي تقوم ببنائه. لكل بوت خصائصه المستقلة:

قاعدة المعرفة — المستندات، والروابط، والأسئلة الشائعة التي يتعلم منها.
الإعدادات — نموذج الذكاء الاصطناعي، التوجيه البرمجي (system prompt)، درجة الحرارة (temperature)، الهوية البصرية، وإعدادات الأداة (widget).
المحادثات — سجل الدردشة مع المستخدمين.
العملاء المحتملون (Leads) — جهات الاتصال التي تم التقاطها أثناء المحادثات.
التحليلات — مقاييس الاستخدام وبيانات القمع التسويقي.
الأداة (Widget) — رمز التضمين الخاص به مع معرف فريد data-bot-id.

في إعداد البوتات المتعددة، يمكنك تشغيل عدة بوتات من تثبيت واحد — بحيث يكون كل منها معزولاً تماماً عن الآخرين.

مكان الإدارة: الإعدادات، قاعدة المعرفة، التضمين، والقائمة المنسدلة لمساحة العمل في رأس الصفحة.

قاعدة المعرفة (Knowledge Base)

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

ثلاثة مصادر للبيانات:

المصدر	الأفضل لـ	سرعة الفهرسة
الملفات (PDF، DOCX، TXT، CSV، إلخ)	المستندات الداخلية، السياسات، مواصفات المنتجات	دقائق
الروابط (أي صفحة ويب عامة)	محتوى الموقع، مقالات المساعدة، تدوينات المدونة	دقائق
الأسئلة الشائعة (أزواج يدوية)	الإجابات الحاسمة التي تريد التحكم بها بدقة	فوري

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

للاطلاع على الدليل الكامل، انظر قاعدة المعرفة.

القنوات (Channels)

القنوات هي الأماكن التي يتفاعل فيها المستخدمون مع البوت.

القناة	النوع	الإعداد
أداة الموقع (Widget)	أساسي	سكربت تضمين في موقعك
واتساب	مراسلة	WAHA Docker + ربط رمز QR
تليجرام	مراسلة	رمز بوت من @BotFather
ديسكورد	مجتمع	رمز بوت من بوابة المطورين
إنستغرام	اجتماعي	رمز الوصول للصفحة (Page Access Token)
ماسينجر	اجتماعي	تكامل صفحة فيسبوك
سلاك	بيئة عمل	رمز التطبيق
Webhook	مخصص	أي نقطة نهاية HTTP

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

للمزيد من التفاصيل، انظر القنوات.

الجلسات والمحادثات (Sessions & conversations)

الجلسة هي محادثة كاملة واحدة بين المستخدم والبوت. تتبع كل جلسة ما يلي:

الرسائل — كل سؤال ورد في المحادثة.
الرموز (Tokens) — عدد رموز الذكاء الاصطناعي التي تم استهلاكها (تؤثر على التكلفة).
المدة — كم استغرقت المحادثة من الوقت.
المصدر — القناة التي جاءت منها المحادثة.
بيانات العميل — أي معلومات اتصال تم التقاطها أثناء الدردشة.

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

العملاء المحتملون والتكاملات (Leads & integrations)

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

تتدفق بيانات العملاء عبر مسار معين:

جديد ← تم الاتصال ← مؤهل ← محول (أو مفقود)

تعمل التكاملات على توجيه العملاء المحتملين تلقائياً إلى أدواتك الخارجية:

البريد الإلكتروني — إشعارات SMTP لفريقك.
Webhook — بيانات JSON إلى نقاط النهاية الخاصة بك.
Google Sheets — إضافة صفوف لنظام CRM بسيط.
Mailchimp — إضافة جهات اتصال إلى قوائم التسويق عبر البريد الإلكتروني.

للتفاصيل، انظر إدارة العملاء المحتملين و التكاملات.

الوحدات البرمجية (Modules)

الوحدات هي قدرات اختيارية يمكنك تفعيلها أو تعطيلها دون التأثير على النظام الأساسي:

الوحدة	وظيفتها
الوصول المباشر للويب (Tavily)	تتيح للبوت البحث في الويب مباشرة عندما لا تكفي البيانات الداخلية
التسليم لبشري	تصعيد المحادثات إلى موظفين بشريين
تحويل النص إلى كلام	تحويل ردود الذكاء الاصطناعي إلى تشغيل صوتي
حجز المواعيد	الجدولة داخل الدردشة عبر Calendly
نموذج العميل المحتمل	التقاط معلومات الاتصال في منتصف المحادثة
واتساب	المراسلة الآلية عبر WAHA

تصفح وأدر الوحدات في الوحدات.

التحقق السريع الذاتي

استخدم هذه القائمة للتحقق من أن البوت الخاص بك يعمل بكامل طاقته:

[ ] قاعدة المعرفة مكتملة — تم إضافة ملف واحد أو رابط أو سؤال شائع واحد على الأقل وتظهر الحالة مباشر (Live).
[ ] OpenRouter متصل — يظهر محرك الذكاء الاصطناعي مزوداً متصلاً ونموذجاً مختاراً.
[ ] الأداة (Widget) منشورة — سكربت التضمين موجود على موقعك وفقاعة الدردشة تظهر.
[ ] التكاملات مفعلة — يتم توجيه العملاء المحتملين إلى نظام CRM الخاص بك، أو البريد الإلكتروني، أو الـ webhook.

إذا كانت هذه النقاط الأربع متحققة، فنظامك جاهز تماماً لاستقبال الزيارات الفعلية.