# دوال إرسال المرفقات في الرسائل

## كيفية إرسال المستندات

<details>

<summary>إرسال مستند tg_send_document() </summary>

<mark style="color:red;">**!**</mark> تتيح لك هذه الدوال إرسال ملفات من أي نوع. التنسيقات الموصى بها: **GIF، PDF، ZIP** حتى **2 جيجابايت**.

<mark style="background-color:green;">**! يعمل مع حساب Telegram للأعمال**</mark>&#x20;

**tg\_send\_document(platform\_id, document, caption, reply\_markup, parse\_mode,reply\_to\_message\_id, protect\_content, disable\_notification**, **message\_thread\_id, entities)**&#x20;

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — معرّف العميل في Telegram الذي يجب إرسال الرسالة إليه [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii) &#x20;

<mark style="color:red;">**!**</mark>**&#x20;document** - رابط المستند على خادم Telegram. تم شرح الحصول على الرابط عبر tg\_request [هنا](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/webhook.md).&#x20;

**caption** - الوصف، حتى 1024 حرفًا

**reply\_markup** — إعدادات الأزرار [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)&#x20;

**parse\_mode** — تنسيق النص في الوصف (عريض أو مائل)  [ **\*\*\***](/doc/ar/chatbot/builder/telegram_messages.md)**.** القيم الممكنة: html، markdown، markdownV2. ссылка

**reply\_to\_message\_id -** معرّف الرسالة المطلوب الرد عليها (أي الاقتباس)

**protect\_content** — علامة لحماية المحتوى من النسخ. للتفعيل، مرّر أي قيمة غير 0 أو False أو علامتي اقتباس فارغتين ''.

**disable\_notification** —  علامة للتحكم في الإشعارات الصوتية (الافتراضي: 0).\
1 - إرسال بدون إشعار، 0 - إرسال مع إشعار

**message\_thread\_id** —  معرّف المحادثة الفرعية (متاح في المجموعات الفائقة التي تحتوي على ميزة المنتدى)\
\
**entities** — يتيح لك إعادة استخدام نص منسق مسبقًا مع الأنماط. ما عليك سوى تحديد إزاحة المحرف والنطاق للتنسيق. مثال متاح في tg\_request ضمن الحقل المقابل. يجب أن يكون على شكل قاموس.\
\
مثال على تمرير المعلمة: \
`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`  \
\
في هذا المثال، يتم عرض القاموس فقط، بينما يتم تعريف نص الرسالة الفعلي في متغير منفصل.

