الدوال

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

معلومات

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

يرجى التواصل مع الدعم لطلب صلاحياتك أو تحديثها إذا كنت بحاجة إلى الوصول إلى ميزات إدارة الدوال.

---

المعالجة المعقدة للأحداث

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

واجهة إدارة الدوال

توفّر واجهة إدارة الدوال في MonoChat بيئة سهلة الاستخدام لإنشاء الدوال المخصصة وتحديثها وإدارتها. فيما يلي المكونات الرئيسية ووظائفها:

إنشاء دالة

1. الاسم: أدخل اسم الدالة.
2. المخرجات: عرّف مخرجات الدالة.
3. محدّد الدالة: اختر دالة موجودة أو أنشئ دالة جديدة.
4. نوع الدالة: اختر نوع الدالة من الخيارات المتاحة، مثل مهمة Cron أو نقطة نهاية API أو إعداد تطبيق مخصص أو عقدة تدفق مخصصة.

أنواع الدوال

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

2. دالة من جانب الخادم:
   الدالة من جانب الخادم هي دالة أو روتين يعمل على الخادم بدلًا من جهاز المستخدم (جانب العميل). تتعامل مع العمليات الخلفية مثل استعلامات قواعد البيانات ومنطق العمل أو التكامل مع الخدمات الأخرى، مما يضمن عمليات آمنة وفعّالة.

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

4. أداة AI:
   أداة AI هي مكوّن برمجي أو ميزة تستخدم الذكاء الاصطناعي لتنفيذ مهام مثل تحليل البيانات ومعالجة اللغة الطبيعية والتعرف على الصور أو الأتمتة. تعزز سير العمل بإضافة قدرات ذكية مثل التنبؤ والتوصية والأتمتة.

5. مهمة Cron: مهمة Cron هي مهمة مجدولة تعمل تلقائيًا على خادم في فترات أو أوقات محددة. تُستخدم غالبًا للمهام المتكررة مثل إرسال رسائل البريد الإلكتروني أو تنظيف قواعد البيانات أو إنشاء التقارير أو مزامنة البيانات دون تدخل يدوي.

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

تحديث الدالة

تتيح شاشة تحديث الدالة تعديل الدوال الموجودة. يمكنك تحديث الشيفرة وتغيير النوع وضبط الإعدادات الأخرى حسب الحاجة.

العروض والمجموعات المخصصة

يدعم MonoChat العروض المخصصة والمجموعات المخصصة، مما يتيح للشركات إنشاء واجهات مصممة خصيصًا وإدارة قواعد بياناتها الخاصة.

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

الإعدادات والمخرجات لدوال عقدة التدفق المخصصة

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

عندما يكون نوع الدالة عقدة تدفق مخصصة، تعرض أدراج الإنشاء والتحديث محرّر JSON باسم إعدادات العقدة ومخرجاتها (JSON):

{
  "description": "Routes the conversation to a team based on the selected department.",
  "descriptions": { "tr-TR": "Seçilen departmana göre konuşmayı bir ekibe yönlendirir." },
  "parameters": [
    { "name": "department", "type": "select", "label": "Department", "labels": { "tr-TR": "Departman" }, "required": true,
      "options": [ { "value": "sales", "label": "Sales" }, { "value": "support", "label": "Support" } ] },
    { "name": "maxWaitMinutes", "type": "number", "label": "Max wait (minutes)", "default": 10 },
    { "name": "notifyManager", "type": "boolean", "label": "Notify the manager" }
  ],
  "outputs": [
    { "key": "assigned", "label": "Assigned", "labels": { "tr-TR": "Atandı" } },
    { "key": "noAgent", "label": "No agent available" }
  ]
}

