# أزرار تيليجرام لروبوتات الدردشة

{% hint style="info" %}
نوصي بأن تقرأ المقال [زر](/doc/ar/chatbot/builder/alazrar.md#how-to-create-a-button).
{% endhint %}

يمكنك استخدام كلٍّ من أزرار الرد (الأزرار العادية أو أزرار لوحة المفاتيح) والأزرار المضمنة (الأزرار داخل النص) في تيليجرام.

{% hint style="info" %}
**مهم: قيود الأزرار**

يرجى الانتباه إلى القيود التالية الخاصة بالمنصة عند إنشاء الأزرار:

* **أزرار الرد (لوحة المفاتيح):** بحد أقصى **12 زرًا في كل صف**.
* **الأزرار داخل الرسالة:** بحد أقصى **8 أزرار في كل صف**.
* **نص الزر:** محدود بـ **32 حرفًا**.
* **لون الزر:** **لا يمكن تخصيصه.** تستخدم الأزرار النمط الافتراضي للمنصة.
  {% endhint %}

## كيفية إنشاء زر في الكتلة

لإنشاء أي زر في روبوت المحادثة، انتقل إلى إعدادات الكتلة وانقر على **"الأزرار"** علامة التبويب:

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

ثم ستُفتح إعدادات إضافة الزر وتحريره. ثم انقر **إضافة**:

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

ستُفتح نافذة إعدادات، تتيح لك تحديد تسمية الزر والإجراء والخيارات الإضافية.

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

أنواع الأزرار التالية **متاحة فقط لروبوت تيليجرام**:

* **زر المشاركة** – تتيح للمستخدمين مشاركة المحتوى.
* **زر الاتصال التلقائي** – ترسل استجابة نداء صامتة إلى روبوتك.
* **Telegram WebApp** – تفتح تطبيقًا مصغرًا (مثل عنصر واجهة أو موقع ويب) داخل تيليجرام.
* **تسجيل الدخول عبر تيليجرام** – يَمنح المستخدمين الإذن عبر حسابهم في تيليجرام.

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

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

### زر المشاركة

عند إنشاء الزر، اختر "**مشاركة (تيليجرام فقط)"** واملأ الحقول (حقل نص إضافي اختياري):

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

يتيح لك هذا الزر إعادة توجيه المعلومات عن طريق اختيار جهة اتصال من قائمتك.

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

أدخل عنوان URL الذي ترغب في مشاركته في **"رابط المشاركة"** .

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

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

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

{% hint style="info" %}
تنبيه! قد لا يعمل بشكل صحيح على بعض أجهزة iOS.
{% endhint %}

### زر تسجيل الدخول إلى الموقع الإلكتروني

لكي يعمل زر تسجيل الدخول، يجب أولاً منح روبوتك الإذن للنطاق المستهدف. يتم هذا الإعداد عبر **@BotFather**.

**خطوات الإعداد:**

1. افتح محادثة مع [@BotFather](https://t.me/botfather).
2. اختر روبوتك من القائمة.
3. اختر **إعدادات الروبوت** > **نطاق** وأضف نطاق موقعك الإلكتروني.

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

بعد ذلك، انتقل إلى **نطاق** الزر:

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

**ملاحظة:** سيظهر الزر باسم **تعديل النطاق** إذا كان هناك نطاق موجود، أو **تعيين النطاق** إذا كان يجب إضافة واحد.

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

سيُطلب منك إعداد النطاق لروبوتك:

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

**تنسيق النطاق الصحيح:**

أدخل نطاقك كـ `mavibot.ai` أو كـ `yourdomain.com` إذا كان لديك موقع ويب متصل بـ MaviBot.

**الخطوة التالية:**

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

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

في **نص** الحقل، أدخل التسمية التي ستظهر على الزر.

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

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

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

إذا كنت بحاجة إلى أن تتمكن من إرسال رسائل من الروبوت المحدد، فتأكد من تحديد المربع الخاص بـ **"طلب إذن من المستخدم لإرسال الرسائل من الروبوت"**:

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

زر تسجيل الدخول عبر تيليجرام

### زر الاتصال التلقائي

زر Callback هو زر تفاعلي؛ عندما يرى العميل شيئًا، نحصل في الروبوت على الاستدعاء الذي نحتاجه لتشغيل أي كتلة من القمع.

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

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

من الناحية البصرية، يبدو الزر مثل زر مضمن عادي:

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

بعد النقر على الزر، سترى **Callback** المُعدّ في بطاقة العميل:

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

{% hint style="info" %}
هذا مهم!

تيليجرام لا يدعم أزرار لوحة المفاتيح Callback.
{% endhint %}

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

إذا كان **"Callback"** إذا تم اختيار نوع الزر، فسيظهر الزر كـ Callback فقط إذا كان نص الزر مختلفًا عن نص Callback.
{% endhint %}

### زر تطبيق تيليجرام الويب

يتيح لك هذا الزر فتح الموقع الإلكتروني كتطبيق ويب داخل تيليجرام.

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

عند إضافة الزر، حدد تسميته، واختر نوع زر Telegram Web App، وقدم الرابط إلى الموقع الذي سيفتح كتطبيق ويب:

* يمكنك تحديد رابط عبر متغير:

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

استخدام متغير للرابط عملي جدًا عندما يتغير عنوان الصفحة أو الموقع المستهدف كثيرًا.

**كيف يعمل:**

1. عرّف متغيرًا (مثل `landing_page_url`) في إعدادات مشروعك.
2. أشر إلى هذا المتغير (مثل `#{landing_page_url}`) في جميع أزرار Web App عبر مساراتك.

**الفائدة:** بدلاً من تحديث عنوان URL يدويًا في كل كتلة زر على حدة، يكفيك تغيير قيمة المتغير مرة واحدة في إعدادات المشروع، وستتحدث جميع الأزرار تلقائيًا.

**بديل:** بالطبع، يمكنك أيضًا تحديد عنوان URL مباشر وثابت مباشرةً في إعدادات الزر.

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

## كيفية إنشاء أزرار لوظائف Telegram API

على الرغم من أن العمل مباشرةً مع Telegram Bot API قد يكون صعبًا، خاصةً للمبتدئين، فإن MaviBot يوفّر بديلًا أكثر سهولة.

**الطريقة: استخدام الشيفرة المُولَّدة**

يمكنك استخدام **شيفرة الزر المُولَّدة مسبقًا** من الإعدادات المتقدمة، مما يلغي الحاجة إلى كتابة استدعاءات API يدويًا.

**الخطوات:**

1. انتقل إلى إعدادات الكتلة وافتح **الأزرار** .
2. استخدم الواجهة لإضافة وتكوين جميع الأزرار المطلوبة (نصوص، روابط، وظائف).
3. سيقوم النظام تلقائيًا بتوليد شيفرة Telegram API الصحيحة في الخلفية.

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

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

انقر **"الإعدادات المتقدمة"** لعرض شيفرة Telegram API المُولَّدة لأزرارك.

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

اختبر أزرارك، ثم انسخ الشيفرة المُولَّدة من **الإعدادات المتقدمة** إلى متغير مثل `buttons`.

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

ترسل هذه الوظيفة رسالة عبر Telegram API باستخدام المعلمات التالية: tg\_send\_message (platform\_id, text,client\_message\_id, reply\_markup, sparse\_mode, disable\_web\_page\_preview, protect\_content, disable\_notification, message\_thread\_id, entities):

مرّر متغير الأزرار إلى الوظيفة في المعلمة reply\_markup:

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

ستظهر أزرارك في المحادثة بالتخطيط والنمط اللذين حددتهما.

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

## كيفية حذف أزرار الرد

على الرغم من أن أزرار لوحة المفاتيح تختفي عادةً تلقائيًا، إلا أنها قد تبقى ظاهرة أحيانًا.

لإزالة أزرار الرد العالقة بالقوة، أدرج الشيفرة التالية في **الإعدادات المتقدمة** :

```
[{"buttons":[],"one_time":true,"index_in_line":0,"line":0}]
```

يُخبر هذا التكوين الفارغ للأزرار تيليجرام بإخفاء لوحة المفاتيح المخصصة.

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

### أزرار قائمة لوحة المفاتيح في تيليجرام

{% hint style="warning" %}
نوصي باستخدام هذه الميزة للمستخدمين المتقدمين فقط!
{% endhint %}

### أزرار لوحة المفاتيح

لإتاحة استخدام أزرار لوحة المفاتيح (الرد) كقائمة دائمة في تيليجرام، يكفي إسناد أي قيمة إلى المتغير tg\_permanent\_reply\_buttons (المتغير مُعرَّف كثابت في المشروع).

<div data-with-frame="true"><figure><img src="/files/8180bd3ec30a6d8c772495d2d1a2f14a3af00879" alt="" width="370"><figcaption></figcaption></figure></div>

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

#### **المتغير: `tg_permanent_reply_buttons`**

يمنحك ضبط **`tg_permanent_reply_buttons`** المتغير **تحكمًا يدويًا كاملاً** في ظهور لوحة مفاتيح الرد (الأزرار أسفل الرسالة). يتم تعطيل جميع سلوكيات الإخفاء التلقائي الخاصة بالمنصة.

**النطاق:** ينطبق هذا الإعداد على **جميع** أزرار الرد التي تم إنشاؤها في الروبوت أثناء تفعيل المتغير.

#### **العودة إلى السلوك التلقائي**

لاستعادة الإخفاء التلقائي القياسي للوحة المفاتيح:

1. **أزِل `tg_permanent_reply_buttons`** المتغير من إعدادات مشروعك.
2. **أعد إنشاء أي أزرار رد** تم إنشاؤها أصلاً أثناء تفعيل المتغير. الأزرار التي أُنشئت وفق قاعدة "دائمة" تحتفظ بهذه الحالة ويجب إعادة إنشائها لتكتسب السلوك الجديد التلقائي.

## كيفية إنشاء قائمة في تيليجرام

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

الشخص الذي أنشأ روبوت تيليجرام يمكنه إنشاء مثل هذه القائمة.

للقيام بذلك، اكتب إلى [Botfather](https://t.me/BotFather) في تيليجرام.

أدخل الأمر /mybots، وستفتح قائمة بروبوتاتك. اختر الروبوت الذي تحتاجه. ستُفتح لك قائمة. هنا تحتاج إلى اختيار **تعديل الروبوت**، ثم **تعديل الأوامر**.

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

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

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

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

يمكنك الآن رؤية القائمة واستخدامها في محادثة تيليجرام الخاصة بك مع الروبوت.

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

عند النقر على زر القائمة، ستفتح قائمة بالأوامر التي سُجِّلت مسبقًا في BotFather:

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

بعد ذلك، انتقل إلى Mavibot، وافتح المشروع الذي يتصل به روبوت تيليجرام هذا.

أنشئ **بدء** أو **المشغّل** الكتل، واكتب الأوامر في الشروط، وضمن **"نص الرسالة"** الحقل — النصوص التي سيتم استلامها ردًا.

مثال:

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

## كيفية دمج نوعين من الأزرار

أنشئ كتلة تحتوي على زر رد (لوحة مفاتيح)، الذي تحتاج إلى إظهاره.

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

أنشئ الكتلة التالية (مؤقت 0 ثانية) مع أزرار مضمنة (أزرار داخل النص)، ويجب وضعها دون إزالة أزرار الرد. على سبيل المثال: \[{"type": "inline", "text": "BUTTON NAME", "line": 0, "index\_in\_line": 0}]

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

إليك النتيجة:

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

{% hint style="success" %}
**مهم:** يجب عليك اتباع هذا الترتيب عند إضافة الأزرار في الكتلة نفسها:

1. **أولًا،** أضف جميع أزرار الرد (لوحة المفاتيح).
2. **ثم،** أضف أي أزرار مضمنة.

إذا عُكس هذا التسلسل، فسيتم حذف أزرار الرد عند إرسال كتلة الرسالة التالية.
{% 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/tylyjram/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.