# دوال API الخاصة بتيليجرام

تُوسّع وظائف API إمكانيات البوت في تيليغرام بشكل كبير. باستخدام وظائف API، يمكنك العمل مع المرفقات والمجموعات والدردشات في تيليغرام — على سبيل المثال، أتمتة حظر المستخدمين أو إلغاء حظرهم، وغير ذلك الكثير!

{% hint style="info" %}
المصدر: [واجهة برمجة تطبيقات بوت تيليغرام](https://core.telegram.org/bots/api)
{% endhint %}

{% hint style="warning" %}
مهم! 

لفهم كيفية العمل مع وظائف API، نوصي بشدة بمراجعة قواعد تحديد الدوال والمعلمات في الآلة الحاسبة.

<mark style="color:red;">**الترميز:**</mark>

<mark style="color:red;">**!**</mark> — تشير علامة التعجب إلى المعلمات المطلوبة

**parameter=None** — يوضح هذا القيمة الافتراضية للمعلمة المحددة.

يكفي <mark style="color:red;">**غير صحيح**</mark> نسخ نص الدالة ببساطة من التوثيق، مثل هذا: tg\_send\_message(platform\_id, "Some text", client\_message\_id=61818138, reply\_markup=None, parse\_mode=None, disable\_web\_page\_preview=0, protect\_content=False)

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

وبالتالي، فإن <mark style="color:green;">**الصحيح**</mark> الاستخدام سيكون: tg\_send\_message(platform\_id, "Some text", 61818138, None, None, 0, True)
{% endhint %}

### أين يمكنني الحصول على <mark style="color:red;">platform\_id</mark> لإرسال الإشعارات؟

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

<div data-with-frame="true"><figure><img src="/files/27ab89e05058be85261f3a5bde8996bd273121a6" alt="" width="359"><figcaption></figcaption></figure></div>

<details>

<summary>مثال على تمرير <mark style="color:red;">platform_id</mark> المعلمة:</summary>

1. يمكن تمرير المعلمة platform\_id دون تحديد قيم رقمية بشكل صريح.

<figure><img src="/files/388143fc9b2632ee92536d6f768d8035071d5732" alt=""><figcaption><p>تم توفير platform_id دون أي قيمة</p></figcaption></figure>

`react = tg_set_reaction(platform_id, 1556, '👌')`

ستعمل الدوال التي تحتوي على هذه المعلمة حتى بدون تحديد قيمة platform\_id صراحةً.
\
مهم: في معظم الدوال، تكون هذه المعلمة مطلوبة ولا يجوز حذفها. <br>

2\. إذا كنت بحاجة إلى استخدام الدالة في دردشة أو قناة أو مجموعة محددة، فيجب عليك توفير platform\_id كقيمة رقمية.

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

في الدالة **tg\_send\_message(!platform\_id, !text)** الموضحة أعلاه، يتم تمرير المنص&#x629;**\_id المعلمة** باستخدام علامات اقتباس تحيط بقيمة رقمية:

`tgmess = tg_send_message('1234566788', 'Hello!')`&#x20;

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

</details>

### كيفية تحديد الأزرار في المعلمة reply\_markup

**مثال على أزرار الرد:**

`opts = {"keyboard": [[{"text": "Left"}, {"text": "Right"}]]}`

**مثال على الأزرار المضمنة:**

opts = {"inline\_keyboard": \[\[{"text": "Package 1","callback\_data":1}, {"text": "Package 2","callback\_data":2}]]}

### كيفية استخدام تنسيق النص (Markdown) في المعلمة parse\_mod&#x65;**?**&#x20;

الـ **parse\_mode** تقوم المعلمة بتنسيق النص بالكامل أو أجزاء منه بصيغة *مائل* أو **غامق**. يمكن أن تكون قيمها: html أو markdown أو markdownV2.

1. <mark style="color:blue;">**إذا اخترت html:**</mark>

&#x20;        لـ **نص عريض**، استخدم  `"<b>caption</b>"`

&#x20;        لـ *نص مائل*، استخدم `"<i>caption</i>"`

2. <mark style="color:blue;">**بالنسبة إلى Markdown:**</mark>

&#x20;        لـ **نص عريض**، استخدم  `"*caption*"`

&#x20;        لـ *نص مائل*، استخدم  `"_caption_"`

**مثال على إرسال نص مائل:**\
`tg_send_message(47615196, "<i>italic</i>",None,None,"html")`

**مثال على إرسال نص عريض:**\
`tg_send_message(platform_id, '*test*', None, None, 'markdown')`


---

# 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.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.