# الكتل والأنواع

## كيفية العمل مع الكتل

{% hint style="info" %}
يتيح لك MaviBot إنشاء روبوت محادثة من خلال تصميم هيكله على شكل مخطط انسيابي يتكوّن من كتل وأسهم.
{% endhint %}

A **كتلة** تمثل إجراءً أو حدثًا يحتاج الروبوت إلى معالجته أو تنفيذه.

{% hint style="danger" %}
**يرجى الانتباه!**

**قيود الكتل:**\
الحد الإجمالي لكل مخطط انسيابي لا يزيد عن **500 كتلة** من الأنواع التالية:

* **في كتلة البدء**
* **كتلة مُشغِّل**
  {% endhint %}

توجد اتصالات بين الكتل، حيث يمكنك تحديد شرط و/أو الوقت الدقيق للانتقال إلى الكتلة التالية.

{% hint style="info" %}
**كتل شرطية** تُستخدم لتشغيل الروبوت في ظروف محددة.\
**كتل غير شرطية** تعمل فقط عند الوصول إليها عبر الأسهم أو الاستدعاءات (والتي سنغطيها لاحقًا).
{% endhint %}

{% hint style="warning" %}
**يرجى الانتباه!**

**الكتل والاتصالات لها أولوية تنفيذ!**\
الكتل التي تم تعيين شرط لها سيتم تنفيذها دائمًا أولًا.

**أولوية تنفيذ الكتل والأسهم:**\
الـ **"بدء"** يتم تنفيذ الكتلة أولًا دائمًا:

* أولًا، يتم **"بدء"** تنفيذ الكتلة التي تم تعيين شرط لها في حقل الشرط.
* ثم، إذا وُجدت، يتم **"بدء"** تنفيذ الكتلة بدون شرط.

بعد ذلك، يتم تنفيذ الاتصال من الكتلة التي يوجد فيها العميل حاليًا (إذا كان العميل بالفعل داخل القمع).\
ثم:

* أخرى  **"بدء"** يحظر
* الـ **"مشغّل"** كتلة

إذا لم يتم العثور على استجابة مطابقة وكان **مساعد الذكاء الاصطناعي** مفعّلًا، فسيقوم المساعد بالرد (إذا كان شرط التشغيل يسمح بذلك).
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/b49a284d19f957a2f943fd8d7b3d763919c21773" alt="" width="267"><figcaption></figcaption></figure></div>

**تتشارك جميع الكتل بنية موحدة:**\
تحتوي كل كتلة على قائمة من الأقسام التي يمكنك تفعيلها أو تعطيلها حسب الحاجة.

<div data-with-frame="true"><figure><img src="/files/96e7c289ab5d7a3e4d1a8452144584bc06c7748a" alt=""><figcaption></figcaption></figure></div>

الـ **رسالة** يسمح لك القسم بتحديد نص الرسالة.\
يمكنك استخدام المتغيرات في النص بتطبيق التنسيق التالي: `#{variable_name}`.

## **القائمة المنبثقة**

تحتوي كل كتلة على قائمة منبثقة تتيح لك تنفيذ إجراءات محددة على الكتلة، بما في ذلك:

<div data-with-frame="true"><figure><img src="/files/4dad6ac12c7eeaca08b625deca48efeb28472cf7" alt="" width="563"><figcaption></figcaption></figure></div>

* **نسخ الكتلة:**

<div data-with-frame="true"><figure><img src="/files/d91e864c3f718f9321d877cee25ed7b6db8f3977" alt="" width="563"><figcaption></figcaption></figure></div>

* **حذف الكتلة:**

<div data-with-frame="true"><figure><img src="/files/3a018057113dd4a31b2cd0abdad24449ae6fb437" alt="" width="563"><figcaption></figcaption></figure></div>

* **نسخ الكتلة مع الربط**&#x20;

<div data-with-frame="true"><figure><img src="/files/493035cbb114c814874f5edd2fd684ede12e6eff" alt="" width="563"><figcaption></figcaption></figure></div>

* **الانتقال إلى ورقة أخرى:**

<div data-with-frame="true"><figure><img src="/files/5a07fc024c8d3cb39878ea6af7ec6dfcc6bef0c4" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="success" %}
**أولوية الكتل/الانتقالات ترتيبًا تنازليًا:**\
· البداية\
· الاتصالات\
· المُشغِّل
{% endhint %}

لنلقِ نظرة أقرب على كل نوع من أنواع الكتل: كيفية إنشائها وما تُستخدم له.\
لإنشاء الكتلة الأولى، ما عليك سوى النقر نقرًا مزدوجًا بزر الفأرة الأيسر على مساحة عمل المحرر (افتراضيًا، سيتم إنشاء كتلة بدء)، أو اختيار نوع الكتلة من القائمة.

لنلقِ نظرة أقرب على كل واحد منها.

## **كتلة الدردشة**

{% hint style="info" %}
إذا كان ينبغي ألا تحتوي الكتلة على أي نص، فأدخل `#{none}` في حقل الرد (وهذا هو الإعداد الافتراضي).
{% endhint %}

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

<div data-with-frame="true"><figure><img src="/files/cef526a7fd480d89384de32d8c4664f2d97ddea8" alt=""><figcaption></figcaption></figure></div>

## **في كتلة البدء**

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

مثال على إعداد رد فعل الروبوت على تحية العميل:

<div data-with-frame="true"><figure><img src="/files/6ad8ae74f1daf64dd4cadc24f27c0e7ab803e223" alt=""><figcaption></figcaption></figure></div>

سيستلم العميل الرسالة **"مرحبًا!"** كرد.

## كتلة العملاء المحتملين

كتلة العملاء المحتملين هي كتلة بدون شرط، ولونها أحمر.

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

<div data-with-frame="true"><figure><img src="/files/ba2a51550351b21b0d3dc303b3d6f258b77d5419" alt=""><figcaption></figcaption></figure></div>

## المشغّل

**كتلة مُشغِّل** هي كتلة رمادية داكنة.\
من الناحية الوظيفية، فهي مشابهة لكتلة البداية ، مع الاختلاف الوحيد وهو أن العميل لا ينتقل إلى هذه الكتلة.

<div data-with-frame="true"><figure><img src="/files/c43ba4ea7ec3560394b1a2ee90f01a662185f70e" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
أولوية هذه الكتلة، مقارنة بالكتل الشرطية الأخرى، هي الأدنى — أي إنها ستُفعَّل في النهاية.
{% endhint %}

## البديل

**كتلة البديل** هي كتلة رمادية. لا تحتوي على شروط مثل **Trigger t** الكتلة، ولا يمكن الانتقال إليها.

<div data-with-frame="true"><figure><img src="/files/e8957a9cb459745f65229bdb4b5f96b61ad93007" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
يمكنك استخدام كتل البديل لإنشاء اتصال مؤقت أو، على سبيل المثال، للتحقق من البيانات التي أدخلها العملاء! وبما أن المستخدم لا يمكنه الانتقال إلى هذه الكتل، فلا يمكنه أيضًا الخروج من التدفق الرئيسي.

يمكن استخدام كتل البديل أيضًا لتشغيل سلاسل البث.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ar/chatbot/builder/setting/types.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.