# الوضع المضمن في تيليجرام

## ما هو الوضع المضمن في تيليجرام؟

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

للاتصال ببوت مفعّل عليه الوضع المتصل، ما عليك سوى إدخال @\*اسم البوت\* في **رسالة** .

أبرز وأشهر مثال على بوت يعمل عبر الإنترنت هو @gif، والذي يمكنك من خلاله اختيار وإرسال صور gif:

<div data-with-frame="true"><figure><img src="/files/e143e502c015f3926c613bda5143f8e109e96a3a" alt="" width="563"><figcaption><p>سيعمل البوت @gif في أي دردشة.</p></figcaption></figure></div>

سيعمل البوت @gif في أي دردشة.

## كيف تفعّل الوضع المضمن؟

حتى يعمل البوت في وضع عدم الاتصال، تحتاج إلى تفعيل هذا الخيار في إعدادات البوت في [BotFather](https://t.me/BotFather).

اختر البوت المطلوب وانتقل إلى **إعدادات الروبوت**.

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

ثم اختر **الوضع المضمن**

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

هنا تحتاج إلى تفعيل وضع عدم الاتصال إذا لم يكن مفعّلًا.

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

## كيف تغيّر العنصر النائب؟

إذا رغبت، يمكنك تغيير العنصر النائب الذي يظهر قبل إدخال طلب البحث. بشكل افتراضي، يكون ***بحث…***

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

لتغييره، انقر على **تعديل العنصر النائب المضمن** الزر:

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

حدّد محتوى العنصر النائب بدقة.

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

## كيفية تهيئة نتائج الإخراج

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

لتحديد البيانات التي سيتم إخراجها في الوضع المضمن، تحتاج إلى تعيين المتغير inline\_bot. في الوضع المضمن، يتم البحث عن القيم في المتغير inline\_bot تقريبًا في الوقت الحقيقي.

يمكن تحديد البيانات في المتغير بثلاث طرق. لننظر من الأبسط إلى الإعدادات الأكثر تقدمًا.

### مصفوفة تحتوي على بيانات نصية

على سبيل المثال، سيتم البحث عبر مصفوفة من المنتجات.

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

يتم تحديد المتغير inline\_bot في إعدادات المشروع. يطابق البحث أي صيغة في المصفوفة تحتوي على العبارة المُدخلة.

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

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

عند إدخال '@name\_\_of your\_\_bot' والأحرف الأولى من الأوامر، تُفتح قائمة بالقيم التي حددتها في متغير المشروع.

بعد النقر على العنصر المطلوب، سيتم إرسال رسالة من المستخدم إلى البوت، ويمكنك تهيئة الاستجابة له داخل البوت.

يبدو إعداد الكتلة كما يلي:

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

بيانات نموذجية:

\["Milk", "Bread", "Pasta", "Chocolate", "Eggs", "Butter", "Bun", "Tea", "Vegetables", "Fruit"]

### الإخراج في غياب التصفية

يمكنك تعيين مفتاح فارغ وإسناد مصفوفة من القيم الصغيرة أو مصفوفة من القواميس إليه. سيصل البوت إلى القاموس باستخدام مفتاح فارغ ويعرض أزرارًا بالقيم من المصفوفة المخصصة.

### زر مضمن بقيمة البحث المحددة

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

الأزرار المضمنة في تيليجرام ليست استدعاءات رد.

إذا كنت بحاجة إلى استقبال استدعاءات رد، فاقرأ عن [أزرار الاستدعاء في تيليجرام.](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/buttons.md#callback-button)

يعمل الزر فقط في تيليجرام.
{% endhint %}

لتعيين عبارة البحث، أضف المعامل inline\_query إلى الزر المضمن مع قيمة تُدرج تلقائيًا في الاستعلام.

يوصى باستخدام هذا الخيار في وضع عدم الاتصال، لأنه سيتجنب الأخطاء ويعمل بشكل أسرع.

على سبيل المثال، أضف ثلاثة أزرار تطابق المثال من الفصل السابق.

\[{"line":0,"index\_in\_line":0,"text":"إظهار القائمة","type":"inline","inline\_query":"menu"},{"line":0,"index\_in\_line":1,"text":"Статьи","type":"inline","inline\_query":"posts"},{"line":2,"index\_in\_line":0,"text":"قائمة المنتجات","type":"inline","inline\_query":"products"}]

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

عند النقر على زر، على سبيل المثال، **مقالة،** سيتم عرض قائمة الأزرار التي تم العثور عليها (عند الإضافة، حددت "inline\_query":"posts" لهذا الزر):

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

تُؤخذ الخيارات من متغير معيّن، كما هو موضح أعلاه في **"قاموس مع قائمة"** :

<figure><img src="/files/7a0ec2161c8f886d566497f52cb82dd89d83e060" alt="" width="563"><figcaption></figcaption></figure>

### ملاحظات

* يمكن تعيين المتغير inline\_bot ليس فقط في المتغيرات العامة، بل أيضًا كمتغير بسيط، ولكن في هذه الحالة يجب أن تكون قيمته محاطة بعلامتي اقتباس مفردتين.

مثال في حقل الحاسبة:

inline\_bot = '\["Milk", "Bread", "Pasta", "Chocolate", "Eggs", "Butter", "Puff Pastry", "Tea", "Vegetables", "Fruits", "#{aa}"]'

يمكنك أيضًا تمرير أي قيمة كمتغير لإعداد أكثر مرونة.

على سبيل المثال، خيار بسيط في مصفوفة:

<div data-with-frame="true"><figure><img src="/files/d271a5382911879af952364c0cb6a5e73263a7f6" 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/chatbot/ttbyqat-almraslh/tylyjram/inline.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.