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

يدعم هذا البلوك أنواع المرفقات التالية:

* رابط
* فيديو
* صورة
* ملف
* صوت

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

{% hint style="warning" %}
لا يمكنك في بلوك واحد الجمع بين أنواع مختلفة من المرفقات!

يجب ألا تتجاوز المرفقات التي يتم رفعها إلى الباني 20 ميغابايت.

يُسمح بإرسال ما يصل إلى 10 مرفقات من <mark style="color:red;">**النوع نفسه**</mark> في بلوك واحد.
{% endhint %}

يمكنك أيضًا إنشاء صورة باستخدام **زر "إنشاء صورة"** وإرسالها إلى عميلك.

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

## كيفية إرسال المرفقات

لإرسال مرفق، أنشئ بلوكًا فارغًا وافتح محرر البلوك (القائمة اليمنى).

{% hint style="danger" %}
مهم!&#x20;

1. يجب ألا يتجاوز المرفق الذي تم رفعه 20 ميغابايت. يُسمح بإرسال ما يصل إلى 10 مرفقات من <mark style="color:red;">**النوع نفسه**</mark> في بلوك واحد.
2. لا يُنصح بـ <mark style="color:red;">**إرسال بلوك يحتوي على عدة مرفقات**</mark> في رسالة جماعية لتجنب الوصول إلى حدود واجهة برمجة التطبيقات (API) الخاصة بمراسلات مختلفة.
3. <mark style="color:red;">**لا**</mark> تُسند <mark style="color:red;">**الاسم نفسه**</mark> إلى مرفقات مختلفة **ضمن مشروع واحد**!
4. إذا قمت برفع مرفق جديد بالاسم نفسه لمرفق موجود، فسيقوم النظام بتسليم الملف الأصلي. ولتجنب الأخطاء وضمان عمل البلوك بشكل صحيح، احرص دائمًا على إعطاء مرفقاتك أسماء فريدة.
   {% endhint %}

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

**تفاصيل خاصة بتلغرام:**

* الأزرار <mark style="color:red;">**لن يظهر**</mark> عند إرسال أكثر من مرفق واحد في بلوك.
* *استثناء:* إذا تجاوز نص البلوك 1024 حرفًا، فستُقسَّم الرسالة إلى جزأين — ستظهر الأزرار مع النص، وسيتم إرسال المرفقات في رسالة منفصلة.
* تنسيقات النص Markdown وHTML لا **عدم** تعمل عند إرسال أكثر من مرفق واحد في بلوك.
  {% endhint %}

تقع جميع إعدادات المرفقات ضمن إعدادات البلوك، ويمكن الوصول إليها بالنقر على **"مرفق"** الزر.

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

&#x20;لنلقِ نظرة أقرب على الأزرار التي ظهرت حديثًا لأنواع المرفقات.

### رابط

الزر الأول هو **رابط**:

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

1. انقر على الزر لإظهار إعدادات المرفق.
2. **الخيار أ:** أدخل عنوان URL في الحقل المخصص لمشاركة رابط.
3. **الخيار ب:** ارفع ملفًا؛ وسيُعرض للعميل كرابط تنزيل منفصل.

{% hint style="info" %}
سيتم إرسال الملف المرفق كرابط من خادم mavibot.ai.
{% endhint %}

{% hint style="info" %}
للملف المرفوع أولوية على الرابط. إذا تم توفيرهما معًا، فسيتم إرسال الملف المرفوع.
{% endhint %}

توجد ثلاثة مربعات اختيار أسفل حقل URL:

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

1. **إشعار النقر:** عند التفعيل، سيسجل الروبوت نقرة المستخدم بإرسال رسالة بالتنسيق `link_was_pressed [link1] [link2]`.

<div data-with-frame="true"><figure><img src="/files/1d8be1504d17f0951d4c49a610e7105aa1933799" alt="" width="320"><figcaption></figcaption></figure></div>

ما فائدة هذا؟

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

يتيح لك هذا الحدث تتبع المستخدمين الذين نقروا على رابط. عند تفعيل مربع الاختيار، يرسل النظام ردًا إلى المحادثة بالتنسيق:

`link_was_pressed {url}` &#x20;

في هذا الرد، `link_was_pressed` هو بادئة ثابتة، و `{url}` هي متغير يمثل عنوان URL المحدد الذي قمت بإعداده في البلوك.

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

على سبيل المثال، يمكنك المتابعة بإرسال تذكيرات إلى العملاء.