لتبسيط وصف مجموعة الأزرار، يمكنك استخدام ما يلي [حيلة مفيدة](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/buttons.md#telegram-web-application-button).&#x20;

</details>

<details>

<summary>إرسال عدة مستندات أو ملفات أخرى tg_send_some_document()</summary>

<mark style="color:red;">**!**</mark> تتيح لك هذه الدوال إرسال ملفات من أي نوع. التنسيقات الموصى بها: **GIF، PDF، ZIP** حتى **2 جيجابايت**.

**tg\_send\_some\_document(platform\_id, document\_list, disable\_notification, protect\_content, reply\_to\_message\_id, message\_thread\_id)**

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — معرّف العميل في Telegram الذي يجب إرسال الرسالة إليه  [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)&#x20;

<mark style="color:red;">**!**</mark>**&#x20;document\_list** - مصفوفة من المستندات. يوجد أدناه مثال على إنشاء مثل هذه المصفوفة

**disable\_notification** —   علامة للتحكم في الإشعارات الصوتية (الافتراضي: 0).\
1 - إرسال بدون إشعار، 0 - إرسال مع إشعار

**protect\_content** — علامة لحماية المحتوى من النسخ. للتفعيل، مرّر أي قيمة غير 0 أو False أو علامتي اقتباس فارغتين ''.

**reply\_to\_message\_id -** معرّف الرسالة المطلوب الرد عليها (أي الاقتباس)

**message\_thread\_id** —  معرّف المحادثة الفرعية (متاح في المجموعات الفائقة التي تحتوي على ميزة المنتدى)

**مثال على إنشاء مصفوفة document\_list:**\
'\[\["Document link", "caption", "parse\_mode"], \["Document link 2"], \["Document link 3", "caption"]]'&#x20;

**مثال على تنسيق البيانات لمستند واحد** \
\["Document link", "caption", "parse\_mode"]&#x20;

<mark style="color:red;">**ترتيب المعلمات مهم!**</mark> عند إنشاء مصفوفة من المستندات، يمكن حذف علامات الاقتباس " ".

**وصف معلمات مصفوفة document\_list:**\ <mark style="color:red;">**!**</mark>**&#x20;Document link** - رابط المستند من خادم Telegram. تم شرح الحصول على الرابط عبر tg\_request [هنا](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/webhook.md)   \
**caption** — وصف حتى 1024 حرفًا\
**parse\_mode** — تنسيق الوصف، أي تمييز النص بخط عريض أو مائل  [**\*\*\***](/doc/ar/chatbot/builder/telegram_messages.md)

</details>

<details>

<summary>مثال</summary>

لنستعرض مثالًا على إرسال مستند واحد مع إضافة أزرار مضمّنة ووصف للمستند:

1. أولًا، احصل على رابط مستندك. يمكن العثور على شرح مفصل لكيفية القيام بذلك [هنا.](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/webhook.md#how-to-get-a-media-link-using-a-variable)
2. أنشئ كتلة واضبط المتغيرات كما هو موضح في لقطة الشاشة:<br>

   <div data-with-frame="true"><figure><img src="/files/17ed8d1984e16a7d585913828e28534032b26df9" alt="" width="563"><figcaption></figcaption></figure></div>
3. أرسل الكتلة إلى أنفسنا وشاهد نتيجة عملنا:

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

والآن لننظر في إرسال عدة مستندات.

1. هنا أيضًا، تحتاج إلى الحصول على رابط داخلي من Telegram لكل مستند وتكوين مصفوفة.\
   lnkdoc='\[\["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],\["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'
2. أخيرًا، اجمع دالة إرسال المستندات:

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

3\. وتحقق من نتيجة العمل:

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

</details>

<details>

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

<mark style="color:red;">تذكّر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابطك الخاصة</mark>

مثال كود لإرسال مستند واحد:

```
lnkdoc= "BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ"
opts = {"inline_keyboard": [[{"text": "ممتاز","callback_data":"Answer1"}, {"text": "غير مقبول","callback_data":"Answer2"}]]}
soob=tg_send_document(platform_id, lnkdoc, "إرسال مستند", opts) 
```

مثال كود لإرسال عدة مستندات:

```
lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'
soob=tg_send_some_document(platform_id, lnkdoc)
```

</details>

## كيفية إرسال صوت / رسالة صوتية

<details>

<summary>إرسال رسالة صوتية <strong>tg_send_voice(</strong>)</summary>

<mark style="color:red;">!</mark> تتيح هذه الدالة إرسال ملفات صوتية من نوع .OGG بترميز OPUS وبحجم يصل إلى 2 جيجابايت.

<mark style="background-color:green;">**! يعمل فقط مع حساب Telegram للأعمال**</mark>

**tg\_send\_voice(platform\_id, voice, caption, reply\_markup, parse\_mode, reply\_to\_message\_id, protect\_content, disable\_notification, message\_thread\_id, entities)**&#x20;

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — معرّف العميل في Telegram الذي يجب إرسال الرسالة إليه [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;voice** - رابط الرسالة الصوتية بصيغة .OGG

**caption** - الوصف حتى 1024 حرفًا

**reply\_markup** — إعدادات الأزرار [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**parse\_mode** — تنسيق النص في الوصف بخط عريض أو مائل [ **\*\*\***](/doc/ar/chatbot/builder/telegram_messages.md)**.** القيم الممكنة:  html، markdown، markdownV2.

**reply\_to\_message\_id -** معرّف الرسالة المطلوب الرد عليها (أي الاقتباس)

**protect\_content** — علامة لحماية المحتوى من النسخ. للتفعيل، مرّر أي قيمة باستثناء 0 أو False أو علامتي اقتباس فارغتين ''.

**disable\_notification** —  علامة لإرسال رسالة مع إشعار صوتي (الافتراضي: 0)   1 - إرسال بدون إشعار عند الاستلام، 0 - إرسال مع إشعار

**message\_thread\_id** —  معرّف الموضوع (متاح في المجموعات الفائقة إذا كانت ميزة المنتدى مفعلة).\
\
**entities** — باستخدام هذه المعلمة يمكنك ببساطة نسخ نص منسق بكل ميزاته وتحديد من أي حرف إلى أي حرف سيُعرض بأسلوب معيّن. يمكنك الاطلاع على مثال في tg\_request في الحقل المقابل. يجب أن تكون المعلمة على شكل قاموس. \
\
مثال على تمرير المعلمة: \
`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`  \
\
يوضح المثال القاموس فقط، بينما يتم تعريف نص الرسالة نفسه في متغير.

لتبسيط وصف مجموعة الأزرار، يمكنك استخدام ما يلي [حيلة مفيدة](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>إرسال عدة رسائل صوتية <strong>tg_send_some_audio()</strong></summary>

<mark style="color:red;">**!**</mark> تتيح هذه الدالة إرسال ملفات صوتية من نوع .MP3 أو .M4A بحجم أقصى 2 جيجابايت.

<mark style="background-color:green;">**! يعمل مع حساب Telegram للأعمال**</mark>&#x20;

**tg\_send\_some\_audio(platform\_id, audio\_list, disable\_notification, protect\_content, reply\_to\_message\_id, message\_thread\_id)**&#x20;

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — معرّف العميل في Telegram الذي يجب إرسال الرسالة إليه [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;audio\_list** - مصفوفة من الملفات الصوتية (التفاصيل أدناه)

**disable\_notification** —  علامة لإرسال الرسالة مع إشعار صوتي أو بدونه (الافتراضي: 0).                                                                                                                   1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

**protect\_content** — علامة لحماية المحتوى من النسخ. للتفعيل، مرّر أي قيمة باستثناء 0 أو False أو علامتي اقتباس فارغتين ''.

**reply\_to\_message\_id -** معرّف الرسالة المطلوب الرد عليها (أي الاقتباس)

**message\_thread\_id** —  معرّف الموضوع (متاح في المجموعات الفائقة ذات وظيفة المنتدى)

**مثال على إنشاء مصفوفة audio\_list:** \
'\[\["Audio link 1", "caption", "parse\_mode"], \["Audio link 2"], \["Audio link 3", "caption"]]'&#x20;

**مثال على ملف صوتي واحد:** \
\["Audio link", "caption", "parse\_mode"]&#x20;

<mark style="color:red;">**ترتيب المعلمات مهم!**</mark> عند إنشاء مصفوفة الملفات الصوتية، يمكن حذف علامات الاقتباس ""

**وصف المعلمات:** \ <mark style="color:red;">**!**</mark>**&#x20;Audio link** - رابط إلى ملف صوتي بصيغة .OGG\
**caption** — وصف (حتى 1024 حرفًا) \
**parse\_mode** —تنسيق النص في الوصف بخط عريض أو مائل   [**\*\*\***](/doc/ar/chatbot/builder/telegram_messages.md)

</details>

<details>

<summary>مثال</summary>

كما ذكر أعلاه، تعمل الدالة مع ملفات .OGG. لذلك، تتمثل المهمة الأولى في الحصول على تسجيل صوتي بهذا التنسيق. \
إذا كان لديك ملف **.**&#x4D;P3، يمكنك تحويله إلى **.**&#x4F;GG باستخدام <https://t.me/mp3toolsbot> البوت.&#x20;

بعد ذلك، أرسل الملف الناتج إلى نفسك في البوت للحصول على file\_id باتباع الخوارزمية [الموصوفة هنا. ](#documents-an-example-of-how-to-send-using-the-telegram-api)

والآن لِنُجمّع الدالة:

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

رائع! أحسنت!

</details>

<details>

<summary>مثال للنسخ</summary>

<mark style="color:red;">تذكّر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابطك الخاصة</mark>

```
tg_send_voice(platform_id, "CQACAgIAAxkBAAER70Bi8VkgNhegB-msqDWXm2qHi3n9-AAC-iAAAk6giUvIXkW-XzBN0ikE")
```

</details>

<details>

<summary>خطأ عند إرسال الرسائل الصوتية</summary>

إذا فشلت الرسالة في الإرسال بسبب إعدادات الخصوصية، فسيظهر الخطأ التالي:

<mark style="color:red;">{"ok":false,"error\_code":400,"description":"Bad Request: user restricted receiving of voice messages"}</mark>

سبب الخطأ: تتضمن إعدادات خصوصية المستخدم خيار “عدم استقبال الرسائل الصوتية” (إما من الجميع، أو السماح فقط من مستخدمين معينين):

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

حتى إذا عطّل المستخدم هذا القيد في الخصوصية، فسيستمر ظهور الخطأ.

في الواقع، لا يساعد على تجاوز هذا الخطأ سوى إزالة العميل بالكامل من قاعدة بيانات Mavibot، حتى لو كان المستخدم قد فعّل الأذونات بالفعل.

<mark style="color:green;">**الحل:**</mark>&#x20;

بعد أن يغيّر المستخدم إعدادات الخصوصية، تحتاج إلى الانتظار 30–60 ثانية (حتى تعالج خوادم المراسلة التغييرات)، وبعدها فقط أرسل طلب API إلى Telegram عبر البوت:\ <mark style="color:green;">**<https://api.telegram.org/bot\\><TOKEN>/getChat?chat\_id=#{platform\_id}**</mark>

بعد ذلك، سيتم تحديث بيانات المستخدم وستُرسل الرسائل الصوتية بشكل صحيح.

</details>

## كيفية إرسال التحريكات

<details>

<summary>إرسال تحريك <strong>tg_send_animation()</strong></summary>

<mark style="color:red;">**!**</mark> تتيح هذه الدالة إرسال GIF أو فيديو H.264/MPEG-4 AVC بدون صوت وبحجم أقصى 2 جيجابايت.

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

**tg\_send\_animation(platform\_id, animation, caption, reply\_markup, parse\_mode, reply\_to\_message\_id, protect\_content, has\_spoiler, disable\_notification, message\_thread\_id, entities, show\_caption\_above\_media)**

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — معرّف عميل Telegram الذي يجب إرسال الرسالة إليه. [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;animation**- رابط التحريك. تم شرح كيفية الحصول على رابط عبر tg\_request [هنا](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/webhook.md)&#x20;

**caption** - وصف حتى 1024 حرفًا

**reply\_markup** — إعدادات الأزرار [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**parse\_mode** —تنسيق النص في الوصف بخط عريض أو مائل  [**\*\*\***](/doc/ar/chatbot/builder/telegram_messages.md)**.** القيم الممكنة: html، markdown، markdownV2

**reply\_to\_message\_id -** معرّف الرسالة المطلوب الرد عليها (أي الاقتباس)

**protect\_content** — علامة لحماية المحتوى من النسخ. للتفعيل، مرّر أي قيمة غير 0 أو False أو علامتي اقتباس فارغتين ''.

**has\_spoiler** — يفعّل التعتيم. للتفعيل، اضبطه على True.

**disable\_notification** —  علامة لإرسال الرسالة مع إشعار صوتي أو بدونه (الافتراضي: 0).  1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

**message\_thread\_id** —  معرّف الموضوع (متاح في المجموعات الفائقة ذات وظيفة المنتدى)\
\
**entities** — باستخدام هذه المعلمة يمكنك ببساطة نسخ نص منسق بكل ميزاته وتحديد من أي حرف إلى أي حرف سيُعرض بأسلوب معيّن. يمكنك الاطلاع على مثال في tg\_request في الحقل المقابل. يجب أن تكون المعلمة قاموسًا.&#x20;

**show\_caption\_above\_media** - إذا تم ضبطه على True، فسيتم عرض وصف الرسالة فوق الوسائط\
\
مثال على تمرير المعلمة:\
`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`  \
\
في هذا المثال، يتم عرض القاموس فقط، بينما يتم تخزين نص الرسالة نفسه في متغير

لتبسيط أوصاف مجموعة الأزرار، يمكنك استخدام ما يلي [حيلة مفيدة](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>مثال</summary>

لنُعقّد المهمة أكثر ونرسل تحريكًا مع حماية النسخ والتعتيم.

كما هو الحال دائمًا، تبدأ العملية بالحصول على رابط Telegram الداخلي للتحريك المحدد (التفاصيل [هنا](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram.md)).

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

أخيرًا، اجمع الدالة:

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

وتحقق من نتيجة العمل:

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

</details>

<details>

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

<mark style="color:red;">تذكّر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابطك الخاصة</mark>

```
animation="CgACAgIAAxkBAAIQDWO9Dbb0QODBmI_CUMhKHoWch7MDAAJBIQACtjXoScUjA-n5kGCYLQQ"
caption = "سنة جديدة سعيدة!"
soob=tg_send_animation(platform_id, animation, caption, None, None, None, True,True)
```

</details>

## كيفية إرسال الفيديوهات

<details>

<summary>إرسال فيديو باستخدام API Telegram <strong>tg_send_video()</strong></summary>

<mark style="color:red;">**!**</mark> تتيح لك هذه الدالة إرسال ملفات MPEG4 بحجم يصل إلى 2 جيجابايت. \
(يمكن إرسال التنسيقات الأخرى كملفات باستخدام tg\_send\_document())

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

**tg\_send\_video(platform\_id, video, caption, reply\_markup, parse\_mode, reply\_to\_message\_id, protect\_content, has\_spoiler, disable\_notification, message\_thread\_id, entities,** show\_caption\_above\_media, cover **)**

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — معرّف عميل Telegram الذي يجب إرسال الرسالة إليه [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;video** - رابط الفيديو. لمعرفة كيفية الحصول على الروابط عبر tg\_request انظر [هنا](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/webhook.md)&#x20;

**caption** - وصف حتى 1024 حرفًا

**reply\_markup** — إعدادات الأزرار  [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**parse\_mode** — تنسيق النص في الوصف بخط عريض أو مائل  [**\*\*\***](/doc/ar/chatbot/builder/telegram_messages.md)**.** القيم الممكنة: html، markdown، markdownV2.

**reply\_to\_message\_id -** معرّف الرسالة المطلوب الرد عليها (أي الاقتباس)

**protect\_content** — علامة لحماية المحتوى من النسخ. للتفعيل، مرّر أي قيمة غير 0 أو False أو علامتي اقتباس فارغتين ''.

**has\_spoiler** — يفعّل التعتيم. للتفعيل، اضبطه على True

**disable\_notification** — علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).   \
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

**message\_thread\_id** —  معرّف الموضوع (متاح في المجموعات الفائقة ذات وظيفة المنتدى)\
\
**entities** — باستخدام هذه المعلمة يمكنك ببساطة نسخ نص منسق بكل ميزاته وتحديد من أي حرف إلى أي حرف سيُعرض بأسلوب معيّن. يمكنك الاطلاع على مثال في tg\_request في الحقل المقابل. يجب أن تكون المعلمة قاموسًا.&#x20;

**show\_caption\_above\_media** - إذا تم ضبطه على True، فسيتم عرض نص الرسالة فوق الوسائط.

cover - صورة غلاف الفيديو في الرسالة. الحصول على الرابط عبر tg\_request [هنا](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/webhook.md). \
\
مثال على تمرير المعلمة:\
`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`  \
\
في هذا المثال، يتم عرض القاموس فقط، بينما يتم تخزين نص الرسالة نفسه في متغير

لتبسيط أوصاف مجموعة الأزرار، يمكنك استخدام ما يلي[ حيلة مفيدة](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>إرسال عدة فيديوهات باستخدام API Telegram <strong>tg_send_some_video()</strong></summary>

<mark style="background-color:green;">**! يعمل مع حساب Telegram للأعمال**</mark>&#x20;

**tg\_send\_some\_video(platform\_id, video\_list, disable\_notification, protect\_content, reply\_to\_message\_id, has\_spoiler, message\_thread\_id)**&#x20;

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — معرّف عميل Telegram الذي يجب إرسال الرسالة إليه [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;video\_list** - مصفوفة من ملفات الفيديو (التفاصيل أدناه)&#x20;

**disable\_notification** —  علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).   \
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

**reply\_to\_message\_id -** معرّف الرسالة المطلوب الرد عليها (أي الاقتباس)

**has\_spoiler** — يفعّل تنسيق التعتيم (اختياري؛ اضبطه على True للتفعيل)

**message\_thread\_id** —  معرّف الموضوع (متاح في المجموعات الفائقة ذات وظيفة المنتدى)

**مثال على إنشاء مصفوفة فيديو video\_list:** \
'\[\["Video link1", "caption", "parse\_mode"], \["Video link2"], \["Video link3", "caption"]]'

**مثال على إنشاء ملف صوتي واحد:** \
\["Video link", "caption", "parse\_mode"]&#x20;

<mark style="color:red;">**ترتيب المعلمات مهم!**</mark> عند إنشاء مصفوفة ملفات الفيديو، يمكن حذف علامات الاقتباس ""

**وصف المعلمات:** \ <mark style="color:red;">**!**</mark>**&#x20;Video link** — رابط فيديو داخلي في Telegram. تم وصف الحصول على الرابط عبر tg\_request [هنا](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/webhook.md#how-to-get-webhook).\
**caption** — وصف نصي حتى 1024 حرفًا\
**parse\_mode** — تنسيق النص في الوصف بخط عريض أو مائل  [**\*\*\***](/doc/ar/chatbot/builder/telegram_messages.md)**.** القيم الممكنة:  html، markdown، markdownV2.

</details>

<details>

<summary>مثال</summary>

لذا، ابدأ بالحصول على رابط الملف الذي نريد إرساله، ثم املأ معلمات الدالة المطلوبة:

<div data-with-frame="true"><figure><img src="/files/8f6859967415a0bab812c3cd6f1dfcd4dc291af1" alt="" width="563"><figcaption><p>الحصول على رابط الفيديو عبر tg_request</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/16b919586a5d0b0e168f49452af849d2d8fbfb96" alt="" width="563"><figcaption><p>تمرير معلمة الفيديو</p></figcaption></figure></div>

بعد التحقق نحصل على الفيديو:

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

</details>

<details>

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

<mark style="color:red;">تذكّر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابطك الخاصة</mark>

```
video="BAACAgIAAxkBAAIQFmO9Ycbt5JDIr9HKQh-XkhS9FqTxAALQIwACtjXoSXKlqfbH-I_gLQQ"
soob=tg_send_video(platform_id, video
```

</details>

## كيفية إرسال فيديو دائري

<details>

<summary>إرسال فيديو دائري <strong>tg_send_video_note()</strong></summary>

<mark style="color:red;">**!**</mark> بدءًا من الإصدار 4.0، يدعم Telegram إرسال فيديوهات MPEG4 دائرية بمدة تصل إلى دقيقة واحدة.

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

**tg\_send\_video\_note(platform\_id, video\_note,  reply\_markup, protect\_content, reply\_to\_message\_id, disable\_notification,  message\_thread\_id)** &#x20;

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — معرّف عميل Telegram الذي يجب إرسال الرسالة إليه [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;video\_note** - رابط الفيديو. تم وصف كيفية الحصول على الرابط عبر tg\_request [هنا](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/webhook.md) \
**reply\_markup** — إعدادات الأزرار [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**protect\_content** — علامة لحماية المحتوى من النسخ. للتفعيل، مرّر أي قيمة غير 0 أو False أو علامتي اقتباس فارغتين ''

**reply\_to\_message\_id -** معرّف الرسالة المطلوب الرد عليها (أي الاقتباس)

**disable\_notification** —  علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).   \
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

**message\_thread\_id** —   معرّف الموضوع (متاح في المجموعات الفائقة ذات وظيفة المنتدى)

لتبسيط أوصاف مجموعة الأزرار، يمكنك استخدام ما يلي [حيلة مفيدة ](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/buttons.md#telegram-web-application-button)

</details>

<details>

<summary>مثال</summary>

إذا كان لديك فيديو مربع الشكل، يمكنك تحويله إلى فيديو دائري باستخدام <https://t.me/roundNoteBot> البوت:&#x20;

<figure><img src="/files/8bae79d0a2057259f787a53be7dbec747e1aa9de" alt=""><figcaption><p>الحصول على بوت تحويل الفيديو إلى دائري عبر @roundNoteBot (https://t.me/roundNoteBot)</p></figcaption></figure>

بعد حصولك على الفيديو الدائري، أرسله إلى نفسك في البوت للحصول على الرابط (التفاصيل [هنا](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/api/attachment.md)), ثم اضبط دالة إرسال الفيديو الدائري:

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

</details>

<details>

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

<mark style="color:red;">تذكّر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابطك الخاصة</mark>

```
tg_send_video_note(platform_id, 'DQACAgIAAxkBAAER6cVi6OzIezJo9FWu6WyZPzDgQX8B3QACcxsAArR3SUtRizDeiHWLNikE','','1')

```

</details>

## كيفية إرسال موقع

<details>

<summary>إرسال الموقع الجغرافي <strong>tg_send_venue()</strong></summary>

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

**tg\_send\_venue(platform\_id, latitude, longitude, title, address, protect\_content, disable\_notification, reply\_to\_message\_id, reply\_markup, message\_thread\_id)**&#x20;

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — معرّف عميل Telegram الذي يجب إرسال الرسالة إليه [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;خط العرض** —خط العرض

<mark style="color:red;">**!**</mark>**&#x20;خط الطول** — خط الطول

<mark style="color:red;">**!**</mark>**&#x20;title** — العنوان

<mark style="color:red;">**!**</mark>**&#x20;address** — العنوان

**protect\_content** — علامة لحماية المحتوى من النسخ. للتفعيل، مرّر أي قيمة غير 0 أو False أو علامتي اقتباس فارغتين ''

**disable\_notification** —  علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).   \
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

**reply\_to\_message\_id -** معرّف الرسالة المطلوب الرد عليها (أي الاقتباس)

**reply\_markup** — إعدادات الأزرار  [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**message\_thread\_id** —  معرّف الموضوع (متاح في المجموعات الفائقة ذات وظيفة المنتدى)

لتبسيط أوصاف مجموعة الأزرار، يمكنك استخدام ما يلي[ حيلة مفيدة](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>مثال</summary>

لذا، لنبدأ بتحديد إحداثيات المكان. يمكنك الحصول عليها باستخدام  [خرائط Google ](https://www.google.com/maps)

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

بعد ذلك، حوّل الإحداثيات التي حصلت عليها من الدرجات العشرية إلى التنسيق الجغرافي باستخدام أي [محول إحداثيات](https://coordinates-converter.com/en/decimal/51.000000,10.000000?karte=OpenStreetMap\&zoom=8):

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

والآن، لنتابع ملء معلمات الدالة والحصول على النتيجة المطلوبة:

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

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

</details>

<details>

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

```
soob=tg_send_venue(platform_id, "48°52′", "2°4′", "Dreams come true!", "Paris, Eiffel Tower") 
```

</details>

## كيفية إرسال جهات الاتصال

<details>

<summary>إرسال جهة اتصال <strong>tg_send_contact()</strong></summary>

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

يوفر Telegram طريقة سريعة لمشاركة جهات الاتصال من دفتر العناوين الخاص بك. يدعم المراسِل إرسال **vCard** — بطاقة عمل إلكترونية

تتيح الدالة tg\_send\_contact إرسال رقم هاتف مع الاسم الأول (أو اسم المؤسسة)، بالإضافة إلى إضافة أزرار وتمكين حماية المحتوى للرسالة.

**tg\_send\_contact(platform\_id, phone, first\_name, last\_name, protect\_content, disable\_notification, reply\_to\_message\_id, reply\_markup, message\_thread\_id)**&#x20;

<mark style="color:red;">**! - معلمة مطلوبة في الدالة**</mark>

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — معرّف عميل Telegram الذي يجب إرسال الرسالة إليه [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;phone** — رقم الهاتف بالتنسيق الدولي. على سبيل المثال، لروسيا: +7XXXXXXXXXX

<mark style="color:red;">**!**</mark>**&#x20;الاسم الأول** و **اسم العائلة** - الاسم الأول واسم العائلة&#x20;

**protect\_content** — علامة لحماية المحتوى من النسخ. للتفعيل، مرّر أي قيمة غير 0 أو False أو علامتي اقتباس فارغتين ''

**disable\_notification** — علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).   \
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

**reply\_to\_message\_id -** معرّف الرسالة المطلوب الرد عليها (أي الاقتباس)

**reply\_markup** — إعدادات الأزرار [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**message\_thread\_id** —  معرّف الموضوع (متاح في المجموعات الفائقة ذات وظيفة المنتدى)

لتبسيط أوصاف مجموعة الأزرار، يمكنك استخدام ما يلي [حيلة مفيدة](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>مثال</summary>

املأ المعلمات: رقم الهاتف، الاسم الأول، واسم العائلة.

<div data-with-frame="true"><figure><img src="/files/666889809cd91995637792d707f705227d54ea74" alt="" width="563"><figcaption><p>مثال على تعبئة معلمات دالة إرسال جهة الاتصال.</p></figcaption></figure></div>

تحقق من النتيجة:

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

</details>

<details>

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

```
soob=tg_send_contact(platform_id, "+79999999999", "Ann", "Test", 1) 
```

</details>

## كيفية إرسال ملصق

<details>

<summary>إرسال ملصق <strong>tg_send_sticker()</strong></summary>

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

**tg\_send\_sticker(platform\_id, sticker\_id, protect\_content,  disable\_notification, reply\_to\_message\_id, reply\_markup, message\_thread\_id)**&#x20;

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

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — معرّف عميل Telegram الذي يجب إرسال الرسالة إليه [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;sticker\_id** - معرّف الملصق. تم شرح كيفية الحصول على رابط عبر tg\_request [هنا](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/webhook.md)&#x20;

**protect\_content** —  علامة لحماية المحتوى من النسخ. للتفعيل، مرّر أي قيمة غير 0 أو False أو علامتي اقتباس فارغتين ''

**disable\_notification** —   علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).   \
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

**reply\_to\_message\_id -** معرّف الرسالة المطلوب الرد عليها (أي الاقتباس)

**reply\_markup** — إعدادات الأزرار [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**message\_thread\_id** —  معرّف الموضوع (متاح في المجموعات الفائقة ذات وظيفة المنتدى)

لتبسيط أوصاف مجموعة الأزرار، يمكنك استخدام ما يلي [حيلة مفيدة](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>مثال</summary>

لا يختلف إرسال الملصق عن إرسال أي مرفق آخر:\
1\. احصل على رابط Telegram الداخلي (التفاصيل هنا) \
2\. املأ معلمات الدالة\
3\. أرسل الكتلة إلى نفسك وتحقق من النتيجة

<div data-with-frame="true"><figure><img src="/files/fa6695356022493bfbfb353a80aed280deede0e7" alt="" width="563"><figcaption><p>إرسال ملصق</p></figcaption></figure></div>

النتيجة:

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

</details>

<details>

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

<mark style="color:red;">تذكّر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابطك الخاصة</mark>

```
soob=tg_send_sticker(platform_id, 'CAACAgIAAxkBAAEawJ5jmNeyat8uPGBMP3JzubRNXGjH3wACrw4AAsYg4UqePobN94_jkywE')
```

</details>

## كيفية إرسال صورة

{% hint style="warning" %}

#### **فهم `caption` المعلمة**

الـ **`caption`** توفر المعلمة نصًا وصفيًا للصورة (مثل ملخص قصير أو شرح). وهي تعمل كما يلي:

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

**تجربة المستخدم:** عادةً ما يظهر نص الوصف عندما ينقر المستخدم على الصورة أو يلمسها.

> **للحصول على المواصفات التقنية التفصيلية وسلوك API، يُرجى الرجوع إلى وثائق Telegram الرسمية.**

**ملاحظة:** إذا كنت تتبع درسًا فيديويًا، فيُرجى مراجعة الخطوات بعناية لأن الإعدادات والواجهات قد تتغير مع الوقت.
{% endhint %}

<details>

<summary>إرسال صورة <strong>tg_send_photo()</strong></summary>

<mark style="color:red;">**!**</mark> يجب ألا يزيد حجم الصورة عن 10 ميجابايت. يجب ألا يتجاوز إجمالي العرض والارتفاع 10,000 بكسل. يجب ألا تتجاوز نسبة العرض إلى الارتفاع 20.

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

**tg\_send\_photo(platform\_id, photo, caption, reply\_markup, parse\_mode, reply\_to\_message\_id, protect\_content, has\_spoiler, disable\_notification, message\_thread\_id, entities, show\_caption\_above\_media)**

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** —  معرّف عميل Telegram الذي يجب إرسال الرسالة إليه [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;الصورة** - رابط الصورة. تم شرح كيفية الحصول على رابط عبر tg\_request [هنا](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/webhook.md).&#x20;

**caption** - وصف حتى 1024 حرفًا

**reply\_markup** — إعدادات الأزرار  [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**parse\_mode** — تنسيق النص في الوصف بخط عريض أو مائل  [**\*\*\***](/doc/ar/chatbot/builder/telegram_messages.md)

**reply\_to\_message\_id -** معرّف الرسالة المطلوب الرد عليها (أي الاقتباس)

**protect\_content** — علامة لحماية المحتوى من النسخ. للتفعيل، مرّر أي قيمة غير 0 أو False أو علامتي اقتباس فارغتين ''

**has\_spoiler** — يفعّل تنسيق التعتيم، اضبطه على True للتفعيل

**disable\_notification** —  علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).   \
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

**message\_thread\_id** —  معرّف الموضوع (متاح في المجموعات الفائقة ذات وظيفة المنتدى)\
\
**entities** — باستخدام هذه المعلمة يمكنك ببساطة نسخ نص منسق بكل ميزاته وتحديد من أي حرف إلى أي حرف سيُعرض بأسلوب معيّن. يمكنك الاطلاع على مثال في tg\_request في الحقل المقابل. يجب أن تكون المعلمة قاموسًا.

show\_caption\_above\_media - إذا تم ضبطه على True، فسيتم عرض نص الرسالة فوق الوسائط\
\
مثال على إرسال المعلمة: \
`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`  \
\
في هذا المثال، يتم عرض القاموس فقط، بينما يتم تخزين نص الرسالة نفسه في متغير

لتبسيط أوصاف مجموعة الأزرار، يمكنك استخدام ما يلي [حيلة مفيدة](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>إرسال عدة صور <strong>tg_send_some_photo()</strong></summary>

<mark style="color:red;">**!**</mark> يجب ألا يزيد حجم الصورة عن 10 ميجابايت. يجب ألا يتجاوز إجمالي العرض والارتفاع 10,000 بكسل. يجب ألا تتجاوز نسبة العرض إلى الارتفاع 20.

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

**tg\_send\_some\_photo(platform\_id, image\_list, disable\_notification=0**, **protect\_content=False, reply\_to\_message\_id=0, has\_spoiler=False,message\_thread\_id)**

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — معرّف عميل Telegram الذي يجب إرسال الرسالة إليه [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;image\_list** - مصفوفة ملفات الصور  (التفاصيل أدناه)&#x20;

**disable\_notification** —  علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).   \
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

**protect\_content** — علامة لحماية المحتوى من النسخ (معلمة اختيارية، وللتفعيل مرّر 1 كقيمة)

**reply\_to\_message\_id -**  معرّف الرسالة المطلوب الرد عليها (أي الاقتباس)

**has\_spoiler** — يفعّل تنسيق التعتيم (اختياري؛ اضبطه على True للتفعيل)

**message\_thread\_id** —  معرّف الموضوع (متاح في المجموعات الفائقة ذات وظيفة المنتدى)<br>

**مثال image\_list:**

`'[["Image link 1", "caption", "parse_mode"], ["Image link 2"], ["Image link 3", "caption"]]'`

**مثال على البيانات لصورة واحدة:** \
\["Image link 1", "caption", "parse\_mode"]&#x20;

<mark style="color:red;">**ترتيب المعلمات مهم!**</mark> عند إنشاء مصفوفة ملفات الصور، يمكن حذف علامات الاقتباس ""

**وصف المعلمات:&#x20;**&#x20;

<mark style="color:red;">**!**</mark>**&#x20;Image link 1** - رابط الصورة. تم شرح كيفية الحصول على رابط عبر tg\_request[ هنا](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/webhook.md) &#x20;

**caption** — وصف حتى 1024 حرفًا

**parse\_mode** — تنسيق النص في الوصف بخط عريض أو مائل [**\*\*\***](/doc/ar/chatbot/builder/telegram_messages.md)

</details>

<details>

<summary>مثال</summary>

لنلقِ نظرة على مثال دالة لإرسال عدة صور:

أولًا، أنشئ مصفوفة صور

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

بعد ذلك، املأ معلمات الدالة

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

أرسل الكتلة إلى نفسك واستمتع بالنتيجة

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

</details>

<details>

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

<mark style="color:red;">تذكّر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابط الفيديو والصور الخاصة بك</mark>

```
image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)
```

</details>

## كيفية إرسال نرد

<details>

<summary>إرسال رمز تعبيري مع اختيار عشوائي (Dice) <strong>tg_send_dice()</strong> </summary>

**tg\_send\_dice(platform\_id, emoji, reply\_markup, disable\_notification, reply\_to\_message\_id, protect\_content, message\_thread\_id)**

<mark style="background-color:green;">**! يعمل مع حساب Telegram للأعمال**</mark>&#x20;

المعلمات:

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — معرّف عميل Telegram الذي يجب إرسال الرسالة إليه [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

**emoji** - الرمز التعبيري المطلوب إرساله. إذا تركت المعلمة فارغة، فسيتم إرسال نرد افتراضيًا. يمكنك تمرير الرمز التعبيري نفسه كسلسلة نصية أو الكلمة المفتاحية المستخدمة لتمثيله

**reply\_markup** — إعداد الأزرار  [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**disable\_notification** —  علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).   \
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

**reply\_to\_message\_id -**&#x645;عرّف الرسالة المطلوب الرد عليها (أي الاقتباس)

**protect\_content** — علامة لحماية المحتوى من النسخ. للتفعيل، مرّر أي قيمة غير 0 أو False أو علامتي اقتباس فارغتين ''

**message\_thread\_id** —  معرّف الموضوع (متاح في المجموعات الفائقة ذات وظيفة المنتدى)

لتبسيط أوصاف مجموعة الأزرار، يمكنك استخدام ما يلي [حيلة مفيدة](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/buttons.md#telegram-web-application-button)&#x20;

&#x20;

**قائمة الرموز التعبيرية الممكنة:** \
1\) 'darts' أو '🎯'، القيم من 1 إلى 6 \
2\) 'dice' أو '🎲'، القيم من 1 إلى 6 \
3\) 'bowling' أو '🎳'، القيم من 1 إلى 6 \
4\) 'basketball' أو '🏀'، القيم من 1 إلى 5  \
5\) 'football' أو '⚽'، القيم من 1 إلى 5 \
6\) 'slots' أو '🎰'، القيم من 1 إلى 64&#x20;

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

</details>

<details>

<summary>مثال</summary>

أبسط خيار هو استدعاء الدالة باستخدام المعلمة المطلوبة الوحيدة:

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

في هذه الحالة، سيتلقى العميل نردًا:

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

إذا رمى العميل النرد (بالنقر على الرمز التعبيري المستلم)، فسيستقبل البوت ردًا يتضمن عدد النقاط المحققة:

<div data-with-frame="true"><figure><img src="/files/8c1151b2216212888a4027b0db9ae769f57dc226" alt="" width="553"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/47d7365d8aae70d5b874fe27f1eece24c6c002d9" alt="" width="563"><figcaption><p><strong>الرسالة الأولى:</strong> عرض اللعب</p></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/f5cd25188ea87e93b3b86f6235a22ab4644cbd02" alt="" width="563"><figcaption><p>مثال على البوت</p></figcaption></figure></div>

</details>

<details>

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

المثال الأول:

```
soob=tg_send_dice(platform_id)
```

المثال الثاني:

<pre><code>/* المثال الأول */
<strong>tg_send_message(platform_id,'انقر على ماكينة القمار لتجربة حظك!')
</strong>opts='{"inline_keyboard": [[{"text": " 👓 ","callback_data":"Play"}]]}'
soob=tg_send_dice(platform_id, 'slots', opts)

/* الكتلة الثانية - رسالة نصية */
<strong> #{res[1]} نقطة تم رميها
</strong><strong>/* الكتلة الثانية - الحاسبة */
</strong>res=splitter('#{question}', ' ')
balls=if(balls==None,0,balls) + int(res[1])

/* الكتلة الثالثة - رسالة نصية */
لديك مجموع #{balls} نقطة
</code></pre>

</details>

## كيفية إرسال مجموعة وسائط

<details>

<summary>إرسال مجموعة وسائط tg_send_media_group()</summary>

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

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

<mark style="color:orange;">**ملاحظة: لا يمكن تجميع المستندات والملفات الصوتية مع أنواع ملفات أخرى!**</mark>

tg\_send\_media\_group(platform\_id, media\_list, disable\_notification, protect\_content, reply\_to\_message\_id, message\_thread\_id)

المعلمات:

<mark style="color:red;">!</mark> platform\_id — معرّف عميل Telegram الذي يجب إرسال الرسالة إليه

<mark style="color:red;">!</mark> media\_list - مصفوفة تحتوي من 2 إلى 10 صور أو فيديوهات أو مستندات أو ملفات صوتية (التفاصيل أدناه);

disable\_notification — علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).   \
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

protect\_content — علامة لحماية المحتوى من النسخ. للتفعيل، مرّر أي قيمة غير 0 أو False أو علامتي اقتباس فارغتين ''

reply\_to\_message\_id - معرّف الرسالة المطلوب الرد عليها (أي الاقتباس)

message\_thread\_id — معرّف الموضوع (متاح في المجموعات الفائقة ذات وظيفة المنتدى);

**محتوى عناصر مصفوفة media\_list:**

<mark style="color:red;">!</mark> type - نوع الملف، “photo”، “video”، “audio” أو ”document”

<mark style="color:red;">!</mark> media - الملف المطلوب إرساله. مرّر file\_id لإرسال ملف موجود بالفعل على خوادم Telegram (موصى به)، أو عنوان URL ‏HTTP ليجلب Telegram الملف من الإنترنت، أو «attach://\<file\_attach\_name>» لتحميل ملف جديد باستخدام multipart/form-data باسم \<file\_attach\_name>.

اقرأ المزيد: <https://core.telegram.org/bots/api#sending-files>

caption — عنوان الملف المرسل، من 0 إلى 1024 حرفًا.

parse\_mode — تنسيق النص في الوصف بخط عريض أو مائل

اقرأ المزيد: <https://core.telegram.org/bots/api#sending-files>

مثال على مصفوفة media\_list:

\[{"type": "photo", "media": "AgACAgIAAxkBAAIKa2W6HqQG151EaWOKnCyy8feBi8p\_AAIH1zEbicvYSfi2QYj-CMreAQADAgADeAADNAQ", "caption": "فيديو الأشباح"}, {"type": "video", "media": "BAACAgIAAxkBAAIKpGW6P\_HGDoVz7u4blDF6925WO-hmAALVPQACicvYSYwIWCJKwKIWNAQ", “caption”: “فيديو الأرنب”}]

</details>

<details>

<summary>مثال</summary>

لنلقِ نظرة على مثال دالة لإرسال عدة صور:

أولًا، أنشئ مصفوفة صور

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

بعد ذلك، املأ معلمات الدالة

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

أرسل الكتلة إلى نفسك واستمتع بالنتيجة

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

</details>

<details>

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

<mark style="color:red;">تذكّر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابط الفيديو والصور الخاصة بك</mark>

```
image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)
```

</details>

## كيفية إرسال مرفقات ملفات كبيرة

<details>

<summary>مثال</summary>

في Telegram (لكل من حسابات الأعمال والحسابات العادية)، يمكنك إرسال المرفقات عبر رابط:

1. يمكنك إرسال مرفقات بأي حجم، متجاوزًا حدود حجم الملف.
2. يمكنك أيضًا إرسال أي نوع من المرفقات تحتاجه.

كيف تفعل ذلك:

انسخ الرابط إلى مرفق متاح للعامة بالفعل:

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

ثم الصق الرابط المنسوخ في دالة المرفق داخل الكتلة الخاصة بك:

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

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

</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/attachment.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.