# الاتصال مع محفّز

## الحق**ل المُفعِّل**

يحدِّد هذا الحقل المُفعِّل للانتقال إلى كتلة أخرى.

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

{% hint style="success" %}
يمكن تعيين مُفعِّل الانتقال بواسطة كلمة مفتاحية (callback). يمكنك قراءة المزيد عن [المُفعِّلات ونوع المطابقة **هنا**](/doc/ar/chatbot/builder/setting/trigger/type.md).
{% endhint %}

{% hint style="info" %}
إذا كان **المشغّل** الحقل في الاتصال فارغًا، فسيحدث الانتقال عند أي كلمة أو عبارة من المستخدم.
{% endhint %}

### مُفعِّلات الاتصال

الاتصال الذي يحتوي على مُفعِّل هو اتصال يفعِّل الانتقال فقط إذا تم استيفاء مُفعِّل معيّن.

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

يمكن تعيين مُفعِّلات الاتصالات:

* بواسطة كلمة معيّنة (callback) — محددة في **المشغّل** الحقل.\
  على سبيل المثال، عندما يتم الضغط على الزر **NO** ، يردّ البوت بـ **"أتمنى لك يومًا سعيدًا!"**. يمكنك قراءة المزيد عن هذا **هنا**.\
  وفي الوقت نفسه، يمكن تحديد الكلمات (callbacks) التي يجب أن يتجاهلها السهم (تُستخدم غالبًا عندما يكون **المشغّل** الحقل فارغًا).
* من خلال تحليل قيم المتغيرات — محدد في **المتغير** الحقل. يمكنك قراءة المزيد عن هذا **هنا**.

بالإضافة إلى ذلك، من الممكن إنشاء أزرار لوحة المفاتيح (reply). للقيام بذلك، ما عليك سوى إدخال نص الزر في **المشغّل** الحقل وتفعيل **عرض كزر** المفتاح.

يمكنك أيضًا تحديد فحص لمدخلات المستخدم في مُفعِّل الاتصال باستخدام التعابير النمطية:

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

يمكنك أيضًا استخدام متغير للمقارنة:

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

<mark style="color:$warning;">**ومع ذلك، وفقًا لقواعد الصياغة، لا يمكنك تحديد عدة مُفعِّلات مقارنة لنفس المتغير في مُفعِّل واحد.**</mark>

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

إذا كنت بحاجة إلى التحقق من عدة قيم في شرط واحد، فاستخدم العاملين **و (&&)**, **أو (||)**، وغيرها.

{% hint style="info" %}
[يمكنك قراءة المزيد عن مقارنة المتغيرات في المقال الذي يحمل الاسم نفسه.](/doc/ar/chatbot/functions/almtghyrat.md)
{% endhint %}

### نوع المطابقة

افتراضيًا، **"المطابقة التقريبية"** هي المحددة.&#x20;

في MaviBot، توجد خمسة أنواع من مطابقة المُفعِّلات:

1. المطابقة التقريبية؛\
   سيتم التحقق من الشرط بحثًا عن مطابقات جزئية مع إدخال المستخدم. وهذا يعني أنه إذا أدخل المستخدم كلمة أو عبارة تحتوي على أخطاء أو نهايات مختلفة، فسيظل الشرط يُفعَّل.
2. مطابقة الكلمات المفتاحية؛\
   إذا تم اختيار هذا الخيار، فسيتم تفعيل الانتقال إذا كان ردّ المستخدم يحتوي على كلمة مفتاحية واحدة على الأقل من حقل "المُفعِّل".
3. مطابقة RegEx؛\
   يتحقق الشرط من ردّ المستخدم مقابل التعبير النمطي الذي تحدده.
4. المطابقة الدقيقة؛\
   يتحقق هذا الشرط من الكلمة أو العبارة مطابقَةً تامة، دون أخطاء أو تعديلات.
5. البحث الدلالي.\
   هذا هو البحث الذكي عن الدلالة في رسالة العميل باستخدام الذكاء الاصطناعي.

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

{% hint style="info" %}
على سبيل المثال: التحقق من صيغة رقم الهاتف، البريد الإلكتروني، إدخال الأرقام فقط، إلخ. يمكنك قراءة المزيد عن [التعابير النمطية **هنا**.](/doc/ar/chatbot/functions/regex.md)
{% endhint %}

