# إعدادات دردشة تيليجرام والمراسلة

**العمل مع معرفات المنصات في MaviBot**

في MaviBot، يتم تعريف جميع كيانات تيليجرام (المستخدمون، المجموعات، القنوات) بواسطة `platform_id` متغير عام. هذا المتغير لا يميّز بين أنواع الكيانات.

**المشكلة:** لاستخدام وظائف مثل `قبول` أو `رفض` التي تتطلب أنواعًا محددة من الكيانات، تحتاج إلى معرفة كلٍّ من *الدردشة* المعرّف و *المستخدم* المعرّف بشكل منفصل.

**الحل:** عند استلام ردٍّ آلي أو رسالة، قم فورًا بتخزين `platform_id` القيمة في متغيرين منفصلين ومسمّيين حسب الغرض:

* **`chat_id`** — لتخزين معرّف المجموعة/القناة.
* **`user_id`** — لتخزين معرّف المستخدم الفردي.

هذا يتيح لك الإشارة إلى المعرّف الصحيح لاحقًا في منطق التطبيق.

## كيفية تغيير اسم الدردشة عبر بوت تيليجرام

<details>

<summary>الوصف</summary>

**tg\_set\_group\_title(platform\_id, title)** -&#x20;

المعلمات:

<table><thead><tr><th width="294.828125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td> <mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a>  </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> title</strong></td><td>اسم الدردشة الجديد</td></tr></tbody></table>

</details>

## كيفية تغيير وصف الدردشة عبر بوت تيليجرام

<details>

<summary>الوصف</summary>

**tg\_set\_chat\_description(platform\_id, description)**

<table><thead><tr><th width="294.828125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td> <mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a>  </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> description</strong></td><td>اسم الدردشة الجديد</td></tr></tbody></table>

</details>

## كيفية تعيين صورة رمزية لمجموعة/دردشة في تيليجرام

<details>

<summary>الوصف</summary>

**tg\_set\_chat\_photo(platform\_id, photo)**

<table><thead><tr><th width="294.828125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td> <mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a><strong>,</strong> التي تريد تعيين صورة رمزية لها</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong>  الصورة</strong></td><td>رابط الصورة</td></tr></tbody></table>

</details>

## كيفية حذف صورة رمزية من مجموعة/دردشة في تيليجرام

<details>

<summary>الوصف</summary>

**tg\_delete\_chat\_photo(platform\_id)**

<table><thead><tr><th width="294.828125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td> <mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a><strong>,</strong> التي تحتاج فيها إلى تعيين صورة رمزية</td></tr></tbody></table>

</details>

## كيفية حظر مجموعة تيليجرام

<details>

<summary>الوصف</summary>

**tg\_ban\_chat\_sender\_chat(platform\_id, sender\_chat\_id)**&#x20;

المعلمات:

<table><thead><tr><th width="294.828125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td> <mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a><strong>، والتي تحتاج إلى حظرها</strong></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> sender_chat_id</strong></td><td>معرّف الدردشة التي سيتم حظرها</td></tr></tbody></table>

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

</details>

## كيفية إلغاء حظر مجموعة تيليجرام

<details>

<summary>الوصف</summary>

**tg\_unban\_chat\_sender\_chat(platform\_id, sender\_chat\_id)**

المعلمة:

<table><thead><tr><th width="294.828125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td> <mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a><strong>,</strong> فيها تقوم بإلغاء الحظر </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> sender_chat_id</strong></td><td>معرّف الدردشة التي تلغي حظرها </td></tr></tbody></table>

</details>

## كيفية إنشاء رابط دعوة للانضمام إلى دردشة تيليجرام

<details>

<summary>الوصف</summary>

**tg\_create\_chat\_invite\_link(platform\_id, member\_limit, hours, request, name)**&#x20;

المعلمة:

<table><thead><tr><th width="282.87109375">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة في تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a> </td></tr><tr><td><strong>member_limit</strong></td><td>الحد الأقصى لعدد المشاركين</td></tr><tr><td><strong>hours</strong></td><td>وقت انتهاء صلاحية الرابط (بالساعات)</td></tr><tr><td><strong>request</strong></td><td>معلمة تُنشئ، بعد النقر على الرابط، طلبًا للانضمام إلى الدردشة.</td></tr><tr><td><strong>name</strong> </td><td>اسم الرابط</td></tr></tbody></table>

{% hint style="info" %}
عند تمرير **member\_limit** المعلمة، يتم تغيير قيمة **request** المعلمة تلقائيًا إلى **خطأ**. إذا كنت بحاجة إلى قبول طلبات الانضمام، فاترك **member\_limit** المعلمة فارغة.
{% endhint %}

**إنشاء رابط دعوة للدردشة**

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

</details>

## كيفية حذف رابط دعوة دردشة في تيليجرام

<details>

<summary>الوصف</summary>

**tg\_revoke\_chat\_invite\_link(platform\_id, invite\_link)**

المعلمات:

<table><thead><tr><th width="294.828125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td> <mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td> <mark style="color:red;"><strong>!</strong></mark><strong> invite_link</strong></td><td>الرابط الذي تحتاج إلى حذفه</td></tr></tbody></table>

</details>

## كيفية إلغاء تفعيل جميع الروابط الموجودة واستبدالها برابط واحد&#x20;

<details>

<summary>الوصف</summary>

&#x20;**tg\_export\_chat\_link(platform\_id)**

المعلمات:

<table><thead><tr><th width="294.828125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td> <mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td> <mark style="color:red;"><strong>!</strong></mark><strong> invite_link</strong></td><td>الرابط الذي تحتاج إلى حذفه</td></tr></tbody></table>

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

{% hint style="warning" %}
استخدم بحذر. ستصبح جميع روابط الدخول الحالية إلى مجموعتك غير نشطة.
{% endhint %}

</details>

## كيفية قبول طلب وإضافة مستخدم في قناة/دردشة تيليجرام

<details>

<summary>الوصف</summary>

**tg\_approve\_chat\_join\_request(chat\_id, user\_id)**

المعلمات:

<table><thead><tr><th width="279.9765625"></th><th></th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> chat_id</strong></td><td>معرّف المجموعة/القناة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a> </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> user_id</strong></td><td>معرّف المستخدم داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a> </td></tr></tbody></table>

قبول الطلب:

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

</details>

## كيفية رفض طلب في قناة/دردشة تيليجرام

<details>

<summary>الوصف</summary>

**tg\_decline\_chat\_join\_request(chat\_id, user\_id)**&#x20;

المعلمات:

<table><thead><tr><th width="279.9765625"></th><th></th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> chat_id</strong></td><td>معرّف المجموعة/القناة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a> </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> user_id</strong></td><td>معرّف المستخدم داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a> </td></tr></tbody></table>

رفض الطلب

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

</details>

## كيفية حظر مستخدم في تيليجرام

<details>

<summary>الوصف</summary>

**tg\_ban\_chat\_member(chat\_id, user\_id, hours)**&#x20;

المعلمات:

<table><thead><tr><th width="283.67578125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> chat_id</strong></td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a> </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> user_id</strong></td><td>معرّف المستخدم داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a> للحظر</td></tr><tr><td><strong>hours</strong></td><td>مدة الحظر بالساعات. افتراضيًا، يكون الحظر دائمًا. إذا حددت مدة حظر تزيد عن 366 يومًا، فسيُضبط الحظر على أنه دائم.</td></tr></tbody></table>

