# إعدادات المشروع

في إعدادات المشروع، يمكنك تحديد الإشعارات الواردة، وتهيئة العمل مع القُمع، ثم تعيين المتغيرات والثوابت، وإعادة تسمية المشروع، وغير ذلك الكثير.

<figure><img src="/files/6bcee8efdba131c16ee44ba58292218db06df901" alt="" width="210"><figcaption></figcaption></figure>

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

## الإعدادات الرئيسية

<figure><img src="/files/2b574a493fcf2ce45a9026fb43ddc5834b3a7417" alt=""><figcaption></figcaption></figure>

في إعدادات المشروع الرئيسية، يمكن للمستخدم تغيير:

* اسم المشروع؛
* المنطقة الزمنية؛
* مالك المشروع؛
* تعيين النطاق للروابط في البوت:

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

ستحتاج إلى تثبيت نطاقك الخاص إذا كان من الضروري أن يكون رابط الوكيل على نطاقك، وليس على نطاق Mavibot. هذا إعداد اختياري.

عنوان URL للويب هوك

* مطلوب لتلقي الأحداث من خدمات الطرف الثالث.

يمكنك أيضًا تفعيل مربعات الاختيار في إعدادات المشروع الرئيسية:

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

* قبول العملاء المحتملين تلقائيًا إلى المرحلة الأولى من القمع\
  سيقوم هذا المربع بإنشاء بطاقات المعاملات فورًا في المرحلة الأولى من القمع في MaviCRM.
* منع المشغّلين من إرسال الملفات\
  بعد تحديد هذا الإعداد، لن يتمكن موظفو مشروعك الذين لديهم دور المشغّل (أو أي دور آخر تم تهيئته يدويًا) من إرسال الملفات في المحادثات.
* العملاء الذين ينتظرون ردًا يكونون دائمًا في الأعلى\
  سيعرض العملاء الذين لم ترد عليهم أنت أو موظفوك بعد في أعلى القائمة بالكامل.
* عدم التحقق من تنسيق معاملات post-json\
  لإعدادات البوت
* البوت قيد التشغيل\
  مربع اختيار لتشغيل/إيقاف البوت في المشروع

## الردود الراجعة

في إعدادات المشروع، يمكنك تهيئة الردود الراجعة التي تريد استلامها في MaviBot:

<figure><img src="/files/3977dc65f106277f131e6285d59998f327792a4c" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
الرد الراجع - هو إشعار نظام يساعدك على تتبع الأحداث في Mavibot دون الحاجة في كل مرة إلى فحص القوائم والوسوم والقُمع في CRM، مما سيوفر لك وقتًا كبيرًا.
{% endhint %}

{% hint style="info" %}
في هذا القسم، يتم تهيئة إشعارات النظام فقط من أقسام Mavibot. لمعرفة أي ردود راجعة تصل، على سبيل المثال من أنظمة الدفع والرسل والتكاملات الأخرى، تحتاج إلى قراءة مقالة التوثيق ذات الصلة.
{% endhint %}

&#x20;يمكن إعداد الردود الراجعة للإشعارات:

* إضافة/إزالة القوائم والوسوم
* الإجراءات مع المهام: إنشاء، حذف، تعديل، وإنجاز

على سبيل المثال، أثناء إنشاء مهمة مرتبطة بعميل معين، ستظهر رسالة بالنص التالي في قسم "العملاء" من المحادثة معه: new\_task\_added\_callback task\_id:#{task.id}, task\_name:#{task.name}

<figure><img src="/files/32b07e2abe052e1bcba5b53068190dbae0e87f08" alt="" width="375"><figcaption></figcaption></figure>

وعند تعديل مهمة مرتبطة بعميل معين، سيظهر تعليق في المحادثة مع العميل بالنص: "تم تعديل المهمة" #{current\_user.display\_name}: edit\_task\_callback task\_id:#{task.id}, task\_name:#{task.name}"

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