### **إعدادات الاتصال المتقدمة**

لفتح الإعدادات المتقدمة، انقر على **"الإعدادات المتقدمة"** أسفل **نوع المطابقة** الحقل، كما هو موضح في الصورة أدناه.

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

### تجاهل المُفعِّلات

أدخل "الكلمات السلبية" هنا — وهي الكلمات أو العبارات التي يجب ألا يردّ عليها البوت عند التحقق من المُفعِّل.

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

### المتغير

يعمل المتغير للمقارنة مع المُفعِّل أو مع ضربة "تجاهل المُفعِّلات". أي يجب استيفاء كلٍّ من المُفعِّل والمُفعِّل في المتغير.

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

إذا حدَّدتَ اسم المتغير فقط في حقل متغير المقارنة، دون تعبير، فستتم مقارنة الشرط بقيمة المتغير بدلًا من إدخال المستخدم.

{% hint style="warning" %}
يجب أن تحدده بدون `#{}`، باستخدام اسم المتغير فقط.
{% endhint %}

في المثال الموضح في الصورة أدناه، سيحدث الانتقال إذا كانت قيمة المتغير "AGE":

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

أنشأ المثال أربع كتل:

1. أ **في كتلة البدء** لإدخال البوت: تطلب هذه الكتلة عمر العميل.
2. أ **الكتلة الثانية** مع اتصال يجمع بيانات العميل في متغير (سيساعد هذا المتغير على توجيه العميل عبر القمع).
3. **كتلتان** متصلتان بالكتلة السابقة:
   * إذا كان العميل **أكبر من 18**، فسيتم إرسال الرسالة "الرسالة الثانية".
   * إذا كان العميل **أقل من 18**، فسيتم إرسال الرسالة "عذرًا، لا يمكنك الكتابة إلى البوت".

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

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

{% hint style="success" %}
تعرّف على المزيد حول اتصالات جمع البيانات في المقال "[اتصال مع جمع البيانات](/doc/ar/chatbot/builder/alatsalat/data.md)".
{% endhint %}

الخطوة 1. أنشئ أربع كتل.

<figure><img src="/files/5389e197fcad6c6dea44ef5373094681c7631204" alt="" width="375"><figcaption></figcaption></figure>

الخطوة 2. وصّل كتلة "Start" بكتلة "Chat" الثانية.

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

الخطوة 3. انتقل إلى إعدادات الاتصال وفعّل مربع الاختيار "جمع البيانات".

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

الخطوة 4. أدخِل المتغير في حقل "بيانات الإدخال" واحفظ إعدادات الاتصال.

<figure><img src="/files/3748c4f0410f24abc6b16eaec590a737bf59065d" alt="" width="563"><figcaption></figcaption></figure>

الخطوة 5. وصّل الكتلة الثانية بالكتل المتبقية.

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

الخطوة 6. انتقل إلى إعدادات الاتصال وأدخِل 'age ≥ 18' في حقل "المتغير".

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

الخطوة 7. اضبط المؤقت على "0 ثانية" في الموصل نفسه.

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

الخطوة 8. اضبط القيمة على "age < 18"، وقم بتهيئة الموصل بالطريقة نفسها كما في السابق.

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

{% hint style="success" %}
تم! لقد تعلّمت الآن كيفية إنشاء بوت يتحقق من عمر العميل ويرسل رسالة بناءً على عمره!
{% endhint %}

### الأولوية

افتراضيًا، تُضبط قيمة الأولوية على 10. كلما كانت أولوية الشرط أعلى، تم التحقق منه في وقت أبكر.

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

### مُفعِّل خاص بـ Callback فقط

إذا تم تفعيل هذا المفتاح، فلن ينتقل العميل إلى الكتلة التالية المتصلة بالسهم إلا إذا استلم النظام callback.

<div data-with-frame="true"><figure><img src="/files/2bbe1540e2d2bf501823f81e615bebbe928d0b17" alt="" width="386"><figcaption></figcaption></figure></div>


---

# 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/alatsalat/trigger.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.