# القوائم والوسوم

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

يمكن استخدام القوائم من أجل:

* تصفية العملاء وتقسيمهم داخل مشروع
* تصدير البيانات

يمكنك تصدير قائمة كملف واستيرادها إلى مشروع MaviBot آخر.

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

#### **مزايا استخدام القوائم:**

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

يؤدي استخدام القوائم إلى تبسيط تقسيم الجمهور ويجعل التفاعل مع العملاء أكثر دقة وفعالية.

## كيفية إنشاء قائمة

يتم إنشاء القوائم في **"Lists"** علامة التبويب ضمن القسم نفسه.

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

انقر على **"إنشاء قائمة"** زر لفتح نافذة تحتوي على حقول إدخال حيث يمكنك إدخال اسم القائمة واختيار مجلد (إن وُجد) لإضافة القائمة إليه.

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

في **"Lists"** قسم، يمكنك فرز القوائم حسب معرّف القائمة أو أبجديًا (حسب الاسم):

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

تكمن قوة قوائم العملاء في مرونتها. يمكنك، على سبيل المثال، إضافة عميل واحد إلى **عدة قوائم في الوقت نفسه**.

يمكن أن تكون القوائم:

* مجمعة في مجلدات
* إعادة تسميتها
* حذفها (يبقى العملاء أنفسهم في قاعدة البيانات)
* تُستخدم لـ **إزالة جميع العملاء داخل قائمة** من المشروع

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

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

لعرض العملاء داخل قائمة:

1. انقر على القائمة لفتح القائمة الجانبية اليمنى.
2. انقر على **"عرض قائمة العملاء"** الزر.

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

ثم ستفتح نافذة جديدة من **"العملاء"** القسم، حيث يمكنك عرض جميع المستخدمين في تلك القائمة.

## كيفية أتمتة عملك باستخدام القوائم

يمكنك إضافة العملاء أو إزالتهم أو نقلهم بين القوائم تلقائيًا أثناء تشغيل الدردشة الآلية.

اعثر على مجموعة من **إجراءات القائمة** في أي كتلة من المنشئ:

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

عندما يكون **"الإجراء"** القسم مفعّلًا، يمكنك اختيار الإجراءات التي تريد تنفيذها على قوائمك.

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

بعد اختيار الإجراء، يمكنك تحديد القائمة المحددة التي سيُطبَّق عليها. يمكنك أيضًا تحديد عدة إجراءات مختلفة ضمن الكتلة نفسها — لا يوجد حد لعدد الإجراءات التي يمكنك إضافتها في كتلة واحدة.

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

يتم تنفيذ الأوامر بالترتيب الذي تظهر به في إعدادات الكتلة.

### التحقق مما إذا كان الشخص موجودًا في القائمة

لـ <mark style="color:green;">**التحقق مما إذا كان العميل موجودًا في القائمة**</mark>، يمكنك استخدام <mark style="color:green;">**`inlist (list_number)`**</mark> الدالة في **"Variable"** حقل للمقارنة داخل الكتل والاتصال.

نتيجة تنفيذ الدالة هي قيمة منطقية (صحيح أو خطأ).

`inlist(رقم القائمة) == True  -` العميل موجود في القائمة أو

`inlist(رقم القائمة) == False -` العميل غير موجود في القائمة.

<figure><img src="/files/ddb770f5a7b06a9c2bdf52c69d93359faafb122b" alt=""><figcaption></figcaption></figure>

يمكن العثور على رقم القائمة بالنقر على القائمة المطلوبة. في هذه الحالة، تُفتح القائمة اليمنى التي تحتوي على معلومات حول القائمة:

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

### وظائف أخرى متعلقة بالقوائم

{% hint style="info" %}
[يمكنك العثور على التعليمات المفصلة للعمل مع وظائف القوائم والوسوم هنا.](/doc/ar/chatbot/functions/alaalh-alhasbh/lists.md)
{% endhint %}

## **كيفية العمل مع القوائم يدوياً**

تحتوي كل قائمة على أزرار لـ:

* إضافة/إزالة العملاء من القائمة
* إطلاق حملة بريدية بناءً على القائمة
* تنزيل القائمة كملف

تتضمن قائمة السياق خيارات لـ:

* إضافة القائمة إلى مجلد
* تحرير القائمة
* حذف القائمة (يبقى العملاء في المشروع)
* إزالة جميع العملاء الموجودين في القائمة من المشروع

{% hint style="danger" %}

#### **تحذير**

**"إزالة أعضاء القائمة من المشروع"** تحذف هؤلاء العملاء نهائياً من المشروع. لا يمكن التراجع عن هذا الإجراء.
{% endhint %}

### إضافة العملاء إلى قائمة

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

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

{% hint style="warning" %}

#### مهم

عند إضافة العملاء الحاليين إلى قائمة **من ملف**، يجب أن يحتوي العمود الأول على **معرّفات العملاء الداخلية** ( `client_id` المتغير).
{% endhint %}

#### كيفية إضافة العملاء من ملف:

1. حدد **"العملاء من ملف"** نوع الفلتر:

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

2. بعد ذلك، ارفع قائمة العملاء بصيغة .CSV

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

لـ <mark style="color:green;">**إضافة عملاء جدد**</mark> إلى قائمة محددة، انتقل إلى قسم **"القنوات"** ثم انقر على زر **"تحميل قائمة العملاء"** واختر القائمة التي تريد تحميل العملاء إليها.

### كيفية إزالة العملاء من قائمة

يمكنك إزالة العملاء من قائمة بالطريقة نفسها: انقر على الزر **"— إزالة من القائمة**" وطبّق الفلاتر إذا لزم الأمر.

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

طبّق الفلاتر اللازمة لإزالة مجموعة محددة من العملاء **من هذه القائمة** (وليس من قاعدة بيانات العملاء).

{% hint style="danger" %}
**يرجى توخي الحذر عند ملء النموذج.**

إذا تركت حقول الفلتر في **"إزالة من القائمة"** نموذج **فارغ**, **جميع العملاء** سيتم إزالتهم من تلك القائمة.

لإزالة جزء فقط من القائمة، املأ المرشحات ذات الصلة:

* **حسب برامج المراسلة المتصلة** — اختر روبوتًا محددًا
* **العملاء في كتلة** — حدِّد رقم أو أرقام الكتلة في القمع (يمكن إضافة عدة كتل)
* **حسب متغيرات العميل** — أدخل قيمة متغير دقيقة
* **مسجَّل قبل/بعد** — حدِّد نطاق التاريخ المناسب
* **استبعاد القوائم** — إذا تم إدخال أرقام القوائم، فسيتم فقط حذف العملاء **عدم** الموجودين في أيٍّ من قوائم الاستبعاد تلك من القائمة الحالية.
  {% endhint %}

## كيفية إنشاء إرسال جماعي

عند النقر على القائمة، ستظهر لك أيضًا **"إنشاء إرسال جماعي"** زر في الشريط الجانبي الأيمن.

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

يمكنك إنشاء إرسال جماعي لكلا **برامج المراسلة** و **البريد الإلكتروني** (إذا كان البريد الإلكتروني مفعّلًا في مشروعك).

## كيفية نقل العميل من منصات أخرى

عند تحميل العملاء من منصات أخرى في قسم **"برامج المراسلة"** ، يمكنك تحديد قائمة واحدة أو أكثر ليتم وضع العملاء فيها بعد التحميل.

للقيام بذلك:

1. انتقل إلى **"برامج المراسلة"** .
2. حدِّد برنامج المراسلة المتصل الذي تريد تحميل العملاء إليه.

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

انقر على **زر "تحميل العملاء"** وقم بتكوين إعدادات التحميل (الترميز، قائمة الوجهة، إلخ) لاستيراد قائمتك.

<div data-with-frame="true"><figure><img src="/files/51066d441b596988c19c109b3658b9f04d07b9ed" alt="" width="563"><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/crm/tags.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.