* تغيير الشخص المسؤول عن العميل

يتضمن الرد الراجع معرّف الصفقة، وكذلك اسم الشخص المسؤول الذي تم استبدال موظفك السابق به:

<figure><img src="/files/50806bfa88c2e355c642997c2c9a97c8c7f5883e" alt="" width="375"><figcaption></figcaption></figure>

* حذف الصفقة

لرؤية جميع الإجراءات في CRM، راقب أيضًا حذف المعاملات في قُمعك حتى لا تفوت أي شيء مهم:

<figure><img src="/files/536853dfa2921c6f10893a343544fa024f4ba0ca" alt="" width="375"><figcaption></figcaption></figure>

* سحب الصفقات وإفلاتها إلى حالة نظامية

هناك حالات قُمع نظامية يمكن نقل الصفقة إليها في MavibotCRM:

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

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

### إعداد الردود الراجعة أثناء الانتقال بين مراحل CRM

<figure><img src="/files/22efc1c3a268cb81e5f168ba777078f0da6d44fd" alt=""><figcaption></figcaption></figure>

بعد النقر على "إعدادات الرد الراجع للانتقالات بين مراحل CRM"، تفتح نافذة منبثقة تحتوي على جميع القُمع الموجودة في المشروع:

<figure><img src="/files/81fd0e8b5775f5bc8ac7b9735d8a761278277d8c" alt=""><figcaption></figcaption></figure>

سيساعد هذا الإعداد على تفعيل البوت أثناء انتقال العميل إلى حالة قُمع معينة. ولأجل ذلك يكفي تحديد القُمع بالكامل (حينها سيؤدي أي انتقال لصفقة العميل عبر القُمع إلى تفعيل البوت) أو فقط الانتقال إلى حالة معينة:

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

الآن، أثناء تغيّر حالة الصفقة (تلقائيًا أو يدويًا)، يتم إنشاء إشعار من أي مكان في الموقع يمكنه تشغيل البوت.

{% hint style="info" %}
يبدو الإشعار كما يلي: crm\_state\_changed اسم القُمع:اسم المرحلة
{% endhint %}

ستظهر أيضًا المتغير callback\_query\_id في بطاقة العميل، والذي سيخزن معرّف المعاملة التي أُرسل من أجلها الإشعار:

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

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

## الثوابت

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

من الضروري مراعاة الحدود المفروضة على المتغيرات والثوابت في المشروع:

* الحد الأقصى لعدد متغيرات القالب هو 100؛
* لا يمكن أن يتجاوز اسم متغير القالب 100 رمز؛
* الحد الأقصى لعدد ثوابت المشروع هو 50؛
* لا يمكن أن يتجاوز اسم الثابت 100 رمز؛
* لا يمكن أن تتجاوز قيمة الثابت 5000 رمز.
  {% endhint %}

ثابت المشروع هو متغير ثابت غير قابل للتغيير. على سبيل المثال، قد تحتاج إليه للعمل مع المدفوعات في البوت.

<figure><img src="/files/325e732bd4bcaf87f08f85d464fd5b4e95be974b" alt="" width="563"><figcaption></figcaption></figure>

لإضافة ثوابت المشروع، انقر على أيقونة القلم. بعد ذلك ستفتح نافذة منبثقة حيث يمكنك إدخال اسم المتغير وقيمته:

<figure><img src="/files/971a73a154f4a1f1885b1fda04f2fa8b55cc7abe" alt="" width="375"><figcaption></figcaption></figure>

بعد ذلك، تحتاج فقط إلى إدخال متغير:

<figure><img src="/files/0dc2fce5e24a4cdfb6022eb58db8c8ccdd5c068c" alt="" width="375"><figcaption></figcaption></figure>

ثم، في حوار مع العميل، يستخرج البوت القيم من ثابت المشروع:

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

## المتغيرات

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

من الضروري مراعاة الحدود المفروضة على المتغيرات والثوابت في المشروع:

* الحد الأقصى لعدد متغيرات القالب هو 100؛
* لا يمكن أن يتجاوز اسم متغير القالب 100 رمز؛
* الحد الأقصى لعدد ثوابت المشروع هو 50؛
* لا يمكن أن يتجاوز اسم الثابت 100 رمز؛
* لا يمكن أن تتجاوز قيمة الثابت 5000 رمز.
  {% endhint %}

يمكن أيضًا استخدام المتغيرات المعينة في إعدادات المشروع داخل شات بوتك (بما في ذلك [شات بوت بالذكاء الاصطناعي](/doc/ar/chatbot/ai/online-booking.md)).&#x20;

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

يمكن أيضًا استخدام المتغيرات المعينة في إعدادات المشروع داخل شات بوتك (بما في ذلك شات بوت بالذكاء الاصطناعي).

{% hint style="warning" %}
الفرق بين المتغيرات والثوابت

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

{% hint style="success" %}
مثال واضح على العمل مع متغير عبر البوت وبنية المشروع. يمكنك قراءته في المقال "[شات بوت بالذكاء الاصطناعي للحجز عبر الإنترنت](/doc/ar/chatbot/ai/online-booking.md)".&#x20;
{% endhint %}

### كيفية تعيين المتغيرات/الثوابت بشكل صحيح في إعدادات المشروع

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

لا يمكنك استخدام إدراج المتغيرات داخل قيمة متغير/ثابت في إعدادات المشروع!

الإدراج هو إسناد متغير إلى آخر عبر البنية #{}.
{% endhint %}

<mark style="color:red;">**خطأ:**</mark>

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

<mark style="color:green;">**صحيح:**</mark>

أثناء تعيين المتغيرات في إعدادات المشروع، يمكنك استخدام قيم مختلفة:

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

على سبيل المثال، تم تخزين المتغيرات من لقطة الشاشة أعلاه في المشروع عبر البوت باستخدام كتل الباني والوظائف المثبتة:

<figure><img src="/files/91cf8b838c50f5c7c4facea8250c60375a15e641" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
تعمل الدالة get\_info\_for\_booking() فقط عندما يكون قسم "الخدمات" مهيأً للحجز عبر الإنترنت وتأخذ القيم الخاصة بخانات الحجز الحرة المتاحة.
{% endhint %}

يرجى ملاحظة أن المتغير مخزّن في إعدادات المشروع عبر البنية "project.":

<figure><img src="/files/2fefaded6e17808baefe4d40e37e80cc017d3fda" alt="" width="563"><figcaption></figcaption></figure>

يمكنك أيضًا إضافة متغير في إعدادات المشروع بالنقر على أيقونة القلم:

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

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

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