المفتاح	الوصف
description / descriptions	نص يظهر أعلى درج العقدة. تحتوي descriptions على ترجمات بحسب اللغة (مثل en-US وtr-TR)؛ وdescription هو الاحتياطي.
parameters	إعدادات العقدة. لكل إعداد name (المفتاح الذي تقرأه شيفرتك)، وtype (text أو textarea أو url أو number أو boolean أو select)، وlabel / labels، وdescription / descriptions اختياري (يظهر كنص توضيحي للحقل)، وrequired وdefault، وللنوع select الخيارات options (value وlabel / labels).
outputs	مفاتيح المخرجات التي يمكن للدالة إرجاعها، لكل منها label / labels.

في مصمّم التدفقات، عندما تضيف عقدة عقدة تدفق مخصصة (ضمن عقد الدوال) وتختار هذه الدالة في الدالة، يعرض الدرج الوصف وحقلًا لكل معامل (معبأً بقيمته الافتراضية) ويملأ المخرجات بالمفاتيح والتسميات المعلنة. تُحفظ القيم على العقدة.

في الدالة، تصل القيم باسم payload.nodeParameters وتصل مخرجات العقدة باسم payload.nodeOutputs (key وlabel لكل منها). استدعِ resolve بمفتاح مخرج لمتابعة التدفق على ذلك المخرج:

CustomFunction(async function ({ sdk, payload }, reject, resolve) {
  const { department, maxWaitMinutes, notifyManager } = payload.nodeParameters

  // ... your logic ...

  resolve('assigned')
})

إذا أنهت الدالة بمفتاح لا يوجد له مخرج في العقدة، يتابع التدفق على عند المخرجات الأخرى؛ وإذا أطلقت خطأ، فعلى عند الفشل.

تلميح

تحتفظ التطبيقات التي تثبّتها من المتجر بمعرّفات دوالها عند تحديثها، لذا تواصل عقد الدوال وأدوات AI التي بنيتها على دوال تطبيق ما العمل بعد التحديث.

بنية المجلدات المتداخلة

تدعم إدارة الدوال في MonoChat بنية مجلدات متداخلة سهلة الاستخدام. يمكن للمستخدمين التنقل بين مجلدات ومجلدات فرعية مختلفة لتنظيم دوالهم بشكل منهجي. تتيح هذه البنية إدارة أفضل ووصولًا سهلًا إلى دوال محددة داخل المجلد المطلوب.

حالات الاستخدام

منطق العمل

• منطق مخصص: نفّذ قواعد عمل محددة ومنطقًا متخصصًا لعمليات تجارية فريدة، مثل حساب الخصومات ومعالجة الطلبات والتحقق أو الحسابات المخصصة. يتيح ذلك للشركات تكييف سير العمل والأتمتة وفق احتياجاتها.

التكامل مع الخدمات الخارجية

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

الواجهات المخصصة

• الواجهات المخصصة: طوّر لوحات معلومات أو نماذج إدخال بيانات مخصصة لاحتياجات عملك المحددة. يوفر ذلك واجهة مخصصة للوكلاء والموظفين، مما يعزز سهولة الاستخدام والكفاءة.

إدارة البيانات

• إدارة البيانات: عرّف مجموعات مخصصة لتخزين بيانات عملك الفريدة وإدارتها. يساعد ذلك في تنظيم المعلومات المهمة والحفاظ عليها، ويتيح سهولة الوصول والإبلاغ.

الأتمتة المجدولة

• الأتمتة المجدولة: استخدم مهام Cron لأتمتة المهام الروتينية، مثل إنشاء التقارير أو إجراء تحديثات النظام الدورية. يضمن ذلك إنجاز المهام الأساسية في وقتها دون تدخل يدوي، مما يحسّن الكفاءة التشغيلية.

أدوات AI

• أدوات AI: استفد من ميزات الذكاء الاصطناعي مثل معالجة اللغة الطبيعية والتحليلات التنبؤية أو الأتمتة لتعزيز اتخاذ القرارات وتبسيط سير العمل. تساعد أدوات AI الشركات على أتمتة المهام المعقدة واستخلاص الرؤى من البيانات وتقديم تجارب مستخدم أذكى.

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

معلومات

لمزيد من التفاصيل حول كيفية إنشاء الأحداث المخصصة، راجع صفحة توثيق SDK لدينا!