# الأزرار والمرفقات

## كيفية العمل مع الأزرار

{% hint style="info" %}
إنستغرام لا يدعم إرسال أزرار داخلية وأزرار رد في الوقت نفسه
{% endhint %}

### لوحة المفاتيح **(رد)**

يدعم إنستغرام حتى 11 زر رد. يمكن ترتيب الأزرار في صف واحد فقط

مثال:

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

النتيجة:

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

### في النص (داخلي)

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

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

{% hint style="danger" %}
يدعم إنستغرام ما لا يزيد عن 3 أزرار داخلية
{% endhint %}

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

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

يمكن للأزرار أن ترتبط بمصادر خارجية. بصريًا، هذه الأزرار متطابقة.

للحصول على تعليمات حول إعداد الأزرار، راجع **الأزرار** .

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

يمكنك إرسال مرفقات في الرسالة. لمزيد من المعلومات حول المرفقات وكيفية إضافتها، راجع [إرسال المرفقات](/doc/ar/chatbot/builder/attachments/tab.md) القسم في الوثائق.

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

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

{% hint style="warning" %}
يمكنك رفع المرفقات إلى كتلة إما كملف أو عبر توفير رابط للملف.

لا ينبغي أن تتجاوز ملفات الفيديو المرفوعة 20 ميغابايت، بينما يجب ألا يزيد حجم ملفات الصوت والصور عن 5 ميغابايت.
{% endhint %}

**متطلبات المرفقات:**

| نوع ملف الوسائط | الصيغة المدعومة | الحد الأقصى للحجم |
| --------------- | --------------- | ----------------- |
| صوت             | M4A             | 5 ميغابايت        |
| صورة            | JPEG, PNG       | 5 ميغابايت        |
| فيديو           | MP4             | 20 ميغابايت       |

{% hint style="warning" %}
يُمنع **NOT** يوصى باستخدام صيغة MP4 للمرفقات الصوتية. بالإضافة إلى ذلك، **لن يتم إرسال أي صوت على الإطلاق بصيغة MP3**.
{% endhint %}

## كيفية إنشاء Carousel

يمكن أن يحتوي الكاروسيل على ما بين 2 و10 بطاقات (شرائح).

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

لنستخدم كاروسيلًا من 3 بطاقات كمثال. لإنشاء البطاقات، تحتاج إلى إدخال ما يلي في **الحاسبة** :

p = \[{"title":"TITLE", "description": "IMAGE DESCRIPTION 1", "image": "LINK TO THE IMAGE 1", "buttons":\[{"text":"BUTTON TEXT 1"}]},{"title":"TITLE", "description": "CARD DESCRIPTION 2", "image": "LINK TO IMAGE 2", "buttons":\[{"text":"BUTTON TEXT 2"}]}, {"title":"TITLE", "description": "CARD DESCRIPTION 3", "image": " LINK TO THE IMAGE 3", "buttons":\[{"text":"BUTTON TEXT 3"}]}]                                              &#x20;

r = send\_carousel(p, '')

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

انسخ الرابط:

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

النتيجة:

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

{% hint style="warning" %}
يرجى ملاحظة: يجب أن يبدأ التعبير `r = send_carousel(p, '')` في سطر جديد في الحاسبة.
{% endhint %}

وهذا يعني أنك تحتاج إلى إسناد مصفوفة تحتوي على العنوان والوصف والصورة والأزرار إلى متغير `p` (يمكنك تسمية المتغير بشكل مختلف إذا أردت). ثم استخدم هذا المتغير في `send_carousel(p, "")` .

ويترك `#{None}` في **"Response"** .

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

{% hint style="info" %}
يمكنك إضافة روابط إلى الأزرار في بطاقات الكاروسيل. عندما ينقر المستخدم على الزر، سيتم توجيهه إلى الرابط.
{% endhint %}

لإضافة رابط إلى زر على البطاقة، أدرجه في المصفوفة:

p = \[{"title":"title", "description": "CARD DESCRIPTION 1", "image": "LINK TO THE IMAGE 1", "buttons":\[{"text":"BUTTON TEXT 1", "url":"LINK FOR THE BUTTON" }]}]

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

{% hint style="info" %}
تمت إضافة معلمة اختيارية أخرى، `payload`، إلى أزرار بطاقات الكاروسيل. لا تظهر للعميل لكنها تتيح لك تحليل اختيار العميل.
{% endhint %}

نظرًا لأن بطاقات الكاروسيل غالبًا ما تتطلب أزرارًا بنص متطابق، فقد تم تقديم معلمة إضافية `payload` . هذه المعلمة غير مرئية للعميل لكنها تتيح لك تحليل اختياره.

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

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

انتبه إلى الاستخدام الصحيح لها:

p = \[{"title":"title", "description": "CARD DESCRIPTION 1", "image": " 1", "buttons":\[{"text":"BUTTON TEXT 1","payload":"1"}]},{"title":"title", "description": "CARD DESCRIPTION 2", "image": "LINK TO THE IMAGE 2", "buttons":\[{"text":"BUTTON TEXT 1","payload":"2"}]}, {"title":"title", "description": "CARD DESCRIPTION 3", "image": "LINK TO THE IMAGE 3", "buttons":\[{"text":"BUTTON TEXT 1"}]}]

الـ `payload` يمكن حذف المعلمة، كما هو موضح في الشكل أعلاه.