</details>

## كيفية إلغاء حظر مستخدم في تيليجرام&#x20;

<details>

<summary>الوصف</summary>

**tg\_unban\_chat\_member(chat\_id, user\_id)** &#x20;

المعلمات:

<table><thead><tr><th width="283.67578125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> chat_id</strong></td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a> </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> user_id</strong></td><td>معرّف المستخدم داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a><strong>,</strong>  الذي تحتاج إلى إلغاء حظره</td></tr></tbody></table>

</details>

## كيفية التحقق من حالة الاشتراك في تيليجرام

<details>

<summary>الوصف</summary>

**tg\_get\_chat\_member(chat\_id, user\_id)**&#x20;

المعلمات:

<table><thead><tr><th width="283.67578125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> chat_id</strong></td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a> </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> user_id</strong></td><td>معرّف المستخدم داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a><strong>,</strong> الذي نتحقق من اشتراكه</td></tr></tbody></table>

</details>

## كيفية تحديد عدد الأعضاء في قناة/دردشة&#x20;

<details>

<summary>الوصف</summary>

**tg\_get\_chat\_member\_count(platform\_id)**

المعلمات:

<table><thead><tr><th width="283.67578125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة في تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr></tbody></table>

</details>

## كيفية التحقق مما إذا كان أحد أعضاء الدردشة موجودًا في قائمة معينة

<details>

<summary><strong>some_client_in_list(list_id, recepient)</strong></summary>

المعلمات:

<table><thead><tr><th width="283.67578125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> list_id</strong></td><td>رقم القائمة</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> recepient</strong></td><td> معرّف المستخدم داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a>. بالنسبة لعملاء الدردشة، تكون هذه القيمة في المتغير chat_member_id.</td></tr></tbody></table>

</details>

## كيفية عرض إجراءات البوت للمستخدم (كتابة/اختيار ملصق وما إلى ذلك)

<details>

<summary>الوصف</summary>

**tg\_send\_chat\_action(platform\_id, bot\_action,  message\_thread\_id)**

<mark style="background-color:green;">**! العمل مع حساب تيليجرام للأعمال**</mark>

المعلمات:

<table><thead><tr><th width="286.74609375">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة في تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a>  </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> bot_action</strong></td><td>إجراء البوت من القائمة</td></tr><tr><td><strong>message_thread_id</strong> </td><td>معرّف الموضوع (متاح للمجموعات الفائقة إذا كانت وظيفة المنتدى متاحة).</td></tr></tbody></table>

</details>

<details>

<summary><mark style="color:orange;">قائمة الإجراءات المتاحة <strong>bot_action</strong></mark></summary>

***typing*** للرسائل النصية، \
\&#xNAN;***upload\_photo*** للصور، \
\&#xNAN;***record\_video*** أو ***upload\_video*** للفيديوهات، \
\&#xNAN;***record\_voice*** أو ***upload\_voice*** للملاحظات الصوتية، \
\&#xNAN;***upload\_document*** للمستندات العادية، \
\&#xNAN;***choose\_sticker*** للملصقات، \
\&#xNAN;***find\_location*** لبيانات الموقع، \
\&#xNAN;***record\_video\_note*** أو ***upload\_video\_note*** لملاحظة الفيديو.&#x20;

</details>

{% hint style="info" %}
سيظهر هذا الإشعار حتى يتم تلقي أي رد من البوت، ولكن لمدة لا تزيد عن 5 ثوانٍ.
{% endhint %}

## كيفية عرض إشعار تنبيه للمستخدم

<details>

<summary>الوصف</summary>

**tg\_answer\_callback\_query(callback\_query\_id, text,show\_alert,cache\_time)**&#x20;

<table><thead><tr><th width="309.5234375">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> callback_query_id</strong> <strong>(مطلوب)</strong></td><td>يسمح لك هذا المعرّف بتحديد الشخص الذي نقر على الزر وعرض إشعار التنبيه له.</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> text (مطلوب)</strong> </td><td>نص إشعار التنبيه.</td></tr><tr><td><strong>show_alert</strong></td><td>مؤشر إشعار يختفي (False — إشعار منبثق باهت على هيئة تلميح، True — نافذة إشعار دائمة)</td></tr><tr><td><strong>cache_time</strong></td><td>الحد الأقصى للوقت، بالثواني، الذي يمكن خلاله تخزين نتيجة طلب الاستدعاء مؤقتًا على جانب العميل. ستدعم تطبيقات تيليجرام التخزين المؤقت بدءًا من الإصدار 3.14. القيمة الافتراضية هي 0</td></tr></tbody></table>

</details>

<details>

<summary>مثال</summary>

تُعرض إشعارات التنبيه فقط نتيجة النقر على زر الاستدعاء في تيليجرام.

\
على سبيل المثال، نستخدم الأزرار التالية:

\[{"line":0,"index\_in\_line":0,"text":"111","type":"inline","callback":"first"}, {"line":1,"index\_in\_line":0,"text":"222","type":"inline","callback":"second"}, {"line":2,"index\_in\_line":0,"text":"333","type":"inline","callback":"third"}]&#x20;

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

بعد النقر على زر، يصل استدعاء يحتوي على النص الموجود في الحقل المقابل. عند النقر على زر “111”، ستحصل على استدعاء بالنص “first".

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

لننشئ كتلة Start ونحدد النص المطلوب في المشغّل. في حالتنا: **"first**

<figure><img src="/files/64a8485df53a9935623036e2a261d0ece1335e4c" alt=""><figcaption></figcaption></figure>

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

بعد ذلك، في الآلة الحاسبة، استخدم **tg\_answer\_callback\_query** الدالة ومرّر المعلمات التالية:\
**callback\_query\_id** - هذا المعرّف يسمح لك بتحديد المستخدم الذي ضغط الزر وعرض إشعار تنبيه له              \
**text** - نص إشعار التنبيه.

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

مثال كود للنسخ:

`tg_answer_callback_query('#{callback_query_id}', "You pressed the button 111")`&#x20;

{% hint style="warning" %}
انتبه! يجب تمرير المعلمة callback\_query\_id تمامًا كما هو موضح في المثال، أي داخل '#{}'
{% endhint %}

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

<figure><img src="/files/59cd36ecbd67f8f67848e608b7445193bb3bbec7" alt="" width="563"><figcaption></figcaption></figure>

إذا كنت تريد عرض **رسالة منبثقة بسيطة** بدلاً من ذلك، فمرّر **خطأ** كمعلمة ثالثة، كما هو موضح في المثال أدناه:\
tg\_answer\_callback\_query('#{callback\_query\_id}', "You passed the button 222", False)

<figure><img src="/files/95b32595671574fbdabe625110d9cdc99081f505" alt="" width="563"><figcaption><p>عند الضغط على الزر<br>بهذه المعلمات، سيظهر إشعار من هذا النوع<br>لبضع ثوانٍ.</p></figcaption></figure>

</details>

## إضافة إعادة توجيه بوت مع وسم كردّ على زر الاستدعاء

<details>

<summary>الوصف</summary>

**tg\_callback\_url\_open(callback\_query\_id, url, cache\_time)**

المعلمات:

<table><thead><tr><th width="309.5234375">المعلمات</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> callback_query_id</strong></td><td>يسمح لك هذا المعرّف بتحديد الشخص الذي نقر على الزر وعرض إشعار التنبيه له.</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> url</strong> </td><td>رابط URL يشير إلى البوت ومعلمة (الصيغة: t.me/your_bot?start=XXXX، حيث إن your_bot هو اسم البوت)</td></tr><tr><td><strong>cache_time</strong></td><td>الحد الأقصى للوقت، بالثواني، الذي يمكن خلاله تخزين نتيجة طلب الاستدعاء مؤقتًا على جانب العميل. ستدعم تطبيقات تيليجرام التخزين المؤقت بدءًا من الإصدار 3.14. القيمة الافتراضية هي 0</td></tr></tbody></table>

</details>

<details>

<summary>مثال</summary>

في رد زر الاستدعاء، يمكنك إضافة انتقال إلى البوت باستخدام الوسم tg\_callback\_url\_open('#{callback\_query\_id}', 't.me/bot\_name?start=XXXX')

على سبيل المثال، لنستخدم الأزرار التالية:

\[{"line":0,"index\_in\_line":0,"text":"111","type":"inline","callback":"first"}, {"line":1,"index\_in\_line":0,"text":"222","type":"inline","callback":"second"}, {"line":2,"index\_in\_line":0,"text":"333","type":"inline","callback":"third"}]

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

بعد النقر على زر، يصل استدعاء يحتوي على النص الموجود في الحقل المقابل. عند النقر على زر “111”، ستحصل على استدعاء بالنص “first".

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

أنشئ كتلة مع فحص الشرط الأساسي وحدد النص المطلوب في الشرط. في حالتنا: “first”:

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

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

بعد ذلك، في آلة حاسبة الكتلة، حدّد tg\_callback\_url\_open('#{callback\_query\_id}', 't.me/bot\_name?start=XXXX'):

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

</details>

## كيفية ترقية مستخدم إلى مشرف في مجموعة فائقة أو قناة

<details>

<summary>الوصف</summary>

**tg\_promote\_user(platform\_id, user\_id, promote\_options\_list)**

المعلمات:

<table><thead><tr><th width="269.9765625">المعامل</th><th width="515.17578125">الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف مجموعة فائقة أو، إذا استُخدم في قناة، اسم مستخدم القناة بصيغة @channelusername داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> user_id</strong></td><td>معرّف المستخدم داخل تيليجرام. <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a> </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> promote_options_list</strong></td><td>قائمة الأذونات التي سيتم تفعيلها. </td></tr></tbody></table>

</details>

<details>

<summary><mark style="color:red;">المعامل المطلوب: <strong>promote_options_list</strong></mark></summary>

يمكن تحديد الأذونات التالية في **promote\_options\_list** :

1. **is\_anonymous** — يخفي وجود المشرف في الدردشة،&#x20;
2. **can\_manage\_chat** — يمكن للمشرف الوصول إلى سجل أحداث الدردشة، وإحصاءات الدردشة، وإحصاءات الرسائل في القنوات، وعرض أعضاء القناة، وعرض المشرفين المجهولين في المجموعات الفائقة، وتجاوز الوضع البطيء. تُمنح هذه الصلاحية افتراضيًا إذا تم تحديد أي من الامتيازات اللاحقة
3. **can\_post\_messages** — — يمكن للمشرف إنشاء منشورات في القناة <mark style="color:red;">(القنوات فقط)</mark>
4. **can\_edit\_messages** — يمكن للمشرف تعديل رسائل المستخدمين الآخرين وتثبيت الرسائل <mark style="color:red;">(القنوات فقط)</mark>&#x20;
5. **can\_delete\_messages** — يمكن للمشرف حذف رسائل المستخدمين الآخرين
6. **can\_manage\_video\_chats** — يمكن للمشرف إدارة محادثات الفيديو،
7. **can\_restrict\_members** — يمكن للمشرف تقييد الأعضاء، وحظرهم/رفع الحظر عنهم في الدردشة،&#x20;
8. **can\_promote\_members** — يمكن للمشرف تعيين مشرفين جدد ببعض صلاحياته الخاصة، أو خفض رتبة المشرفين الذين عيّنهم مباشرة أو بشكل غير مباشر (مثل المشرفين الذين عيّنهم)
9. **can\_change\_info** — يمكن للمشرف تغيير عنوان الدردشة، وصورتها، والإعدادات الأخرى
10. **can\_invite\_users** — يمكن للمشرف دعوة مستخدمين جدد إلى الدردشة
11. **can\_pin\_messages** — يمكن للمشرف تثبيت الرسائل <mark style="color:red;">(المجموعات الفائقة فقط).</mark>

</details>

<details>

<summary>مثال</summary>

مثال: ترقية مستخدم إلى مشرف في مجموعة فائقة:

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

في هذا المثال، بالإضافة إلى الأذونات المحددة، سيتم منح الإذن can\_manage\_chat افتراضيًا.

<div data-with-frame="true"><figure><img src="/files/172bce2b7ca8d59135ead888f75f4ae94c5b93a6" alt="" width="563"><figcaption><p>تعيين الأذونات لمستخدم</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/9ee5dfc228612b8c86a5290024892db3f105757a" alt="" width="563"><figcaption><p>تعيين عنوان مشرف مخصص</p></figcaption></figure></div>

مثال على الكود للنسخ

<pre data-full-width="false"><code><strong>مثال 1. 
</strong><strong>promote_options_list = ‘[“can_promote_members”,”can_change_info”,”can_invite_users”]’ 
</strong>tg_promote_user(platform_id, user_id, promote_options_list)

مثال 2. 
promote_options_list = '["can_manage_chat","can_post_messages","can_edit_messages","can_delete_messages","can_manage_video_chats","can_promote_members","can_restrict_members","can_invite_users","can_pin_messages"]' 
result=tg_promote_user(platform_id, reply_from, promote_options_list)  
</code></pre>

</details>

## كيفية تغيير لقب المشرف باستخدام بوت في تيليجرام

<details>

<summary>الوصف</summary>

**tg\_set\_administrator\_title(platform\_id, user\_id, title)** &#x20;

المعلمات:&#x20;

<table><thead><tr><th width="303.94921875">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف المجموعة الفائقة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a> </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> user_id</strong></td><td>معرّف المستخدم داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a>  </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> title</strong></td><td><p>لقب المشرف</p><p>قيود اللقب:</p><p>الطول: 0–16 حرفًا، لا يُسمح بالرموز التعبيرية</p></td></tr></tbody></table>

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

يعمل هذا فقط مع المستخدمين الذين تمت ترقيتهم إلى مشرفين في المجموعة الفائقة بواسطة البوت
{% endhint %}

مثال كود للنسخ:

```
result=tg_set_administrator_title(platform_id, reply_from, "firetitle")
```

</details>

## القيود العامة لأعضاء الدردشة العاديين أو لمستخدمي تيليجرام المحددين

<details>

<summary>الوصف</summary>

**tg\_chat\_permission(platform\_id, permission, media\_permissions)**

المعلمات:

<table><thead><tr><th width="318.76171875">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a> </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> permission</strong></td><td><p>مصفوفة من القيم من قائمة القيود (انظر أدناه).</p><p>1 = الإجراء مسموح</p><p>0 = الإجراء محظور</p><p>يتوافق فهرس المصفوفة مع الموضع في قائمة القيود</p></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> media_permissions</strong></td><td><p>مصفوفة من القيم التي تحدد الأذونات المتعلقة بالوسائط (التفاصيل أدناه).</p><p>1 = الإجراء مسموح</p><p>0 = الإجراء محظور</p><p>يتوافق فهرس المصفوفة مع الموضع في قائمة أذونات الوسائط</p></td></tr></tbody></table>