علاوة على ذلك، يمكنك تعيين اسم المتغير حسب رغبتك، [مع تجنب تسمية المتغيرات النظامية](/doc/ar/chatbot/functions/almtghyrat.md#how-to-work-with-variables)

<figure><img src="/files/3f0fccdc8bb2d5e096962be2c7cf27346d02d828" alt="" width="375"><figcaption></figcaption></figure>

### قوالب المتغيرات

باستخدام وظيفة "قوالب متغيرات المشروع"، يمكنك تجميع المتغيرات بسرعة، بغض النظر عن أنواعها.

لتجميع متغير باستخدام قالب، انقر على الزر الذي يحمل الاسم نفسه:

<figure><img src="/files/6f86496d9b822a384ad137a5c092c8c8a8e596a6" alt="" width="375"><figcaption></figcaption></figure>

سترى نافذة منبثقة يظهر فيها حقل فارغ لاسم المتغير وقائمة منسدلة بالنوع:

<figure><img src="/files/584a27d8de6e3379a442c18c7293e7de961f9cb5" alt=""><figcaption></figcaption></figure>

إذا اخترت نوع المتغير "قائمة"، فيمكنك تحديد القيم الممكنة للمتغير.:

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

لإضافة قيم متعددة:

الخطوة 1: أدخل اسم المتغير؛

الخطوة 2: أدخل القيمة 1 للمتغير؛

الخطوة 3: انقر على علامة الجمع في السطر الذي يحتوي على القيمة: بعد النقر على علامة الجمع لأحد قيم المتغير، سيظهر شريط أسفل الحقل مع البيانات التي أدخلتها للمتغير:

<figure><img src="/files/21985cfaca1b56edbd4897674635df7cbf556378" alt=""><figcaption></figcaption></figure>

الخطوة 4: أدخل القيمة التالية للمتغير واضغط على زر الجمع مرة أخرى: يجب أن تنقر على زر الجمع بعد كل مرة تدخل فيها إحدى قيم المتغير.

الخطوة 5: انقر على "إنشاء": ثم ستتم إضافة المتغير في أسفل النافذة المنبثقة:

<figure><img src="/files/7f659eb6927a24e658757288147f381adaaa9ed1" alt=""><figcaption></figcaption></figure>

## الرسائل

يغطي هذا القسم جميع النقاط اللازمة عند العمل مع روبوتات الدردشة:

<figure><img src="/files/6dc57ef0a4618ce4644861131e66d2ae0c54289d" alt="" width="375"><figcaption></figcaption></figure>

1. يمكنك تحديد عنوانك الخاص/عناوين بريد إلكتروني متعددة لتلقي الطلبات/الاستفسارات إلى بريدك الإلكتروني دون تفويت أي حدث.
2. إذا لزم الأمر، يوجد إعداد للرد التلقائي على أول رسالة من المستخدم في نافذة دردشة عبر الإنترنت أو في المراسِل مع أزرار.

{% hint style="info" %}
لمزيد من المعلومات، راجع المقال [الرسالة الأولى في المراسلات](/doc/ar/chatbot/ttbyqat-almraslh/message.md)&#x20;
{% endhint %}

3. يمكنك أيضًا تأمين نفسك بحيث لا يتوقف البوت أبدًا: عيّن نص الرسالة إذا كان البوت لا يعرف إجابة المستخدم.
4. كذلك، من خلال تفعيل مربعات الإشعارات، ستتمكن من رؤية العملاء الذين كتبوا إليك في البوت، حتى لو كنت حاليًا في مشروع Salebot آخر.

### الرسائل المكررة

كذلك، في إعدادات المشروع ضمن قسم الرسائل، يمكنك إعداد رسائل مكررة إلى بريد طلابك وعملائك:

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

إذا كتب إليك طالب / عميل في دردشة عبر الإنترنت، وبعد ذلك لم تتم قراءة الرسالة من قبله، فعند ضبط هذا الإعداد، ستُرسل رسالة إلى الطالب / العميل بعد فترة زمنية محددة.

{% hint style="warning" %}
مهم! لكي تعمل هذه الميزة، تحتاج إلى بوت بريد إلكتروني متصل ومصرّح له.
{% endhint %}

{% hint style="info" %}
تم وصف كيفية توصيل بوت البريد الإلكتروني في المقال "[إرساليات البريد الإلكتروني](/doc/ar/alrsael-aljmaayh/hmlat-albryd-alilktrwny.md)". — вставить ссылку
{% endhint %}

لكي تعمل مضاعفة البريد الإلكتروني، من الضروري تحديد الفاصل الزمني الذي بعده ستتم مضاعفة رسالة الطالب/العميل غير المقروءة إلى البريد:

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

إذا كانت عدة بوتات بريد إلكتروني متصلة بالمشروع، فيمكنك اختيار أيٍّ منها سيتم إرسال الرسالة المكررة منه:

<figure><img src="/files/249c0b26da68bd643f9c5a6584000b3e6eea4bf3" alt=""><figcaption></figcaption></figure>

#### درس فيديو

{% embed url="<https://youtu.be/Teb_onsWUYA>" %}


---

# 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/us/admin/settings.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.