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

إنشاء أول سير عمل آلي

ما هو​

يرشدك هذا الدليل خلال إنشاء سير عمل آلي باستخدام محرر سير العمل المرئي في BotBat. ستقوم بإعداد مشغّل وإضافة عقد إجراءات (إرسال رسالة، تأخير، تفريع شرطي، استدعاء API) واختبار سير العمل في المحاكي وتفعيله للاستخدام الإنتاجي.

متى تستخدمه​

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

الخطوة 1: افتح قائمة سير العمل​

افتح الشريط الجانبي في وحدة تحكم BotBat وانقر على سير العمل. تعرض هذه الصفحة جميع سير العمل في مساحة عملك، مرتبة حسب الحالة: نشط، مسودة، ومتوقف مؤقتًا. يعرض كل صف اسم سير العمل ونوع المشغّل وآخر وقت تنفيذ وإجمالي التنفيذات والحالة الحالية.

Workflow list page showing existing workflows with status indicators and execution counts

الخطوة 2: أنشئ سير عمل جديد​

انقر على زر سير عمل جديد في الزاوية العلوية اليمنى. في نافذة الإنشاء، أدخل اسمًا وصفيًا لسير العمل (مثل "سلسلة الترحيب" أو "تأكيد الطلب"). اختر اسمًا يوضّح غرض سير العمل بوضوح، لأن هذا الاسم يظهر في السجلات والتحليلات وقائمة سير العمل.

الخطوة 3: اختر نوع المشغّل​

يحدد المشغّل الحدث الذي يبدأ سير العمل. يجب أن يحتوي كل سير عمل على عقدة مشغّل واحدة بالضبط في أعلى اللوحة. عند حدوث الحدث المحدد، ينشئ BotBat تنفيذًا جديدًا ويبدأ معالجة أول عقدة متصلة.

Trigger selection panel showing available trigger types with descriptions
نوع المشغّلالوصفمثال على حالة الاستخدام
رسالة مستلمةيعمل عندما يرسل جهة اتصال رسالة تطابق معايير محددة (كلمة مفتاحية، تعبير نمطي، أو أي رسالة).رد تلقائي على الرسائل التي تحتوي على "التسعير" أو "العرض التوضيحي".
حدثيعمل عندما يحدث حدث متتبع، مثل order.completed أو contact.created أو حدث مخصص عبر API.إرسال رسالة شكر بعد حدث شراء.
جدوليعمل وفق جدول زمني مبني على cron في وقت وتكرار محددين.إرسال ملخص أسبوعي كل يوم اثنين الساعة 9:00 صباحًا بتوقيت UTC.
Webhookيعمل عندما يرسل نظام خارجي طلب POST إلى عنوان URL الفريد لسير العمل.تشغيل إجراءات عندما ترسل بوابة دفع استدعاءً.
إضافة علامة لجهة الاتصاليعمل عندما تُضاف علامة محددة إلى ملف جهة اتصال.بدء سلسلة تأهيل عند وسم جهة اتصال بـ "عميل-جديد".
تغيير خاصية جهة الاتصاليعمل عندما تتغير قيمة خاصية محددة لجهة اتصال.إشعار مدير الحساب عند تغيير فئة خطة جهة الاتصال.

الخطوة 4: اسحب عقد الإجراءات من لوحة الأدوات​

تحتوي اللوحة الجانبية اليسرى على لوحة الإجراءات التي تسرد جميع أنواع العقد المتاحة. اسحب العقد من لوحة الأدوات إلى اللوحة لبناء منطق سير العمل.

Visual workflow editor showing the canvas with the action palette open on the left side
نوع الإجراءالوصفحقول التهيئة
إرسال رسالةيرسل رسالة إلى جهة الاتصال عبر أي قناة متصلة. يدعم النصوص والصور والأزرار والقوالب.القناة، محتوى الرسالة، اختيار القالب، مرفقات الوسائط.
تأخيريوقف تنفيذ سير العمل لمدة محددة قبل المتابعة إلى العقدة التالية.المدة (دقائق، ساعات، أو أيام).
شرطيقيّم تعبيرًا منطقيًا ويفرّع سير العمل إلى مسارات صحيح/خاطئ بناءً على النتيجة.الخاصية، العامل، القيمة، وتجميع AND/OR اختياري.
استدعاء APIينفّذ طلب HTTP (GET، POST، PUT، DELETE) إلى خدمة خارجية ويلتقط الاستجابة.العنوان، الطريقة، الرؤوس، النص، المهلة، واسم متغير الاستجابة.
تحديث جهة الاتصاليعدّل خصائص جهة الاتصال أو يضيف/يزيل العلامات أو يحدّث الحقول المخصصة.اسم الخاصية، القيمة الجديدة، إضافة/إزالة العلامات.
تعيين وكيليوجّه المحادثة إلى وكيل محدد أو مجموعة وكلاء في صندوق الوارد.اختيار الوكيل أو المجموعة، مستوى الأولوية.
نهايةينهي تنفيذ سير العمل عند هذه النقطة. يُستخدم في نهاية الفروع لتحديد الاكتمال.لا شيء.

