═══════════════════════════════════════════════════════════════════════════════
  دليل أتمتة الرد على واتساب بالذكاء الاصطناعي — Omdaa
═══════════════════════════════════════════════════════════════════════════════

لديك في المشروع أكثر من طريقة لربط واتساب بالذكاء الاصطناعي. أسهل طريقة تعتمد
على N8N Bot + workflow في n8n (ويب هوك يستقبل الرسالة، يمررها لـ AI، ويرد بنص الرد).

───────────────────────────────────────────────────────────────────────────────
  الطريقة ١ — N8N Bot + n8n (مُوصى بها)
───────────────────────────────────────────────────────────────────────────────

المسار:
  واتساب ← Omdaa ← يرسل للنص إلى n8n ويب هوك ← n8n يشغّل AI ← n8n يرد بنص
  ← Omdaa يرسل النص كرسالة واتساب للمستخدم

الخطوات:

١) تفعيل N8N في البيئة
   في ملف .env (الباك اند):
     N8N_ENABLED=true

٢) إنشاء Bot في لوحة Omdaa
   • من الواجهة: الدخول إلى التكاملات (Integrations) أو N8N Bot.
   • إنشاء Bot جديد للجلسة المرتبطة برقم واتساب:
     - اسم/وصف البوت (اختياري).
     - رابط الـ Webhook في n8n (مثل: https://n8n.srv.../webhook/alaabeh).
     - نوع التفعيل: "الكل" (all) = يرد على كل رسالة، أو "كلمة مفتاحية" (keyword).
   • حفظ وتفعيل البوت (enabled = true).

٣) إنشاء Workflow في n8n
   • في n8n أنشئ Workflow جديد.
   • أضف العقد:
     أ) Webhook — طريقة POST، مسار مثل /webhook/alaabeh (يطابق الرابط في البوت).
     ب) عقدة الذكاء الاصطناعي:
        - OpenAI Chat (إذا استخدمت OpenAI في n8n)، أو
        - أي عقدة AI أخرى (مثل HTTP Request لـ Dify/Flowise API).
     ج) Respond to Webhook — لإرجاع الرد إلى Omdaa.
   • ربط: Webhook → AI → Respond to Webhook.
   • في "Respond to Webhook" أعد الـ Body كـ JSON يحتوي على نص الرد في أحد الحقول:
     output  أو  answer  أو  text  أو  message
     مثال: { "output": "نص الرد من الذكاء الاصطناعي" }

٤) تفعيل الـ Workflow في n8n وحفظه.
   بعد ذلك أي رسالة واردة للجلسة (حسب إعداد التفعيل) ستُمرّر للبوت ثم لـ n8n،
   والرد الذي يرجعه n8n سيُرسل تلقائياً كرسالة واتساب.

ملاحظات:
  • الرابط في البوت يجب أن يكون نفس رابط الـ Webhook في n8n.
  • إن استخدمت "كلمة مفتاحية" فسيُرد البوت فقط عندما تحتوي الرسالة على الكلمة.
  • يمكنك إضافة Basic Auth للويب هوك في n8n وضبطه في إعدادات البوت (basicAuthUser / basicAuthPass).

───────────────────────────────────────────────────────────────────────────────
  الطريقة ٢ — ويب هوك المستخدم فقط (بدون N8N Bot)
───────────────────────────────────────────────────────────────────────────────

هنا Omdaa يرسل حدث message.received إلى رابط الويب هوك (مثل n8n) ولا ينتظر رداً.
الرد يجب أن يُرسل من n8n باتصال عكسي لـ API Omdaa.

الخطوات:

١) ضبط رابط الويب هوك في Omdaa (للمستخدم أو للجلسة) على رابط الـ Webhook في n8n.

٢) في n8n:
   • Webhook يستقبل الـ POST (الحدث من Omdaa).
   • استخراج من الـ body: sessionId، remoteJid/from، نص الرسالة، إلخ.
   • عقدة AI تُنشئ الرد.
   • عقدة HTTP Request لاستدعاء Omdaa لإرسال الرسالة:
     - URL: https://your-omdaa-domain/api/v1/messages/send-text
     - Method: POST
     - Headers: Authorization: Bearer <JWT> أو X-API-Key: <API_KEY>
     - Body (JSON): { "sessionId": "...", "to": "965...@s.whatsapp.net", "message": "نص الرد" }

٣) تحتاج إلى مفتاح API (أو JWT) للمستخدم صاحب الجلسة حتى يستطيع n8n استدعاء
   /api/v1/messages/send-text نيابة عنه.

هذه الطريقة مرنة لكن تحتاج تكوين استدعاء API الإرسال من n8n.

───────────────────────────────────────────────────────────────────────────────
  الطريقة ٣ — تكامل OpenAI / Dify / Flowise من Omdaa
───────────────────────────────────────────────────────────────────────────────

المشروع يحتوي على تكاملات جاهزة:
  • integrations/chatbot/openai  — OpenAI (Chat Completion أو Assistant).
  • integrations/chatbot/dify     — Dify.
  • integrations/chatbot/flowise — Flowise.

إذا وُجدت في الواجهة شاشة لربط جلسة واتساب بـ "Chatbot" (OpenAI/Dify/Flowise)،
فيمكنك تفعيل الرد التلقائي من هناك دون استخدام n8n. المسار يعتمد على وجود
واجهة "Connect chatbot" أو "N8N Bot" في الفرونت اند.

───────────────────────────────────────────────────────────────────────────────
  ملخص سريع — أسرع طريقة للبدء
───────────────────────────────────────────────────────────────────────────────

1. في .env: N8N_ENABLED=true
2. في Omdaa: إنشاء N8N Bot للجلسة، رابط الويب هوك = رابط الـ Webhook في n8n.
3. في n8n: Workflow = Webhook (POST) → عقدة AI (مثل OpenAI Chat) → Respond to Webhook
   مع body مثل: { "output": "الرد النصي" }.
4. تفعيل الـ Workflow وتجربة إرسال رسالة واتساب للرقم المرتبط بالجلسة.

بعد ذلك ستصل الرسالة إلى n8n، يُنشئ الـ AI الرد، وOmdaa يرسله تلقائياً كرسالة واتساب.

═══════════════════════════════════════════════════════════════════════════════