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

حول الإجراءات

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

إجراءات السجل

إنشاء سجل جديد

يضيف سجل جديد إلى كائن محدد. الإعداد:
  • اختر الكائن المستهدف
  • املأ الحقول الضرورية والاختيارية
  • استخدم البيانات من الخطوات السابقة أو أدخِل القيم يدويًا لملء الحقول
المخرجات: بيانات السجل المنشأ حديثاً متاحة للاستخدام في الخطوات التالية.

تحديث السجل

يقوم بتعديل سجل موجود في كائن محدد. الإعداد:
  • اختر الكائن المستهدف
  • اختر السجل المحدد لتحديثه.
    • يمكنك إما اختيار سجل ثابت، باستخدام القائمة المنسدلة التي تعرض جميع السجلات المتاحة.
    • أو يمكنك اختيار السجل ديناميكيًا بتحديد سجل تم العثور عليه في خطوة سابقة، باستخدام (x+). لا يمكنك البحث عن السجل بناءً على معايير مختلفة في هذه المرحلة. إذا لم تكن قد حدّدت السجل بعد، فأضِف خطوة Search Record قبل خطوة Update Record.
  • اختر الحقول لتعديل القيم وأدخل القيم الجديدة
المخرجات: بيانات السجل المحدثة متاحة للاستخدام في الخطوات التالية.

حذف السجل

يزيل سجلاً من كائن محدد. التكوين:
  • اختر الكائن المستهدف
  • اختر السجل المحدد لحذفه
المخرجات: تظل بيانات السجل المحذوف متاحة للاستخدام في الخطوات التالية.

البحث في السجلات

يجد السجلات داخل كائن معين باستخدام شروط التصفية. التكوين:
  • اختر الكائن للبحث
  • حدد معايير التصفية لتضييق النتائج
  • قم بتكوين الفرز والقيود
المخرجات: تعيد السجلات المطابقة التي يمكن استخدامها في الخطوات اللاحقة.
الحد: تعيد Search Records بحد أقصى 200 سجل. إذا كنت بحاجة إلى معالجة المزيد، فأضِف عوامل تصفية محددة لتقليل النتائج أو استخدم عمليات سير عمل مجدولة للمعالجة على دفعات.
أفضل الممارسات: استخدم الفروع بعد Search Records للتعامل مع سيناريوهات “تم العثور” مقابل “لم يتم العثور”.

إدراج أو تحديث سجل

ينشئ سجلًا جديدًا أو يحدّث سجلًا موجودًا استنادًا إلى معايير المطابقة. يكون هذا مفيدًا عندما لا تكون متأكدًا مما إذا كان السجل موجودًا بالفعل. التكوين:
  • اختر الكائن المستهدف
  • لاحظ الحقول التي يمكن استخدامها للمطابقة: email لـ People، وdomain لـ Companies، وID لأي كائن، أو أي حقل مُعلَّم كـ Unique. ستحتاج إلى تعبئة واحد على الأقل من هذه الحقول أدناه.
  • املأ قيم الحقول. لا تنسَ تعبئة معرّف فريد واحد على الأقل.
تعمل المطابقة عادةً بشكل أفضل عند إضافة معرّف فريد واحد فقط. على سبيل المثال، ستطابق لقطة الشاشة أدناه الشركات استنادًا إلى domain الخاص بها. لا تكون قيمة ID مطلوبة بالضرورة.
  • استخدم البيانات من الخطوات السابقة لملء الحقول
كيف يعمل:
  1. يبحث عن سجل يطابق معاييرك
  2. إذا تم العثور عليه → يحدّث السجل الموجود
  3. إذا لم يُعثر عليه → ينشئ سجلًا جديدًا
المخرجات: بيانات السجل التي تم إنشاؤها أو تحديثها متاحة للاستخدام في الخطوات التالية.

إجراءات التدفق

مكرر

يتكرر عبر مصفوفة من السجلات المُعادة من خطوة سابقة، مما يتيح لك تنفيذ إجراءات على كل سجل بشكل فردي. التكوين:
  • اختر مصفوفة السجلات من خطوة سابقة (مثل نتائج البحث عن السجلات، أو من مشغل يدوي مع إتاحة التنفيذ بالجملة، أو من عقدة كود)
  • حدد الإجراءات لتنفيذها على كل سجل في الحلقة.
  • يمكنك إضافة عدة إجراءات داخل المُكرِّر.
  • عند استخدام تفرعات داخل المُكرِّر، تأكد من أن تتصل الخطوة الأخيرة من كل تفرع بالمُكرِّر لإغلاق الحلقة.
  • الوصول إلى حقول Current Item: لاستخدام حقول السجل الجاري معالجته، انقر على خطوة المُكرِّر، ثم اختر العنصر الحالي. ستُعرَض قائمة الحقول المتاحة من ذلك السجل ويمكن اختيارها لاستخدامها في الإجراءات اللاحقة.

تصفية

يقوم بتصفية السجلات بناءً على الشروط المحددة، مما يسمح فقط للسجلات التي تلبي المعايير بالمرور. التكوين:
  • اختر السجل لتصفيته
  • حدد شروط ومعايير التصفية
  • قم بتكوين السجلات التي يجب أن تمر إلى الخطوات اللاحقة
  1. المخرجات: عُقد التصفية لا تُرجِع بيانات — فهي تعمل كبوابات. إذا تم استيفاء الشروط، يتابع سير العمل. وإلا سيتوقف سير العمل عند ذلك الفرع.
  2. يمكن استخدام العامل IS مع الحقول الرقمية. يعمل كأنه EQUAL.

