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

سير عمل n8n

يمكن لـ AI-School بدء سير عمل n8n عبر production webhook. يكون ذلك مفيدًا عندما تريد تشغيل عملية آلية خارج AI-School، مثل إنشاء مهمة، أو تحديث سجل CRM، أو بدء مسار تقارير، أو تمرير بيانات نموذج إلى نظام آخر.

مثال: مقالة أخبار على موقع المدرسة​

لنفترض أن المدرسة أنشأت workflow في n8n ينشر مقالة أخبار على موقع WordPress. في AI-School، يُدخل المستخدم نصًا قصيرًا فقط، مثل بضع جمل عن أسبوع مشاريع أو يوم رياضي أو يوم مفتوح. بهذا النص يتم تشغيل workflow في n8n.

بعد ذلك يمكن لـ workflow في n8n مثلًا أن:

  1. يحوّل النص القصير إلى مسودة جيدة باستخدام LLM node و prompt مناسب لنبرة المدرسة.
  2. ينشئ illustration مناسبة باستخدام LLM node ثانية، مثلًا باستخدام ألوان المدرسة وبأسلوب توضيحي واضح.
  3. يجهز أو ينشر النص والصورة كمنشور مدونة على موقع WordPress.

هكذا يعمل AI-School و n8n معًا: في AI-School يختار المستخدم workflow ويدخل المعلومات المطلوبة. بعد ذلك ينفذ n8n الخطوات الآلية ويتأكد من ظهور مقالة الأخبار بشكل مرتب على الموقع.

ماذا تفعل هذه التكاملة؟​

سير عمل n8n في AI-School ليس دردشة AI. يتم بدء سير العمل مباشرة من نظرة عامة workflows.

  • إذا لم تكن في سير العمل حقول، يتم تشغيل webhook فورًا.
  • إذا كانت في سير العمل حقول، تظهر نافذة أولًا. يملأ المستخدم النموذج ثم يبدأ سير العمل بالزر.
  • تُرسل القيم المدخلة كـ JSON في طلب POST إلى n8n webhook.

إنشاء سير عمل n8n في AI-School​

يسجل المسؤول سير العمل كما يلي:

  1. انتقل إلى Assistants.
  2. افتح Workflows.
  3. اختر New n8n workflow.
  4. أدخل اسم سير العمل و Production URL الخاص بـ n8n.
  5. اضبط Header authentication باستخدام اسم header وقيمة header سرية.
  6. أضف اختياريًا الحقول التي يجب إرسالها في طلب POST.
  7. احفظ سير العمل.

الحقول​

  • الحقول اختيارية.
  • لكل حقل اسم حقل واحد ونوع واحد.
  • أنواع الحقول المدعومة هي نص قصير، نص طويل، رقم، نعم/لا وتاريخ.
  • يجب ملء الحقول الإلزامية قبل بدء سير العمل.
  • يصبح اسم الحقل هو المفتاح في JSON body المرسل إلى n8n.

إنشاء سير عمل متوافق في n8n​

  1. أنشئ سير عمل جديدًا في n8n.
  2. أضف Webhook Trigger كأول node.
  3. اضبط HTTP Method على POST.
  4. كوّن Header authentication في n8n. استخدم نفس اسم header والقيمة التي تدخلها في التطبيق.
  5. انسخ Production URL للـ webhook. لا تستخدم عنوان الاختبار.
  6. فعّل سير العمل في n8n.
  7. استخدم JSON body المستلم في n8n nodes التالية.

مثال على JSON body​

إذا عرّفت حقولًا باسم prompt و customerName و date، فسيستقبل n8n مثلًا JSON body التالي:

{
  "prompt": "أنشئ ملخصًا قصيرًا للطلب.",
  "customerName": "منظمة مثال",
  "date": "2026-09-22"
}

قيود مهمة​

  • يتم دعم Webhook Triggers فقط.
  • يتم دعم عناوين production webhook URLs فقط.
  • يتم رفض عناوين اختبار webhook التي تحتوي على /webhook-test/.
  • يتم دعم POST فقط.
  • يتم دعم generic header authentication فقط.
  • تُعامل قيمة header كسر داخل التطبيق.
  • يتم تحديد tenant على الخادم من المستخدم المسجل الدخول، وليس من قيمة يرسلها المتصفح.

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

  • 404 أو webhook غير مسجل: فعّل سير العمل في n8n واستخدم Production URL.
  • خطأ مصادقة: تحقق من أن اسم header والقيمة متطابقان تمامًا في النظامين.
  • بيانات مفقودة: تحقق من أن أسماء الحقول في التطبيق تطابق المفاتيح التي يتوقعها n8n.
  • لا يوجد طلب في n8n: تحقق من أن سير العمل يبدأ بـ Webhook Trigger ويستخدم POST.
WhatsApp