{% hint style="info" %}
ولمعرفة كيفية إعداد رد الروبوت على رد النداء الخاص بالنقر على الرابط، راجع القسم أدناه بعنوان [تتبع نقرات الروابط.](#tracking-link-clicks)
{% endhint %}

يمكنك تعيين نطاقك الخاص لإنشاء الروابط مع إشعارات النقر.

وللقيام بذلك، انتقل إلى إعدادات مشروعك:

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

انقر على زر "تعيين نطاق مخصص..." وأدخل نطاقك في النافذة المنبثقة:

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

{% hint style="info" %}
[تم شرح عملية إنشاء وإعداد نطاق مخصص هنا.](/doc/ar/websites/almwaqa/builder.md#domain)
{% endhint %}

عند تفعيل إشعار النقر، سيُنسق الرابط المرسل إلى المستخدم كما يلي:

`https://{your_domain}/{proxy_id}/s`

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

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

2. **مربع الاختيار "إظهار معاينة الرابط"** مربع الاختيار

<div data-with-frame="true"><figure><img src="/files/9a8fe1663c100b2cbf057dadb2703d7ab4e6863c" alt="" width="344"><figcaption></figcaption></figure></div>

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

3. **"الصورة أسفل النص"** مربع الاختيار

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

### مرفق فيديو

زر مرفق الفيديو

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

استخدم هذا الخيار عند إرسال مقاطع الفيديو. افتراضيًا، يعرض واتساب مقاطع الفيديو كرابط فقط.

**لعرض مقاطع فيديو يوتيوب كرابط في&#x20;*****جميع*****&#x20;تطبيقات المراسلة:**

* قصّر الرابط باستخدام أي أداة لتقصير الروابط، أو
* أرسله كمرفق مع **إشعار النقر** مفعّلًا.

{% hint style="info" %}
ملاحظة!&#x20;

يقوم تلغرام تلقائيًا بتحويل مرفقات الفيديو الصغيرة (أقل من حوالي 2 ميغابايت) إلى GIF.
{% endhint %}

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

{% hint style="warning" %}
يرجى الانتباه!&#x20;

يتم إرفاق الفيديو بصيغة MP4.
{% endhint %}

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

### صورة

**زر "صورة"** — استخدمه لإرسال الصور المطلوبة في الروبوت.

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

وكأي مرفق آخر، يمكن رفع الصورة مباشرة من جهاز الكمبيوتر أو بتحديد عنوان URL الخاص بها.

### ملف

**ملف** icon — استخدمه لإرسال المستندات وأي ملفات أخرى.

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

### **صوت**

**أيقونة الصوت:** استخدم هذه الأيقونة عند إرفاق أو إرسال ملف بصيغة صوتية (مثل MP3 وWAV).

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

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

{% hint style="warning" %}
بالنسبة إلى إنستغرام، يجب أن تكون صيغة الملف .m4a.
{% endhint %}

## إرسال عدة ملفات

لإرسال عدة مرفقات (فيديوهات أو ملفات أو صور أو صوت):

1. انتقل إلى **"مرفق"** القسم في محرر البلوك.
2. اختر نوع المرفق المطلوب.
3. ارفع الملفات المطلوبة واحدًا تلو الآخر.

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

{% hint style="info" %} <mark style="color:red;">**يرجى الانتباه إلى القيود التالية عند إرسال عدة مرفقات:**</mark>

**الحدود العامة:**

* **العدد:** يمكنك إضافة ما يصل إلى 10 ملفات من النوع نفسه في الوقت نفسه.
* **الحجم:** يجب ألا يتجاوز حجم كل ملف على حدة 20 ميغابايت.

**السلوك الخاص بتلغرام:**

* **تنسيق النص:** يتم تعطيل تنسيق Markdown أو HTML في الرسائل التي تحتوي على عدة ملفات.
* **الأزرار:** لا يتم تسليم الأزرار التفاعلية مع مرفقات ملفات متعددة.
  {% endhint %}

**في تلغرام:**&#x20;

* يتم تعطيل الأزرار عندما يحتوي البلوك على أكثر من مرفق واحد.

*<mark style="color:blue;">استثناء:</mark>* إذا تجاوز نص البلوك 1024 حرفًا، فسيتم تقسيم الرسالة. ستُرسل الأزرار مع النص، بينما تُسلَّم المرفقات في رسالة منفصلة.

* <mark style="color:red;">**تنسيق النص Markdown وHTML لا يعمل**</mark> عند إرسال أكثر من مرفق واحد في بلوك.

### إرسال المرفقات: أمثلة

لننتقل إلى أمثلة عملية. سنقوم بتهيئة الروبوت لإرسال الرسائل تلقائيًا بفاصل ثانيتين.

في كل بلوك من الأمثلة، سنضم نوعًا مختلفًا من المرفقات لعرض كيفية ظهورها في تلغرام.

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

يعرض مسار المثال أنواعًا مختلفة من المرفقات — ملف، رابط، فيديو، صورة، وصوت — تُرسل بالتتابع مع تأخير مقداره ثانيتان.

<div data-with-frame="true"><figure><img src="/files/3ef4976910bdef00a1b921ae69454cfef3f721df" alt="" width="375"><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/attachments/tab.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.