التأخير

يُوقف تنفيذ سير العمل لمدة محددة أو حتى تاريخ/وقت معين. أنواع التأخير:
النوعالوصف
المدةالانتظار لمدة زمنية محددة (أيام، ساعات، دقائق، ثوانٍ)
تاريخ مُجدولالانتظار حتى تاريخ ووقت محددين
إعدادات المدة:
  • تعيين الأيام والساعات والدقائق و/أو الثواني
  • دمج وحدات متعددة (مثل يومين و4 ساعات)
إعدادات التاريخ المُجدول:
  • اختر تاريخًا ووقتًا
  • يمكن الإشارة إلى حقل تاريخ من خطوة سابقة (مثل المتابعة بعد 3 أيام من اجتماع)
حالات الاستخدام:
  • انتظر 24 ساعة قبل إرسال بريد متابعة إلكتروني
  • إيقاف مؤقت حتى تاريخ إغلاق الفرصة
  • جدولة الإجراءات ضمن ساعات العمل
لا يمكن أن يكون التاريخ المُجدول في الماضي. إذا استُخدم حقل تاريخ من خطوة سابقة وكان التاريخ قد مضى بالفعل، فسيفشل سير العمل.
الحدود والرصيد:
  • لا يوجد حد أقصى للمدة — يمكنك تعيين تأخيرات بالدقائق أو الأيام أو الأسابيع أو أكثر
  • يُستهلَك رصيد واحد عند تنفيذ عقدة التأخير، بغض النظر عن المدة
  • لا يُستهلك أي رصيد أثناء الانتظار — تأخير 5 دقائق يكلف مثل تأخير 5 أيام

إجراءات الاتصال

إرسال البريد الإلكتروني

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

نموذج

يعرض نموذجاً أثناء تنفيذ سير العمل لجمع مدخلات المستخدم. يمكن بعد ذلك استخدام الردود في الخطوات اللاحقة لإنشاء سجلات أو إرسال رسائل بريد إلكتروني أو تنفيذ أي إجراء آخر بناءً على المُدخل.
تم تصميم النماذج للمشغلات اليدوية فقط. بالنسبة لمهام سير العمل مع محركات أخرى (سجل تم إنشاؤه، تم تحديثه، إلخ)، يمكن الوصول إلى النماذج فقط من خلال واجهة تشغيل سير العمل، وهو ليس التجربة المتوقعة. سيتم إصدار مركز الإشعارات في عام 2026 لدعم النماذج في مهام سير العمل المؤتمتة بشكل صحيح.
التكوين:
  • قم بتهيئة الحقول التي سيُطلب من المستخدمين تعبئتها. لكل حقل، اختر
    • نوعًا من بين: نص، رقم، تاريخ، سجل مُعطى، حقل اختيار. حقول الاختيار من جميع الكائنات متاحة.
    • تسمية
    • قيمة افتراضية ضمن Placeholder (اختياري)
  • حرّر عنوان النموذج
المخرجات: استجابات النموذج متاحة للاستخدام في الخطوات اللاحقة. مثال: يتوفر سير العمل “Quick Lead” افتراضيًا في جميع مساحات العمل، وهو متاح في أي مكان ضمن قائمة الأوامر Cmd + K. كيفية تعبئة النموذج:
  • شغّل سير العمل اليدوي من قائمة الأوامر Cmd K
  • املأ النموذج المعروض في اللوحة الجانبية ثم انقر Submit.
لا يمكن جعل الحقول إلزامية.

إجراءات التكامل

كود

يشغل جافا سكريبت مخصص ضمن سير العمل الخاص بك. التكوين:
  • الوصول إلى المتغيرات من الخطوات السابقة. يمكنك تعديل أسماء المتغيرات ديناميكيًا.
  • اكتب شيفرة جافا سكريبت في المحرر
  • إرجاع المتغيرات للاستخدام في الخطوات اللاحقة
  • اختبر الكود مباشرة في الخطوة
إذا كنت بحاجة إلى استخدام مفاتيح API خارجية في كودك، فيجب إدخالها مباشرةً في جسم الدالة. لا يمكنك تكوين مفاتيح API في مكان آخر والإشارة إليها في الدالة المنطقية.
هل تعمل مع المصفوفات؟ قد تأتي المصفوفات من أنظمة خارجية أو من خطوات سابقة على هيئة سلاسل نصية. راجع كيفية التعامل مع المصفوفات في إجراءات Code للحل.
انقر على أيقونة المربع في أعلى يمين محرر الكود لعرضه بملء الشاشة — فهذا مفيد لأن عرض المحرر الافتراضي محدود.

طلب HTTP

يرسل طلبًا إلى واجهة برمجية خارجية كجزء من سير العمل الخاص بك. التكوين:
  • ادخل عنوان رابط واجهة برمجية. يمكن استخدام معاملات من خطوات سابقة.
  • اختر طريقة HTTP (GET, POST, PUT, PATCH, DELETE)
  • أضف الرؤوس والقيم المطلوبة
  • قدّم مثالًا للمخرجات لمعاينة البنية

إجراءات الذكاء الاصطناعي

وكيل ذكاء اصطناعي - قريبًا

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