## كيفية إعداد العبارات التعريفية

تتيح العبارات التعريفية للشخص بدء محادثة مع شركة باستخدام قائمة بالطلبات الشائعة. يمكنك إعداد ما يصل إلى أربعة طلبات.

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

لإعداد العبارات التعريفية، تحتاج إلى إعداد شريط تمرير في حساب إنستغرام المتصل، في قسم "القنوات".

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

بعد النقر على شريط التمرير هذا، تظهر نافذة منبثقة حيث يمكنك إعداد العبارات التعريفية اللازمة.

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

ثم اتبع هذه الخطوات:

1. أعد إعداد ردود على عبارات محددة في القمع الخاص بك.
2. ضع الكتل اللازمة في حالة "البدء".
3. أدخل نص العبارة التعريفية في المشغّل.

{% hint style="warning" %}

#### يرجى الانتباه!&#x20;

تظهر العبارات التعريفية للمستخدمين الذين لم يتواصلوا مسبقًا مع حساب إنستغرام الخاص بك (أو إذا تم حذف سجل المحادثة السابق بالكامل).
{% endhint %}

## إعداد رد على كلمة مفتاحية في الرسائل المباشرة

للرد على العملاء في الرسائل المباشرة بناءً على الكلمات المفتاحية، يمكنك استخدام كتلة تحتوي على مشغّل (كتل البدء والمشغّل) وإدخال الكلمات التي تريد أن يرد عليها الروبوت في حقل المشغّل:

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

يعتمد اختيار المطابقة على وجود الكلمات المفتاحية أو المطابقة التامة (الخيارات الموصى بها).

في **"نص الرسالة"** الحقل، أدخل ردّ البوت الذي سيتلقاه المستخدم. يمكنك أيضًا إضافة مرفقات وأزرار وروابط.

## **كيفية التحقق مما إذا كان المستخدم مشتركًا في حسابك**

هناك طريقتان لـ **التحقق من** حالة الاشتراك:

1\. التحقق من الاشتراك باستخدام الحاسبة

**result = check\_insta\_subscription()**

`النتيجة` هو اسم المتغير الذي سيتم **التحقق من** تخزين النتيجة فيه (يمكنك إعادة تسميته إذا لزم الأمر).

تعيد الدالة:

* **`True`** إذا كان المستخدم مشتركًا.
* **`خطأ`** إذا لم يكن المستخدم مشتركًا.

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

يجب إجراء التحقق في **"Variable"** حقل، سواء على السهم أو في الكتلة.

* `result == True` – تعبير في **"Variable"** حقل إذا كان العميل مشتركًا في الحساب.
* `result == False` – تعبير إذا كان العميل غير مشترك.

يمكنك أيضًا استخدام تعبيرات مقارنة أخرى، على سبيل المثال:\
`result != False` (النتيجة لا تساوي False، أي أن المستخدم مشترك في الحساب).

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

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

2. بيانات من التحقق من بطاقة العميل

عندما يتفاعل المستخدم مع الروبوت، يتم عرض المتغيرين `follow` و `followers` ويتم التحقق منهما في بطاقة العميل (ضمن **متغيرات العميل** الفرعية).

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

**`follow` variable** – يتحقق من حالة الاشتراك. يأخذ القيمة `True` إذا كان العميل مشتركًا في الحساب، `خطأ` إذا لم يكن مشتركًا، و `None` إذا كان حساب العميل مغلقًا.

**`verified`** – يشير إلى ما إذا كان لدى المستخدم حساب موثّق (علامة زرقاء). وهو `True` إذا كان موثّقًا و `خطأ` وإلا.

**`followers`** – يعرض عدد المشتركين/المتابعين لدى العميل.

للتحقق من حالة الاشتراك أو تقييد التقدم في القمع، يمكنك استخدام **`follow`** المتغير في كتل الشروط أو موصلات الأسهم ضمن **"Variable"** .

مثال:

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

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

في **المشغّل** الحقل، أدخل أي كلمة ستبدأ بها القمع الخاص بك.

في **المتغير للمقارنة**، اكتب:\
`follow == True`\
OR\
`follow != False`

* في الحالة الأولى، تتحقق مما إذا كان الشخص مشتركًا في حسابك.
* في الحالة الثانية، تتحقق مما إذا كان الشخص **عدم** مشتركًا في حسابك.

{% hint style="warning" %}
يرجى ملاحظة أن `True` و `خطأ` الحالات يجب أن تكون بأحرف كبيرة. وإلا فلن يعمل التحقق بشكل صحيح.
{% endhint %}

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

**المشغلات على الاتصالات:**

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

أدخل المشغّل في **"Variable"** صف السهم:\
`follow == True` أو `follow != False`

إذا تم استيفاء شرط المشغّل، يتقدم العميل أكثر في القمع.

إذا لم يكن العميل مشتركًا، فإنه ينتقل إلى الكتلة التي لا تتحقق فيها شروط التحقق (`follow == False` أو `follow != True`).

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

{% hint style="danger" %}

#### انتباه

لا **NOT** نوصي بضبط مؤقت دون زر على سهم مغلق، لأن الشخص سيتلقى الرسائل باستمرار، مما يستنزف حد رسائلك بسرعة.
{% 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/ttbyqat-almraslh/instghram/buttons.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.