الخطوة 5: هيّئ كل عقدة​

انقر على أي عقدة لفتح لوحة إعداداتها على الجانب الأيمن من اللوحة. لكل نوع عقدة مجموعته الخاصة من الحقول المطلوبة والاختيارية. املأ جميع الحقول المطلوبة (المميزة بعلامة النجمة) وراجع الإعدادات الاختيارية.

Action node settings panel open on the right side with fields filled in for a Send Message node

بالنسبة لعقد إرسال الرسالة، قم بتأليف محتوى الرسالة باستخدام المحرر. يمكنك إدراج متغيرات ديناميكية (مثل {{contact.firstName}} أو {{event.orderTotal}}) لتخصيص كل رسالة. حدد القناة من القائمة المنسدلة، وإذا كنت تستخدم WhatsApp، اختر قالب رسالة معتمدًا.

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

الخطوة 6: اربط العقد​

اسحب الروابط من منفذ إخراج عقدة إلى منفذ إدخال العقدة التالية لتحديد تدفق التنفيذ. لعقد الشرط، يجب ربط كلٍّ من فرعي صحيح وخاطئ. ترك فرع غير متصل يتسبب في خروج جهات الاتصال التي تصل إلى ذلك المسار من سير العمل بصمت.

Condition node on the canvas with true and false branches connected to separate action nodes

يمكنك إنشاء مسارات متوازية بربط مخرج عقدة واحدة بعقد متعددة. يعالج محرك سير العمل الفروع المتوازية بالتزامن. راجع التدفق الكامل من المشغّل إلى النهاية للتأكد من أن كل مسار ينتهي بشكل صحيح.

الخطوة 7: اختبر بالمحاكي​

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

Workflow simulator panel showing step-by-step execution progress with sample data and node results

يبرز المحاكي كل عقدة أثناء تنفيذها، ويعرض بيانات الإدخال والإخراج ومدة التنفيذ. لعقد الشرط، يوضّح أي فرع تم اتخاذه ولماذا. لعقد استدعاء API، يعرض تفاصيل الطلب والاستجابة.

شغّل ثلاثة سيناريوهات اختبار على الأقل: مسار ناجح حيث تتحقق جميع الشروط، ومسار بديل حيث يُقيَّم شرط بـ "خاطئ"، وحالة حدية ببيانات مفقودة أو غير متوقعة.

الخطوة 8: فعّل سير العمل​

بعد نجاح الاختبار، انقر على تفعيل في الزاوية العلوية اليمنى لجعل سير العمل مباشرًا. تتغير الحالة من "مسودة" إلى "نشط"، ويبدأ سير العمل في معالجة المشغّلات الحقيقية فورًا. يمكنك مراقبة أعداد التنفيذ ومعدلات النجاح من صفحة قائمة سير العمل.

لإيقاف سير العمل مؤقتًا، انقر على إيقاف مؤقت. سير العمل المتوقف يتوقف عن قبول مشغّلات جديدة لكنه يسمح بإكمال التنفيذات الجارية. لاستئناف التشغيل، انقر على تفعيل مجددًا.

الأخطاء الشائعة​

  • فروع شرطية مفقودة: إذا كانت عقدة شرط بها فرع غير متصل (صحيح أو خاطئ)، فإن جهات الاتصال التي تصل إلى ذلك الفرع تخرج من سير العمل بدون أي إجراء. اربط دائمًا كلا الفرعين، حتى لو أدى أحدهما إلى عقدة نهاية.
  • حلقات لا نهائية: سير عمل يشغّل نفسه (مثل مشغّل "رسالة مستلمة" يرسل رسالة تشغّل "رسالة مستلمة" مجددًا) ينشئ حلقة لا نهائية. استخدم فلاتر الكلمات المفتاحية أو فترات الانتظار أو علامات جهات الاتصال لمنع إعادة الدخول.
  • استدعاءات API غير مختبرة: يمكن أن تفشل استدعاءات API الخارجية بسبب انتهاء المهلة أو أخطاء المصادقة أو تنسيقات استجابة غير متوقعة. اختبر كل عقدة استدعاء API مع نقاط نهاية حقيقية في المحاكي وأضف فروع شرطية لمعالجة استجابات الأخطاء.
  • سير عمل أول معقد جدًا: محاولة بناء سير عمل من 20 عقدة في أول تجربة تجعل التصحيح صعبًا. ابدأ ببساطة ووسّع تدريجيًا.
تلميح

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

  • صفحة قائمة سير العمل
  • مربع حوار إنشاء سير العمل
  • اختيار المشغّل
  • المحرر المرئي
  • إعدادات العقدة
  • المحاكي
  • التفعيل