</details>

<details>

<summary><strong>قائمة القيود للمعلمة المطلوبة </strong><mark style="color:red;"><strong>permission</strong></mark></summary>

**قائمة القيود الخاصة بـ** **permission:**\
1\. <mark style="color:red;">**!**</mark>**&#x20;can\_send\_messages** - إذن إرسال الرسائل النصية وجهات الاتصال والمواقع والأماكن.\
2\. <mark style="color:red;">**!**</mark>**&#x20;can\_send\_media\_messages** - إذن إرسال الصوتيات والمستندات والصور ومقاطع الفيديو وملاحظات الفيديو والملاحظات الصوتية. يتطلب **can\_send\_messages**\
3\. <mark style="color:red;">**!**</mark>**&#x20;can\_send\_polls** - إذن إرسال الاستطلاعات. يتطلب **can\_send\_messages**\
4\. <mark style="color:red;">**!**</mark>**&#x20;can\_send\_other\_messages** - إذن إرسال الرسوم المتحركة والألعاب والملصقات واستخدام البوتات المضمنة. يتطلب **can\_send\_media\_messages**\
5\. <mark style="color:red;">**!**</mark>**&#x20;can\_add\_web\_page\_previews** - إذن إضافة معاينات صفحات الويب إلى الرسائل. يتطلب **can\_send\_media\_messages**\
6\. <mark style="color:red;">**!**</mark>**&#x20;can\_change\_info** - إذن تغيير عنوان الدردشة وصورتها والإعدادات الأخرى. يتم تجاهل هذا في المجموعات الفائقة العامة.\
7\. <mark style="color:red;">**!**</mark>**&#x20;can\_invite\_users** - إذن دعوة المستخدمين\
8\. <mark style="color:red;">**!**</mark>**&#x20;can\_pin\_messages** - إذن تثبيت الرسائل. يتم تجاهل هذا في المجموعات الفائقة العامة.\
9\. **can\_manage\_topics** - إذن إنشاء مواضيع في مجموعات المنتدى. إذا استُخدم في مجموعة من النوع الخاطئ، ستفشل الدالة وتعيد خطأ.

</details>

<details>

<summary><strong>قائمة القيم للمعلمة المطلوبة </strong><mark style="color:red;"><strong>media_permissions</strong></mark></summary>

#### قيم منح الأذونات المتعلقة بالوسائط **media\_permissions:**&#x20;

1\. **can\_send\_audios** - إذن إرسال ملفات صوتية\
2\. **can\_send\_documents** - إذن إرسال المستندات\
3\. **can\_send\_photos** - إذن إرسال الصور\
4\. **can\_send\_videos**  - إذن إرسال مقاطع الفيديو\
5\. **can\_send\_video\_notes** - إذن إرسال رسائل الفيديو الدائرية\
6\. **can\_send\_voice\_notes** - إذن إرسال الرسائل الصوتيةя

</details>

## قيود تيليجرام الشخصية لمستخدمي الدردشة العاديين أو لمستخدمي تيليجرام المحددين

<details>

<summary>الوصف</summary>

**tg\_restrict\_chat\_member(platform\_id, user\_id, minutes, permission, media\_permissions).**

المعلمات:

| المعامل                                                     | الوصف                                                                                                                                                       |
| ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:red;">**!**</mark>**&#x20;platform\_id** | معرّف الدردشة في تيليجرام [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)                                                                        |
| <mark style="color:red;">**!**</mark>**&#x20;user\_id**     | معرّف المستخدم في تيليجرام [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)                                                                       |
| **minutes**                                                 | عدد الدقائق التي سيظل خلالها القيد نشطًا. إذا لم تحدد قيمة، فالقيمة الافتراضية هي **3600**، والتي تساوي **60 ساعة**. إذا ضبطته على **0**، يصبح القيد دائمًا |
| **permission**                                              | مصفوفة من القيم من [قائمة قيود الأذونات](#list-of-restrictions-for-the-required-parameter-permission).                                                      |
| **media\_permissions**                                      | قائمة بالقيم لمنح الأذونات المتعلقة بالوسائط                                                                                                                |

</details>

<details>

<summary><strong>قائمة القيود للمعلمة المطلوبة </strong><mark style="color:red;"><strong>permission</strong></mark></summary>

**قائمة القيود الخاصة بـ** **permission:**\
1\. <mark style="color:red;">**!**</mark>**&#x20;can\_send\_messages** - إذن إرسال الرسائل النصية وجهات الاتصال والمواقع والأماكن.\
2\. <mark style="color:red;">**!**</mark>**&#x20;can\_send\_media\_messages** - إذن إرسال الصوتيات والمستندات والصور ومقاطع الفيديو وملاحظات الفيديو والملاحظات الصوتية. يتطلب **can\_send\_messages**\
3\. <mark style="color:red;">**!**</mark>**&#x20;can\_send\_polls** - إذن إرسال الاستطلاعات. يتطلب **can\_send\_messages**\
4\. <mark style="color:red;">**!**</mark>**&#x20;can\_send\_other\_messages** - إذن إرسال الرسوم المتحركة والألعاب والملصقات واستخدام البوتات المضمنة. يتطلب **can\_send\_media\_messages**\
5\. <mark style="color:red;">**!**</mark>**&#x20;can\_add\_web\_page\_previews** - إذن إضافة معاينات صفحات الويب إلى الرسائل. يتطلب **can\_send\_media\_messages**\
6\. <mark style="color:red;">**!**</mark>**&#x20;can\_change\_info** - إذن تغيير عنوان الدردشة وصورتها والإعدادات الأخرى. يتم تجاهل هذا في المجموعات الفائقة العامة.\
7\. <mark style="color:red;">**!**</mark>**&#x20;can\_invite\_users** - إذن دعوة المستخدمين\
8\. <mark style="color:red;">**!**</mark>**&#x20;can\_pin\_messages** - إذن تثبيت الرسائل. يتم تجاهل هذا في المجموعات الفائقة العامة.\
9\. **can\_manage\_topics** - إذن إنشاء مواضيع في مجموعات المنتدى. إذا استُخدم في مجموعة من النوع الخاطئ، ستفشل الدالة وتعيد خطأ.&#x20;

</details>

<details>

<summary>قائمة القيم للمعلمة المطلوبة <mark style="color:red;"><strong>media_permissions</strong></mark></summary>

#### قيم منح الأذونات المتعلقة بالوسائط **media\_permissions:**&#x20;

1\. **can\_send\_audios** - إذن إرسال ملفات صوتية\
2\. **can\_send\_documents** - إذن إرسال المستندات\
3\. **can\_send\_photos** - إذن إرسال الصور\
4\. **can\_send\_videos**  - إذن إرسال مقاطع الفيديو\
5\. **can\_send\_video\_notes** - إذن إرسال رسائل الفيديو الدائرية\
6\. **can\_send\_voice\_notes** - إذن إرسال الرسائل الصوتيةя

</details>

<details>

<summary>مثال</summary>

مثال على استخدام الدالة، حيث يُقيَّد المستخدم من كل شيء لمدة 3 دقائق:

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

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

<figure><img src="/files/29a821519356771a25c9bd7fd8016ce1126e8de2" alt=""><figcaption></figcaption></figure>

مثال كود للنسخ:

```
permission = [0, 0, 0, 0, 0, 0, 0, 0] 
tg_restrict_chat_member(-1001607137668, 473737685, 3, permission)
```

</details>

## كيفية تثبيت رسالة

<details>

<summary>الوصف</summary>

**tg\_pin\_chat\_message(platform\_id, message\_id, disable\_notification)**&#x20;

المعلمات:

<table><thead><tr><th width="311.3359375">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة داخل تيليجرام  <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><strong>message_id</strong></td><td>معرّف الرسالة التي تحتاج إلى تثبيتها</td></tr><tr><td><strong>disable_notification</strong></td><td>تحدد المعلمة ما إذا كان يجب إرسال إشعار إلى جميع أعضاء الدردشة بشأن رسالة مثبتة جديدة (تكون الإشعارات دائمًا معطلة في القنوات والدردشات الخاصة).<br>إذا كنت لا تريد إرسال إشعارات، فاضبط المعلمة <strong>disable_notification</strong> إلى <strong>1</strong>.<br>وإلا، فاضبطها على <strong>0</strong>.</td></tr></tbody></table>

</details>

## كيفية إلغاء تثبيت رسالة

<details>

<summary>الوصف</summary>

**tg\_unpin\_chat\_message(platform\_id, message\_id)**&#x20;

المعلمات:

<table><thead><tr><th width="311.3359375">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><strong>message_id</strong></td><td>معرّف الرسالة التي يجب إلغاء تثبيتها. إذا لم يتم توفير message_id، فسيتم إلغاء تثبيت أحدث رسالة مثبتة (حسب تاريخ الإرسال)</td></tr></tbody></table>

</details>

## كيفية إلغاء تثبيت جميع الرسائل المثبتة

<details>

<summary>الوصف</summary>

**tg\_unpin\_all(platform\_id)**

المعلمات:

<table><thead><tr><th width="311.3359375">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr></tbody></table>

{% hint style="warning" %}
انتباه!

لدى تيليجرام قيود على وظائف تثبيت/إلغاء تثبيت الرسائل.&#x20;

الحدود الزمنية لاستخدام **tg\_pin\_chat\_message / tg\_unpin\_chat\_message / tg\_unpin\_all&#x20;**<mark style="color:red;">**لا يحددها نظام MaviBot.**</mark>&#x20;

**إذا انقضى الوقت المسموح لتثبيت رسالة، فستعيد الدالة true مع ذلك، لكن تيليجرام لن يطبق التغيير.**

ومن المهم أيضًا ملاحظة أن الرسائل المثبتة قد تبقى في ذاكرة التخزين المؤقت، لذلك قد لا تختفي بصريًا فورًا.
{% endhint %}

</details>

## كيفية إنشاء استطلاع في تيليجرام

<details>

<summary>الوصف</summary>

**tg\_send\_poll(platform\_id, question, options, is\_anonymous, allows\_multiple\_answers, reply\_markup, disable\_notification, protect\_content, token, reply\_to\_message\_id,  message\_thread\_id, business\_connection\_id)**

المعلمات:

<table><thead><tr><th width="311.3359375">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة في تيليجرام  <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a> </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> question</strong> </td><td>question</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> options</strong></td><td>مصفوفة من خيارات الإجابة</td></tr><tr><td><strong>is_anonymous</strong></td><td>1 - استطلاع مجهول، '' - غير مجهول </td></tr><tr><td><strong>allows_multiple_answers</strong></td><td>1 - يمكن اختيار أكثر من إجابة، '' - إجابة واحدة</td></tr><tr><td><strong>reply_markup</strong> </td><td>لوحة مفاتيح أو '' - بدون لوحة مفاتيح </td></tr><tr><td><strong>disable_notification</strong></td><td>علم لإرسال إشعار بصوت (الافتراضي 0)<br>1 – تعطيل الإشعار عند الاستلام، 0 – الإرسال مع إشعار</td></tr><tr><td><strong>protect_content</strong></td><td>1 للحماية من النسخ ولقطات الشاشة، '' لا حماية</td></tr><tr><td><strong>token</strong></td><td>رمز البوت؛ إذا لم يُقدَّم، فسيُستخدم الحالي</td></tr><tr><td>ر<strong>eply_to_message_id</strong></td><td>معرّف الرسالة المقتبسة</td></tr><tr><td><strong>message_thread_id</strong></td><td>معرّف الموضوع (متاح للمجموعات الفائقة إذا كانت وظيفة المنتدى موجودة)</td></tr><tr><td><strong>business_connection_id</strong></td><td>القيمة عند ربط بوت (معرّف الأعمال). تظهر في القنوات. يجب توفيرها إذا تم استخدام رمز البوت وكان يجب إرسال الرسالة عبر حساب مستخدم متصل بالبوت</td></tr></tbody></table>

</details>

<details>

<summary>مهم أن تعرف!</summary>

ملاحظات

1\. تُرجع الدالة استجابة من تيليجرام تحتوي على **message\_id**. من الأفضل حفظها. باستخدام message\_id، يمكنك إيقاف الاستطلاع باستخدام **tg\_stop\_poll** (انظر الوصف أدناه) والحصول على النتيجة.

2\. إذا أضاف مستخدم استطلاعًا في المراسلة، يُرسل ردٌّ آلي إلى الدردشة:

**poll\_added** - الجزء الثابت \
YOUR QUESTION - نص السؤال من الاستطلاع

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

مثال على ردٍّ آلي عند إضافة استطلاع إلى قناة

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

مثال على ردٍّ آلي عند إضافة استطلاع إلى دردشة

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

الردّ الآلي الثاني بعد poll\_added يحتوي على أرقام - وهو ليس سوى معرّف المستخدم في تيليجرام الذي أضاف الاستطلاع.

{% hint style="warning" %}
**عند إنشاء الاستطلاع بواسطة البوت، لا يصل ردٌّ آلي.**
{% endhint %}

&#x33;**.** في القناة يمكن إنشاء استطلاعات مجهولة فقط

{% hint style="info" %}
**انتباه، يُوصى بإرسال استطلاعات مجهولة فقط إلى المجموعة!**
{% endhint %}

4\. بعد إنشاء الاستطلاع، احفظ معرّفه في متغير لكي تفهم إلى أي استطلاع وصل الردّ الآلي.

</details>

<details>

<summary>مثال</summary>

ملاحظات العملاء هي مفتاح نمونا. توفر الاستطلاعات طريقة مباشرة لالتقاط هذه الملاحظات وتحويلها إلى استنتاجات تجارية ملموسة.

مثال كود للنسخ:

```
/* مثال على إنشاء استطلاع بسيط */
options = ["white", "red", "blue", "green"]
poll1 = tg_send_poll(platform_id, 'What is your favorite color?', options, 1, '', '', 1, '')
```

**الدالة لإنشاء استطلاع في تيليجرام:**

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

**الاستطلاع الذي أنشأناه في تيليجرام**

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

</details>

## كيفية إنشاء اختبار في تيليجرام

<details>

<summary>الوصف</summary>

**tg\_send\_quiz\_poll(platform\_id, question, options, explanation, correct\_option\_id, is\_anonymous, reply\_markup, parse\_mode, protect\_content, disable\_notification, token, reply\_to\_message\_id, message\_thread\_id )**

المعلمات:&#x20;

<table><thead><tr><th width="311.25">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> question</strong> </td><td>question</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> options</strong></td><td>مصفوفة من خيارات الإجابة</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> explanation</strong></td><td>النص المعروض عندما يختار المستخدم إجابة خاطئة أو ينقر على أيقونة المصباح في استطلاع بنمط الاختبار، من 0 إلى 200 حرفًا مع عدم وجود أكثر من فاصلَي سطر بعد تحليل الكيان.</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> correct_option_id</strong></td><td>رقم الإجابة الصحيحة، يبدأ الترقيم من 1</td></tr><tr><td><strong>is_anonymous</strong></td><td>1 - استطلاع مجهول، '' - غير مجهول </td></tr><tr><td><strong>reply_markup</strong></td><td>لوحة مفاتيح أو '' - بدون لوحة مفاتيح </td></tr><tr><td><strong>parse_mode</strong></td><td>صيغة الشرح: <code>markdown</code>, <code>html</code>، أو <code>''</code> (سلسلة فارغة لعدم وجود تنسيق)</td></tr><tr><td><strong>protect_content</strong></td><td>1 للحماية من النسخ ولقطات الشاشة، '' لا حماية</td></tr><tr><td><strong>disable_notification</strong></td><td>علم لإرسال إشعار بصوت (الافتراضي 0)<br>1 – تعطيل الإشعار عند الاستلام، 0 – الإرسال مع إشعار</td></tr><tr><td><strong>token</strong></td><td>رمز البوت؛ إذا لم يُقدَّم، فسيُستخدم الحالي</td></tr><tr><td><strong>reply_to_message_id</strong></td><td>معرّف الرسالة المقتبسة</td></tr><tr><td><strong>message_thread_id</strong></td><td>معرّف الموضوع (متاح في المجموعات الفائقة مع ميزات المنتدى النشطة)</td></tr></tbody></table>

</details>

<details>

<summary><mark style="color:orange;">مهم أن تعرف!</mark></summary>

#### **ملاحظات**

**1. احفظ `message_id`**

تُرجع دالة API استجابة من تيليجرام تحتوي على **`message_id`**. احفظ هذا المعرّف دائمًا، لأنه مطلوب من أجل:

* إنهاء الاختبار باستخدام `tg_stop_poll` الدالة (انظر الوصف أدناه).
* استرجاع النتائج النهائية.

**2. ردٌّ آلي `poll_added`**

إذا أضاف مستخدم استطلاعًا إلى **قناة**، يتلقى البوت ردًّا آليًا:

* **الصيغة:** `poll_added` + **سؤال الاستطلاع**
* **إذا أُضيف إلى دردشة مجموعة:** فإن الردّ الآلي يتضمن أيضًا **معرّف مستخدم تيليجرام** للشخص الذي أضاف الاستطلاع.

{% hint style="warning" %}
**إذا تم إنشاؤه بواسطة البوت:** لا `poll_added` يتم إرسال ردٍّ آلي.
{% endhint %}

**3. تقييد القناة**

فقط **الاختبارات المجهولة** يمكن إنشاؤها في القنوات.

**4. ردٌّ آلي `poll_answer` (تصويت المستخدم)**

عندما يصوّت مستخدم في اختبار أُرسل إلى **دردشة خاصة** أو **group**، يُرسل ردٌّ آلي إلى محادثة البوت مع ذلك العميل:

* **الصيغة:** `poll_answer` + **معرّف الاستطلاع** + **\[فهرس الإجابة]**
* **مثال:** `poll_answer 5325838371359031648 [3]`
* **ملاحظة:** يبدأ ترقيم الإجابات من **0**. `[3]` يعني أن المستخدم اختار خيار الإجابة الرابع.

**5. Webhook لاستطلاعات المجموعات غير المجهولة**

لـ **الاستطلاعات غير المجهولة** في المجموعات التي يكون البوت فيها مشرفًا، يتم إرسال webhook لكل *تصويت*. عند استلامه، سيقوم البوت بتمرير `poll_answer` الردّ الآلي (كما في النقطة 4) إلى محادثته مع العميل المقابل.

**6. متطلب التفعيل وأفضل الممارسات**

* **المتطلب:** لا يمكن للبوت بدء محادثة. إذا لم يسبق للعميل التواصل مع البوت، فلا يمكنك إرسال رسالة مباشرة له ردًا على تصويته حتى **يُفعّل البوت أولًا** (على سبيل المثال، عن طريق إرسال `/start` أمر).

{% hint style="info" %}
**التوصية:** لتجنب هذا القيد، يُ **نوصي بشدة بإرسال الاختبارات المجهولة فقط إلى المجموعات.**
{% endhint %}

**7. تتبّع استطلاعاتك**

فور إنشاء اختبار، احفظ **معرّف الاستطلاع** الفريد الخاص به في متغير. يتيح لك هذا تحديد أي استطلاع محدد يشير إليه ردٌّ آلي وارد.

</details>

<details>

<summary>مثال</summary>

مثال كود للنسخ.

```
options = ["white", "red", "blue", "green"] 
r = tg_send_quiz_poll(platform_id, "What color is a crocodile?", options, "That is the explanation", 4, '', '', '', '', 1)
```

مثال: إنشاء اختبار.

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

</details>

## كيفية إنهاء استطلاع

<details>

<summary>الوصف</summary>

**tg\_stop\_poll(platform\_id, message\_id)**

المعلمات:

<table><thead><tr><th width="303.45703125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة في تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> message_id</strong></td><td>معرّف رسالة الاستطلاع/الاختبار. يمكن الحصول عليه من webhook</td></tr></tbody></table>

{% hint style="info" %}
استدعاء هذه الدالة لإنهاء استطلاع/اختبار يعيد قاموسًا يحتوي على النتائج النهائية.
{% endhint %}

</details>

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

{% hint style="warning" %}
مهم: الموضوع الرئيسي للمجموعة لا يملك معرّفًا ويتطلب دوالًا منفصلة للتعامل معه.
{% endhint %}

### كيفية إعادة تسمية الموضوع العام للمجموعة

<details>

<summary>الوصف</summary>

**tg\_edit\_general\_forum\_topic(platform\_id, topic\_name)**

المعلمات:

<table><thead><tr><th width="303.1171875">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> topic_name</strong></td><td>اسم الموضوع الجديد</td></tr><tr><td>bot_name</td><td><p>معامل اختياري: اسم البوت.</p><p>عند العمل مع المواضيع، يمكنك تحديد أي بوت يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات تيليجرام. اعثر على اسم البوت في قسم "Channels"، في حقل "Group ID".</p></td></tr></tbody></table>

</details>

<details>

<summary>مثال</summary>

يمكن تغيير الموضوع العام للمجموعات باستخدام `tg_edit_general_forum_topic()` الدالة. تتطلب معاملين إلزاميين: معرّف الدردشة والاسم الجديد لموضوع المجموعة:

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

</details>

<details>

<summary>مثال على الكود للنسخ</summary>

*إعادة تسمية دردشة الموضوع العام*/\
`answer = tg_edit_general_forum_topic(-1001839380031, 'General')`

</details>

### كيفية إغلاق الموضوع العام

<details>

<summary>الوصف</summary>

**tg\_close\_general\_forum\_topic(platform\_id)**

المعلمات:

<table><thead><tr><th width="315.3203125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td>bot_name</td><td><p>معامل اختياري: اسم البوت.</p><p>عند العمل مع المواضيع، يمكنك تحديد أي بوت يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات تيليجرام. اعثر على اسم البوت في قسم "Channels"، في حقل "Group ID".</p></td></tr></tbody></table>

</details>

<details>

<summary>مثال على الكود للنسخ</summary>

/*إغلاق دردشة الموضوع العام*/\
`answer = tg_close_general_forum_topic(-1001839380031)`

</details>

### كيفية إعادة فتح موضوع عام تم إغلاقه سابقًا

<details>

<summary>الوصف</summary>

**tg\_reopen\_general\_forum\_topic(platform\_id)**&#x20;

المعلمات:

<table><thead><tr><th width="315.3203125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td>bot_name</td><td><p>معامل اختياري: اسم البوت.</p><p>عند العمل مع المواضيع، يمكنك تحديد أي بوت يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات تيليجرام. اعثر على اسم البوت في قسم "Channels"، في حقل "Group ID".</p></td></tr></tbody></table>

</details>

<details>

<summary>مثال كود للنسخ</summary>

/*إعادة فتح دردشة الموضوع العام*/\
`answer = tg_reopen_general_forum_topic(-1001839380031)`

</details>

### كيفية إخفاء الموضوع العام

<details>

<summary>الوصف</summary>

**tg\_hide\_general\_forum\_topic(platform\_id)**&#x20;

المعلمات:

<table><thead><tr><th width="315.3203125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td>bot_name</td><td><p>معامل اختياري: اسم البوت.</p><p>عند العمل مع المواضيع، يمكنك تحديد أي بوت يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات تيليجرام. اعثر على اسم البوت في قسم "Channels"، في حقل "Group ID".</p></td></tr></tbody></table>

يمكن إغلاق دردشة الموضوع العام أمام المشاركين في الموضوع (يمكنهم القراءة لكن لا يمكنهم الكتابة) وإخفاؤها من قائمة الدردشات العامة في تيليجرام للمستخدمين الجدد.

</details>

<details>

<summary>مثال على الكود للنسخ</summary>

/إخفاء دردشة الموضوع العام/\
`answer = tg_hide_general_forum_topic(-1001839380031)`

</details>

### **كيفية عرض الموضوع العام أو استعادة ظهوره**

<details>

<summary>الوصف</summary>

**tg\_unhide\_general\_forum\_topic(platform\_id)**&#x20;

المعلمات:

<table><thead><tr><th width="315.3203125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>معرّف الموضوع داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td>bot_name</td><td><p>معامل اختياري: اسم البوت.</p><p>عند العمل مع المواضيع، يمكنك تحديد أي بوت يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات تيليجرام. اعثر على اسم البوت في قسم "Channels"، في حقل "Group ID".</p></td></tr></tbody></table>

{% hint style="warning" %} <mark style="color:red;">**مهم!**</mark>&#x20;

هذه الدالة لا تعيد فتح الموضوع العام؛ إنها تجعله مرئيًا فقط.
{% endhint %}

</details>

<details>

<summary>مثال على الكود للنسخ</summary>

/*عرض دردشة الموضوع العام*/\
`answer = tg_unhide_general_forum_topic(-1001839380031)`

</details>

### كيفية إنشاء موضوع جديد في تيليجرام

<details>

<summary>الوصف</summary>

**tg\_create\_forum\_topic(platform\_id, name, icon, icon\_color)**&#x20;

المعلمات:

<table><thead><tr><th width="312.953125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> name</strong></td><td>اسم الموضوع الجديد</td></tr><tr><td><strong>icon</strong></td><td>معرّف الإيموجي الذي سيتم تعيينه للموضوع. يُمرَّر كسلسلة نصية. يمكنك استخدام الإيموجي فقط من القائمة المسترجعة بواسطة <code>tg_get_forum_icon</code> .</td></tr><tr><td><strong>icon_color</strong></td><td>لون الإيموجي من القائمة: 7322096، 16766590، 13338331، 9367192، 16749490، 16478047. لا تدعم جميع الإيموجي تغيير اللون.</td></tr><tr><td>bot_name </td><td><p>معامل اختياري: اسم البوت.</p><p>عند العمل مع المواضيع، يمكنك تحديد أي بوت يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات تيليجرام. اعثر على اسم البوت في قسم "Channels"، في حقل "Group ID".</p></td></tr></tbody></table>

{% hint style="info" %}
اللون المحدد لا يمكن تغييره؛ لا يمكن تعيين اللون إلا عند إنشاء الموضوع.
{% endhint %}

عند التنفيذ، ستعيد الدالة استجابة تحتوي على معلمات الموضوع الجديد، بما في ذلك معرّف الموضوع (المطلوب للعديد من الدوال).

</details>

<details>

<summary>مثال على الكود للنسخ</summary>

لإنشاء دردشة موضوع إضافية\
`answer = tg_create_forum_topic(-1001839380031, 'second_bot_topic', None, 7322096)`

لحفظ معرّف دردشة الموضوع الإضافي الذي تم إنشاؤه\
`answer={"ok":true,"result":{"message_thread_id":254,"name":"second_bot_topic","icon_color":7322096}}/`\
`idtema1=answer['result']['message_thread_id']`

</details>

### كيفية تعديل موضوع. كيفية إعادة التسمية و/أو تغيير الإيموجي لموضوع

<details>

<summary>الوصف</summary>

**tg\_edit\_forum\_topic(platform\_id, message\_thread\_id, name, icon)**&#x20;

المعلمات:

<table><thead><tr><th width="301.7578125">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> message_thread_id</strong></td><td>معرّف دردشة الموضوع الإضافي</td></tr><tr><td><strong>name</strong></td><td>اسم الموضوع الجديد</td></tr><tr><td><strong>icon</strong></td><td>معرّف الإيموجي الذي سيتم تعيينه للموضوع. يُمرَّر كسلسلة نصية. يمكنك استخدام الإيموجي فقط من القائمة المسترجعة بواسطة <code>tg_get_forum_icon</code> .</td></tr><tr><td>bot_name</td><td><p>معامل اختياري: اسم البوت.</p><p>عند العمل مع المواضيع، يمكنك تحديد أي بوت يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات تيليجرام. اعثر على اسم البوت في قسم "Channels"، في حقل "Group ID".</p></td></tr></tbody></table>

</details>

<details>

<summary>مثال على الكود للنسخ</summary>

`answer = tg_edit_forum_topic(-1001839380031, 254)`

</details>

### كيفية إغلاق موضوع محدد

<details>

<summary>الوصف</summary>

إغلاق موضوع يعني جعله للقراءة فقط؛ الكتابة في موضوع مغلق غير مسموحة.

**tg\_close\_forum\_topic(platform\_id, message\_thread\_id)**&#x20;

المعلمات:

<table><thead><tr><th width="300.9765625">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> message_thread_id</strong></td><td>معرّف دردشة الموضوع الإضافي</td></tr><tr><td>bot_name</td><td><p>معامل اختياري: اسم البوت.</p><p>عند العمل مع المواضيع، يمكنك تحديد أي بوت يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات تيليجرام. اعثر على اسم البوت في قسم "Channels"، في حقل "Group ID".</p></td></tr></tbody></table>

</details>

<details>

<summary>مثال على الكود للنسخ</summary>

`answer = tg_close_forum_topic(-1001839380031, 254)`

</details>

### كيفية إعادة فتح موضوع تم إغلاقه سابقًا

<details>

<summary>الوصف</summary>

**tg\_reopen\_forum\_topic(platform\_id, message\_thread\_id)**&#x20;

المعلمات:

<table><thead><tr><th width="300.9765625">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> message_thread_id</strong></td><td>معرّف دردشة الموضوع الإضافي</td></tr><tr><td>bot_name</td><td><p>معامل اختياري: اسم البوت.</p><p>عند العمل مع المواضيع، يمكنك تحديد أي بوت يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات تيليجرام. اعثر على اسم البوت في قسم "Channels"، في حقل "Group ID".</p></td></tr></tbody></table>

</details>

<details>

<summary>مثال على الكود للنسخ</summary>

`answer = tg_reopen_forum_topic(-1001839380031, 254)`

</details>

### كيفية حذف موضوع وجميع رسائله

<details>

<summary>الوصف</summary>

**tg\_delete\_forum\_topic(platform\_id, message\_thread\_id)**&#x20;

المعلمات:

<table><thead><tr><th width="300.9765625">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> message_thread_id</strong></td><td>معرّف دردشة الموضوع الإضافي</td></tr><tr><td>bot_name</td><td><p>معامل اختياري: اسم البوت.</p><p>عند العمل مع المواضيع، يمكنك تحديد أي بوت يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات تيليجرام. اعثر على اسم البوت في قسم "Channels"، في حقل "Group ID".</p></td></tr></tbody></table>

</details>

<details>

<summary>مثال على الكود للنسخ</summary>

`answer = tg_delete_forum_topic(-1001839380031, 254)`

</details>

### كيفية إلغاء تثبيت جميع الرسائل في موضوع

<details>

<summary>الوصف</summary>

**tg\_unpin\_topic\_messages(platform\_id, message\_thread\_id)**&#x20;

المعلمات:

<table><thead><tr><th width="300.9765625">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>معرّف الدردشة داخل تيليجرام <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> message_thread_id</strong></td><td>معرّف دردشة الموضوع الإضافي</td></tr><tr><td>bot_name</td><td><p>معامل اختياري: اسم البوت.</p><p>عند العمل مع المواضيع، يمكنك تحديد أي بوت يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات تيليجرام. اعثر على اسم البوت في قسم "Channels"، في حقل "Group ID".</p></td></tr></tbody></table>

</details>

<details>

<summary>مثال على الكود للنسخ</summary>

`answer = tg_unpin_topic_messages(-1001839380031, 254)`

</details>

### كيفية الحصول على قائمة الإيموجي لموضوع تيليجرام

<details>

<summary>الوصف</summary>

<mark style="background-color:blue;">**كيفية الحصول على قائمة الإيموجي**</mark>

`tg_get_forum_icon()` – تعيد هذه الدالة قائمة بالإيموجي المتاحة للاستخدام كأيقونات لموضوعات المنتدى. يجب إسناد النتيجة إلى متغير، لأنها تُرجع قاموسًا حيث يمثل كل مفتاح إيموجي وقيمته المقابلة هي المعرف الفريد للإيموجي (`id`).

المعلمات: <mark style="color:green;">**لا شيء.**</mark>&#x20;

</details>

<details>

<summary>محتوى قائمة الإيموجي</summary>

للحصول على قائمة الإيموجي لدردشة موضوع، أرسل الأمر إلى الدردشة المعنية.

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

ستعيد الدالة قائمة الإيموجي في استجابتها. وهذا يعني أن المتغير `answer` سيحتوي على قاموس كقيمته.

{'📰': '5434144690511290129', '💡': '5312536423851630001', '⚡️': '5312016608254762256', '🎙': '5377544228505134960', '🔝': '5418085807791545980', '🗣': '5368697802761185083', '🆒': '5420216386448270341', '❗️': '5379748062124056162', '📝': '5357193964787081133', '📆': '5433614043006903194', '📁': '5357315181649076022', '🔎': '5309965701241379366', '📣': '5309984423003823246', '🔥': '5312241539987020022', '❤️': '5312138559556164615', '❓': '5377316857231450742', '📈': '5350305691942788490', '📉': '5350713563512052787', '💎': '5309958691854754293', '💰': '5350452584119279096', '💸': '5309929258443874898', '\U0001fa99': '5377690785674175481', '💱': '5310107765874632305', '⁉️': '5377438129928020693', '🎮': '5309950797704865693', '💻': '5350554349074391003', '📱': '5409357944619802453', '🚗': '5312322066328853156', '🏠': '5312486108309757006', '💘': '5310029292527164639', '🎉': '5310228579009699834', '‼️': '5377498341074542641', '🏆': '5312315739842026755', '🏁': '5408906741125490282', '🎬': '5368653135101310687', '🎵': '5310045076531978942', '🔞': '5420331611830886484', '📚': '5350481781306958339', '👑': '5357107601584693888', '⚽️': '5375159220280762629', '🏀': '5384327463629233871', '📺': '5350513667144163474', '👀': '5357121491508928442', '\U0001fae6': '5357185426392096577', '🍓': '5310157398516703416', '💄': '5310262535021142850', '👠': '5368741306484925109', '✈️': '5348436127038579546', '\U0001f9f3': '5357120306097956843', '🏖': '5310303848311562896', '⛅️': '5350424168615649565', '🦄': '5413625003218313783', '🛍': '5350699789551935589', '👜': '5377478880577724584', '🛒': '5431492767249342908', '🚂': '5350497316203668441', '🛥': '5350422527938141909', '🏔': '5418196338774907917', '🏕': '5350648297189023928', '🤖': '5309832892262654231', '\U0001faa9': '5350751634102166060', '🎟': '5377624166436445368', '🏴\u200d☠️': '5386395194029515402', '🗳': '5350387571199319521', '🎓': '5357419403325481346', '🔭': '5368585403467048206', '🔬': '5377580546748588396', '🎶': '5377317729109811382', '🎤': '5382003830487523366', '🕺': '5357298525765902091', '💃': '5357370526597653193', '\U0001fa96': '5357188789351490453', '💼': '5348227245599105972', '\U0001f9ea': '5411138633765757782', '👨\u200d👩\u200d👧\u200d👦': '5386435923204382258', '👶': '5377675010259297233', '🤰': '5386609083400856174', '💅': '5368808634392257474', '🏛': '5350548830041415279', '\U0001f9ee': '5355127101970194557', '🖨': '5386379624773066504', '👮\u200d♂️': '5377494501373780436', '\U0001fa7a': '5350307998340226571', '💊': '5310094636159607472', '💉': '5310139157790596888', '\U0001f9fc': '5377468357907849200', '\U0001faaa': '5418115271267197333', '🛃': '5370947704199323325', '🍽': '5350344462612570293', '🐟': '5384574037701696503', '🎨': '5310039132297242441', '🎭': '5350658016700013471', '🎩': '5357504778685392027', '🔮': '5350367161514732241', '🍹': '5350520238444126134', '🎂': '5310132165583840589', '☕️': '5350392020785437399', '🍣': '5350406176997646350', '🍔': '5350403544182694064', '🍕': '5350444672789519765', '\U0001f9a0': '5312424913615723286', '💬': '5417915203100613993', '🎄': '5312054580060625569', '🎃': '5309744892677727325'}

</details>

<details>

<summary>مثال على الكود للنسخ</summary>

```
answer = tg_get_forum_icon()
```

</details>


---

# 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/api/chat.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.