العمل مع معرفات المنصة في MaviBot
في MaviBot، يتم تحديد جميع كيانات Telegram (المستخدمين، المجموعات، القنوات) بواسطة متغير عام platform_id. لا يميز هذا المتغير بين أنواع الكيانات.
المشكلة: لاستخدام وظائف مثل accept أو reject التي تتطلب أنواع كيانات محددة، تحتاج إلى معرفة كل من معرف الدردشة ومعرف المستخدم بشكل منفصل.
الحل: عند استلام رد اتصال أو رسالة، قم فورًا بتخزين قيمة platform_id في متغيرين متميزين ومحددي الاسم:
-
chat_id– لتخزين معرف المجموعة/القناة. -
user_id– لتخزين معرف المستخدم الفردي.
يسمح لك هذا بالإشارة إلى المعرف الصحيح لاحقًا في منطق تطبيقك.
كيفية تغيير اسم الدردشة عبر بوت Telegram
الوصف
tg_set_group_title(platform_id, title)
يغير عنوان مجموعة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف الدردشة داخل Telegram. |
| title | اسم الدردشة الجديد. |
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram * |
| **!** title | اسم الدردشة الجديد |
كيفية تغيير وصف الدردشة عبر بوت Telegram
الوصف
tg_set_chat_description(platform_id, description)
يغير وصف دردشة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف الدردشة داخل Telegram. |
| description | وصف الدردشة الجديد. |
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram * |
| **!** description | اسم الدردشة الجديد |
كيفية تعيين صورة رمزية في مجموعة/دردشة في Telegram
الوصف
tg_set_chat_photo(platform_id, photo)
يعين صورة ملف شخصي جديدة لدردشة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف الدردشة داخل Telegram حيث تريد تعيين صورة ملف شخصي جديدة. |
| photo | رابط مباشر للصورة. |
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram *، التي تريد تعيين صورة رمزية فيها |
| **!** photo | رابط الصورة |
كيفية حذف صورة رمزية في مجموعة/دردشة في Telegram
الوصف
tg_delete_chat_photo(platform_id)
يزيل صورة الملف الشخصي الحالية من دردشة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف الدردشة داخل Telegram التي تريد إزالة صورة الملف الشخصي منها. |
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram *، التي تحتاج إلى تعيين صورة رمزية فيها |
كيفية حظر مجموعة Telegram
الوصف
tg_ban_chat_sender_chat(platform_id, sender_chat_id)
يحظر دردشة مرسل من نشر الرسائل في دردشة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف دردشة Telegram حيث سيتم حظر دردشة المرسل. |
| sender_chat_id | معرف دردشة المرسل المراد حظرها. |
ملاحظة
بمجرد الحظر، لن يتمكن مالك دردشة المرسل من نشر الرسائل نيابة عن تلك الدردشة في دردشة Telegram المحددة حتى تتم إزالة الحظر.
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram *، التي تحتاج إلى حظرها |
| **!** sender_chat_id | معرف الدردشة التي سيتم حظرها |
في الوقت نفسه، لا يمكن لمالك الدردشة المحظورة الكتابة نيابة عن دردشاته الأخرى حتى يتم حظره.
كيفية إلغاء حظر مجموعة Telegram
الوصف
tg_unban_chat_sender_chat(platform_id, sender_chat_id)
يلغي حظر دردشة مرسل تم حظرها سابقًا في دردشة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف دردشة Telegram حيث سيتم إلغاء حظر دردشة المرسل. |
| sender_chat_id | معرف دردشة المرسل المراد إلغاء حظرها. |
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram *، التي تقوم بإلغاء الحظر فيها |
| **!** sender_chat_id | معرف الدردشة التي تقوم بإلغاء حظرها |
كيفية إنشاء رابط دعوة للانضمام إلى دردشة Telegram
الوصف
tg_create_chat_invite_link(platform_id, member_limit, hours, request, name)
ينشئ رابط دعوة جديدًا لدردشة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف دردشة Telegram. |
| member_limit | الحد الأقصى لعدد المستخدمين الذين يمكنهم الانضمام باستخدام رابط الدعوة هذا. |
| hours | وقت انتهاء صلاحية رابط الدعوة، بالساعات. |
| request | إذا تم تعيينه على True، يجب على المستخدمين الذين ينقرون على الرابط تقديم طلب انضمام يمكن للمسؤول الموافقة عليه. |
| name | اسم مخصص لرابط الدعوة. |
مهم
إذا تم تحديد معامل member_limit، يتم تعيين معامل request تلقائيًا على
False.لمطالبة المستخدمين بتقديم طلبات انضمام، اترك معامل member_limit فارغًا.
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة في Telegram * |
| member_limit | الحد الأقصى لعدد المشاركين |
| hours | وقت انتهاء صلاحية الرابط (بالساعات) |
| request | معامل يحدد أنه بعد النقر على الرابط، يجب إنشاء طلب للانضمام إلى الدردشة. |
| name | اسم الرابط |
عند تمرير معامل member_limit، يتم تغيير قيمة معامل request تلقائيًا إلى False. إذا كنت بحاجة إلى قبول طلبات العضوية، فاترك معامل member_limit فارغًا.
إنشاء رابط دعوة الدردشة

كيفية حذف رابط دعوة الدردشة في Telegram
الوصف
tg_revoke_chat_invite_link(platform_id, invite_link)
يلغي رابط دعوة موجود لدردشة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف دردشة Telegram. |
| invite_link | رابط الدعوة المراد إلغاؤه. |
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram * |
| **!** invite_link | الرابط الذي تحتاج إلى حذفه |
كيفية تعطيل جميع الروابط الموجودة واستبدالها برابط واحد
الوصف
tg_export_chat_link(platform_id)
ينشئ رابط دعوة رئيسي جديد لدردشة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف دردشة Telegram. |
تحذير
تنشئ هذه الطريقة رابط دعوة رئيسي جديد للدردشة.
ستصبح جميع روابط الدعوة الرئيسية التي تم إنشاؤها مسبقًا غير نشطة. سيكون الرابط الذي تم إنشاؤه حديثًا هو رابط الدعوة الرئيسي النشط الوحيد حتى يتم إنشاء روابط دعوة إضافية.
استخدم هذه الطريقة بحذر.
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram * |
| **!** invite_link | الرابط الذي تحتاج إلى حذفه |
كيفية قبول الطلب وإضافة مستخدم في قناة/دردشة Telegram
الوصف
tg_approve_chat_join_request(chat_id, user_id)
يوافق على طلب انضمام معلق لمجموعة أو قناة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| chat_id | معرف مجموعة أو قناة Telegram. |
| user_id | معرف مستخدم Telegram للمستخدم الذي يجب الموافقة على طلب الانضمام الخاص به. |
| **!** chat_id | معرف المجموعة/القناة داخل Telegram * |
| **!** user_id | معرف المستخدم داخل Telegram * |
قبول الطلب:

كيفية رفض الطلب في قناة/دردشة Telegram
الوصف
tg_decline_chat_join_request(chat_id, user_id)
يرفض طلب انضمام معلق لمجموعة أو قناة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| chat_id | معرف مجموعة أو قناة Telegram. |
| user_id | معرف مستخدم Telegram للمستخدم الذي يجب رفض طلب الانضمام الخاص به. |
| **!** chat_id | معرف المجموعة/القناة داخل Telegram * |
| **!** user_id | معرف المستخدم داخل Telegram * |

كيفية حظر مستخدم في Telegram
الوصف
tg_ban_chat_member(chat_id, user_id, hours)
يحظر مستخدمًا من دردشة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| chat_id | معرف دردشة Telegram. |
| user_id | معرف مستخدم Telegram للمستخدم المراد حظره. |
| hours | مدة الحظر، بالساعات. إذا تم حذفه، يكون الحظر دائمًا. |
ملاحظة
إذا تجاوزت قيمة الساعات 366 يومًا، فسيتم حظر المستخدم بشكل دائم.
| المعامل | الوصف |
|---|---|
| **!** chat_id | معرف الدردشة داخل Telegram * |
| **!** user_id | معرف المستخدم داخل Telegram * للحظر |
| hours | مدة الحظر بالساعات. افتراضيًا، الحظر دائم. إذا حددت مدة حظر تزيد عن 366 يومًا، فسيتم تعيين الحظر على أنه دائم. |
كيفية إلغاء حظر مستخدم في Telegram
الوصف
tg_unban_chat_member(chat_id, user_id)
يلغي حظر مستخدم من دردشة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| chat_id | معرف دردشة Telegram. |
| user_id | معرف مستخدم Telegram للمستخدم المراد إلغاء حظره. |
| المعامل | الوصف |
|---|---|
| **!** chat_id | معرف الدردشة داخل Telegram * |
| **!** user_id | معرف المستخدم داخل Telegram *, الذي تحتاج إلى إلغاء حظره |
كيفية التحقق من حالة الاشتراك في Telegram
الوصف
tg_get_chat_member(chat_id, user_id)
يسترجع معلومات حول حالة عضوية مستخدم في دردشة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| chat_id | معرف دردشة Telegram. |
| user_id | معرف مستخدم Telegram للمستخدم الذي سيتم التحقق من حالة عضويته. |
| المعامل | الوصف |
|---|---|
| **!** chat_id | معرف الدردشة داخل Telegram * |
| **!** user_id | معرف المستخدم داخل Telegram *, الذي نتحقق من اشتراكه |
كيفية تحديد عدد الأعضاء في القناة/الدردشة
الوصف
tg_get_chat_member_count(platform_id)
يعيد العدد الإجمالي للأعضاء في دردشة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف دردشة Telegram. |
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة في Telegram * |
كيفية التحقق مما إذا كان عضو الدردشة موجودًا في قائمة محددة
some_client_in_list(list_id, recepient)
يتحقق مما إذا كان مستخدم Telegram مدرجًا في القائمة المحددة.
المعاملات
| المعامل | الوصف |
|---|---|
| list_id | معرف القائمة المراد التحقق منها. |
| recepient | معرف مستخدم Telegram. لأعضاء الدردشة، استخدم المتغير chat_member_id. |
| المعامل | الوصف |
|---|---|
| **!** list_id | رقم القائمة |
| **!** recepient | معرف المستخدم داخل Telegram *. بالنسبة لعملاء الدردشة، هذه القيمة موجودة في المتغير chat_member_id. |
كيفية عرض إجراءات البوت للمستخدم (طباعة/اختيار ملصق، إلخ.)
الوصف
tg_send_chat_action(platform_id, bot_action, message_thread_id)
يرسل إجراء دردشة (مثل الكتابة أو تحميل ملف) إلى دردشة Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف دردشة Telegram. |
| bot_action | إجراء الدردشة المراد عرضه. اختر أحد إجراءات دردشة Telegram المدعومة. |
| message_thread_id | معرف الموضوع. متاح فقط للمجموعات الفائقة التي تم تمكين المواضيع (المنتديات) فيها. |
ملاحظة
هذه الوظيفة مدعومة عند العمل مع حسابات Telegram التجارية.
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة في Telegram * |
| **!** bot_action | إجراء البوت من القائمة |
| message_thread_id | معرف الموضوع (متاح للمجموعات الفائقة إذا كانت وظيفة المنتدى متاحة). |
**قائمة الإجراءات المتاحة bot_action**
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 للملاحظة المرئية.
سيتم عرض هذا الإشعار حتى يتم تلقي أي رد من البوت، ولكن ليس أكثر من 5 ثوانٍ.
كيفية عرض إشعار تنبيه للمستخدم
الوصف
tg_answer_callback_query(callback_query_id, text, show_alert, cache_time)
يرسل ردًا على استعلام رد اتصال يتم تشغيله عندما ينقر المستخدم على زر مضمن في Telegram.
المعاملات
| المعامل | الوصف |
|---|---|
| callback_query_id | معرف استعلام رد الاتصال المستلم عندما ينقر المستخدم على زر مضمن. يحدد هذا رد الاتصال الذي يجب الرد عليه. |
| text | النص المراد عرضه في الإشعار. |
| show_alert | يتحكم في كيفية عرض الإشعار. عيّن إلى False لعرض إشعار مؤقت على شكل تلميح، أو True لعرض مربع حوار تنبيه دائم. |
| cache_time | الحد الأقصى للوقت، بالثواني، الذي يمكن خلاله تخزين استجابة رد الاتصال مؤقتًا على جانب العميل. القيمة الافتراضية هي 0. تدعم عملاء Telegram التخزين المؤقت بدءًا من الإصدار 3.14. |
مهم
يمكن استخدام هذه الوظيفة فقط كرد على نقر المستخدم على زر رد اتصال مضمن في Telegram.
مثال
ترسل لوحة المفاتيح المضمنة التالية قيم رد اتصال مختلفة عند النقر على كل زر:
[{"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"}]

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

لنقم بإنشاء كتلة بداية وتحديد النص المطلوب في المشغل. في حالتنا: "first"

إذا قمت في حقل المطابقات بتحديد تجاهل الأخطاء وعدم الدقة، فيمكن إعادة استخدام هذه الكتلة لاحقًا لجميع المتغيرات المماثلة التي تختلف بحرف أو حرفين. على سبيل المثال، لشكر المستخدم على تقديم تقييم باستخدام هذا الزر.
بعد ذلك، في الآلة الحاسبة، استخدم الدالة tg_answer_callback_query وقم بتمرير المعاملات التالية:
callback_query_id - يسمح لك هذا المعرف بتحديد المستخدم الذي ضغط على الزر وعرض إشعار تنبيه له
text - نص إشعار التنبيه.

مثال على الكود للنسخ:
tg_answer_callback_query('#{callback_query_id}', "لقد ضغطت على الزر 111")
انتبه! يجب تمرير المعامل callback_query_id تمامًا كما هو موضح في المثال، أي داخل '#{}'
إذا تم إعداد كل شيء بشكل صحيح، فسيؤدي الضغط على الزر إلى ظهور إشعار تنبيه مع النص المحدد. في الإصدار المحمول، سيظهر اسم البوت كرأس فوق النص.

إذا كنت تريد عرض رسالة منبثقة بسيطة بدلاً من ذلك، فمرر False كمعامل ثالث، كما هو موضح في المثال أدناه:
tg_answer_callback_query('#{callback_query_id}', "لقد تجاوزت الزر 222", False)

إضافة إعادة توجيه البوت بعلامة كاستجابات زر رد اتصال
الوصف
tg_callback_url_open(callback_query_id, url, cache_time)
يفتح بوت Telegram باستخدام رابط عميق كرد على رد اتصال زر مضمن.
المعاملات
| المعامل | الوصف |
|---|---|
| callback_query_id | معرف استعلام رد الاتصال المستلم عندما ينقر المستخدم على زر مضمن. يحدد هذا رد الاتصال الذي يجب الرد عليه. |
| url | رابط عميق للبوت بالتنسيق https://t.me/your_bot?start=XXXX، حيث your_bot هو اسم مستخدم البوت و XXXX هو معامل البدء. |
| cache_time | الحد الأقصى للوقت، بالثواني، الذي يمكن خلاله تخزين استجابة رد الاتصال مؤقتًا على جانب العميل. القيمة الافتراضية هي 0. تدعم عملاء Telegram التخزين المؤقت بدءًا من الإصدار 3.14. |
مهم
يمكن استخدام هذه الوظيفة فقط كرد على نقر المستخدم على زر رد اتصال مضمن في Telegram.
مثال
في استجابة زر رد الاتصال، يمكنك إضافة انتقال إلى البوت باستخدام العلامة 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"}]

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

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

إذا قمت في حقل خيار المطابقة بتحديد تجاهل الأخطاء وعدم الدقة، فيمكن إعادة استخدام هذه الكتلة لاحقًا لجميع المتغيرات المماثلة التي تختلف بحرف أو حرفين. على سبيل المثال، لشكر المستخدم على تقديم تقييم باستخدام هذا الزر.
بعد ذلك، في الآلة الحاسبة للكتلة، حدد tg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX'):

كيفية ترقية مستخدم إلى مشرف في مجموعة فائقة أو قناة
الوصف
tg_promote_user(platform_id, user_id, promote_options_list)
ترقية مستخدم تيليجرام إلى مشرف في مجموعة فائقة أو قناة مع الصلاحيات المحددة.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف المجموعة الفائقة في تيليجرام، أو اسم مستخدم القناة بالتنسيق @channelusername عند ترقية مستخدم في قناة. |
| user_id | معرف مستخدم تيليجرام للمستخدم المراد ترقيته. |
| promote_options_list | قائمة بصلاحيات المشرف التي سيتم منحها للمستخدم. |
ملاحظة
سيتم منح المستخدم فقط الصلاحيات المضمنة في promote_options_list.
**المعامل المطلوب: promote_options_list**
يمكن تحديد الصلاحيات التالية في promote_options_list :
- is_anonymous — يخفي وجود المشرف في الدردشة،
- can_manage_chat — يمكن للمشرف الوصول إلى سجل أحداث الدردشة، وإحصائيات الدردشة، وإحصائيات الرسائل في القنوات، وعرض أعضاء القناة، وعرض المشرفين المجهولين في المجموعات الفائقة، وتجاوز الوضع البطيء. يتم منح هذا المستوى من الصلاحية افتراضيًا إذا تم تحديد أي من الامتيازات اللاحقة
- can_post_messages — يمكن للمشرف إنشاء منشورات القناة (للقنوات فقط)
- can_edit_messages — يمكن للمشرف تعديل رسائل المستخدمين الآخرين وتثبيت الرسائل (للقنوات فقط)
- can_delete_messages — يمكن للمشرف حذف رسائل المستخدمين الآخرين
- can_manage_video_chats — يمكن للمشرف إدارة محادثات الفيديو،
- can_restrict_members — يمكن للمشرف تقييد الأعضاء، وحظر/إلغاء حظرهم في الدردشة،
- can_promote_members — يمكن للمشرف تعيين مشرفين جدد بمجموعة فرعية من صلاحياته الخاصة، أو خفض رتبة المشرفين الذين عينهم بشكل مباشر أو غير مباشر (على سبيل المثال، المشرفون الذين عينهم)
- can_change_info — يمكن للمشرف تغيير عنوان الدردشة، والصورة، والإعدادات الأخرى
- can_invite_users — يمكن للمشرف دعوة مستخدمين جدد إلى الدردشة
- can_pin_messages — يمكن للمشرف تثبيت الرسائل (للمجموعات الفائقة فقط).
مثال
مثال: ترقية مستخدم إلى مشرف في مجموعة فائقة:

في هذا المثال، بالإضافة إلى الصلاحيات المحددة، سيتم منح صلاحية can_manage_chat افتراضيًا.


مثال كود للنسخ
مثال 1.
promote_options_list = ‘[“can_promote_members”,”can_change_info”,”can_invite_users”]’
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)
كيفية تغيير لقب المشرف باستخدام بوت في تيليجرام
الوصف
tg_set_administrator_title(platform_id, user_id, title)
تعيين لقب مشرف مخصص لمشرف مجموعة فائقة في تيليجرام.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف المجموعة الفائقة في تيليجرام. |
| user_id | معرف مستخدم تيليجرام للمشرف. |
| title | لقب المشرف المخصص. |
مهم
- يجب أن يتراوح طول اللقب بين 0 و 16 حرفًا.
- الرموز التعبيرية غير مسموح بها في اللقب.
- تعمل هذه الوظيفة فقط للمشرفين الذين تمت ترقيتهم بواسطة البوت.
مثال
result = tg_set_administrator_title(platform_id, reply_from, "firetitle")
القيود العامة لأعضاء الدردشة العاديين أو مستخدمي تيليجرام محددين
الوصف
tg_chat_permission(platform_id, permission, media_permissions)
تعيين الصلاحيات الافتراضية للأعضاء في دردشة تيليجرام.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف دردشة تيليجرام. |
| permission | مصفوفة من صلاحيات الدردشة العامة. يتوافق كل عنصر مع صلاحية في قائمة الصلاحيات المدعومة. استخدم 1 للسماح بالإجراء و 0 لمنعه. |
| media_permissions | مصفوفة من الصلاحيات المتعلقة بالوسائط. يتوافق كل عنصر مع صلاحية في قائمة صلاحيات الوسائط المدعومة. استخدم 1 للسماح بالإجراء و 0 لمنعه. |
ملاحظة
يجب أن يتطابق ترتيب القيم في كلا المصفوفتين مع ترتيب قوائم الصلاحيات المقابلة. يتحكم كل عنصر في المصفوفة في صلاحية محددة:
1— الصلاحية ممنوحة.0— الصلاحية مرفوضة.
قائمة القيود للمعامل المطلوب **permission**
قائمة القيود لـ permission:\
- ! can_send_messages - الإذن بإرسال الرسائل النصية، جهات الاتصال، المواقع، والأماكن.\
- ! can_send_media_messages - الإذن بإرسال الصوت، المستندات، الصور، الفيديو، ملاحظات الفيديو، وملاحظات الصوت. يتطلب can_send_messages\
- ! can_send_polls - الإذن بإرسال الاستطلاعات. يتطلب can_send_messages\
- ! can_send_other_messages - الإذن بإرسال الرسوم المتحركة، الألعاب، الملصقات، واستخدام البوتات المضمنة. يتطلب can_send_media_messages\
- ! can_add_web_page_previews - الإذن بإضافة معاينات صفحات الويب إلى الرسائل. يتطلب can_send_media_messages\
- ! can_change_info - الإذن بتغيير عنوان الدردشة، الصورة، والإعدادات الأخرى. يتم تجاهله في المجموعات الفائقة العامة.\
- ! can_invite_users - الإذن بدعوة المستخدمين\
- ! can_pin_messages - الإذن بتثبيت الرسائل. يتم تجاهله في المجموعات الفائقة العامة.\
- can_manage_topics - الإذن بإنشاء مواضيع في مجموعات المنتدى. إذا تم استخدامه في مجموعة من النوع الخاطئ، ستفشل الوظيفة وترجع خطأ.
قائمة القيم للمعامل المطلوب **media_permissions**
قيم منح الصلاحيات المتعلقة بالوسائط media_permissions:
- can_send_audios - الإذن بإرسال ملفات الصوت\
- can_send_documents - الإذن بإرسال المستندات\
- can_send_photos - الإذن بإرسال الصور\
- can_send_videos - الإذن بإرسال مقاطع الفيديو\
- can_send_video_notes - الإذن بإرسال رسائل الفيديو الدائرية\
- can_send_voice_notes - الإذن بإرسال الرسائل الصوتية
القيود الشخصية في تيليجرام لمستخدمي الدردشة العاديين أو لمستخدمي تيليجرام محددين
الوصف
tg_restrict_chat_member(platform_id, user_id, minutes, permission, media_permissions).
المعاملات:
| المعامل | الوصف |
|---|---|
| ! platform_id | معرف الدردشة في تيليجرام * |
| ! user_id | معرف المستخدم في تيليجرام * |
| minutes | عدد الدقائق التي سيظل خلالها التقييد نشطًا. إذا لم تقم بتعيين قيمة، فإن القيمة الافتراضية هي 3600، والتي تساوي 60 ساعة. إذا قمت بتعيينها على 0، يصبح التقييد دائمًا |
| permission | مصفوفة من القيم من قائمة قيود الصلاحية. |
| media_permissions | قائمة بقيم منح الصلاحيات المتعلقة بالوسائط |
قائمة القيود للمعامل المطلوب **permission**
قائمة القيود لـ permission:\
- ! can_send_messages - الإذن بإرسال الرسائل النصية، جهات الاتصال، المواقع، والأماكن.\
- ! can_send_media_messages - الإذن بإرسال الصوت، المستندات، الصور، الفيديو، ملاحظات الفيديو، وملاحظات الصوت. يتطلب can_send_messages\
- ! can_send_polls - الإذن بإرسال الاستطلاعات. يتطلب can_send_messages\
- ! can_send_other_messages - الإذن بإرسال الرسوم المتحركة، الألعاب، الملصقات، واستخدام البوتات المضمنة. يتطلب can_send_media_messages\
- ! can_add_web_page_previews - الإذن بإضافة معاينات صفحات الويب إلى الرسائل. يتطلب can_send_media_messages\
- ! can_change_info - الإذن بتغيير عنوان الدردشة، الصورة، والإعدادات الأخرى. يتم تجاهله في المجموعات الفائقة العامة.\
- ! can_invite_users - الإذن بدعوة المستخدمين\
- ! can_pin_messages - الإذن بتثبيت الرسائل. يتم تجاهله في المجموعات الفائقة العامة.\
- can_manage_topics - الإذن بإنشاء مواضيع في مجموعات المنتدى. إذا تم استخدامه في مجموعة من النوع الخاطئ، ستفشل الوظيفة وترجع خطأ.
قائمة القيم للمعامل المطلوب **media_permissions**
قيم منح الصلاحيات المتعلقة بالوسائط media_permissions:
- can_send_audios - الإذن بإرسال ملفات الصوت\
- can_send_documents - الإذن بإرسال المستندات\
- can_send_photos - الإذن بإرسال الصور\
- can_send_videos - الإذن بإرسال مقاطع الفيديو\
- can_send_video_notes - الإذن بإرسال رسائل الفيديو الدائرية\
- can_send_voice_notes - الإذن بإرسال الرسائل الصوتية
مثال
مثال على استخدام الوظيفة، حيث يتم تقييد المستخدم من كل شيء لمدة 3 دقائق:

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

مثال كود للنسخ:
permission = [0, 0, 0, 0, 0, 0, 0, 0]
tg_restrict_chat_member(-1001607137668, 473737685, 3, permission)
كيفية تثبيت رسالة
الوصف
tg_pin_chat_message(platform_id, message_id, disable_notification)
تثبت رسالة في محادثة تيليجرام.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف محادثة تيليجرام. |
| message_id | معرف الرسالة المراد تثبيتها. |
| disable_notification | يتحكم في ما إذا كان أعضاء المحادثة سيتم إعلامهم بالرسالة المثبتة. اضبط على 1 لتثبيت الرسالة بصمت، أو 0 لإرسال إشعار. |
ملاحظة
يتم دائمًا تعطيل الإشعارات في القنوات والمحادثات الخاصة، بغض النظر عن قيمة disable_notification.
كيفية إلغاء تثبيت رسالة
الوصف
tg_unpin_chat_message(platform_id, message_id)
تلغي تثبيت رسالة في محادثة تيليجرام.
المعاملات
| المعامل | الوصف |
|---|---|
| platform_id | معرف محادثة تيليجرام. |
| message_id | معرف الرسالة المراد إلغاء تثبيتها. إذا تم حذفه، يتم إلغاء تثبيت أحدث رسالة مثبتة. |
ملاحظة
إذا لم يتم تحديد message_id، تقوم الدالة بإلغاء تثبيت أحدث رسالة مثبتة بناءً على وقت إرسالها.
كيفية إلغاء تثبيت جميع الرسائل المثبتة
الوصف
tg_unpin_all(platform_id)
المعاملات:
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف المحادثة داخل تيليجرام * |
انتباه!
لدى تيليجرام قيود على وظائف تثبيت/إلغاء تثبيت الرسائل.
**الحدود الزمنية لاستخدام tg_pin_chat_message / tg_unpin_chat_message / tg_unpin_all ليست محددة من قبل نظام MaviBot.
إذا انقضى الوقت المسموح به لتثبيت رسالة، ستظل الدالة ترجع true، لكن تيليجرام لن يطبق التغيير.
من المهم أيضًا ملاحظة أن الرسائل المثبتة قد تبقى في ذاكرة التخزين المؤقت، لذلك قد لا تختفي بصريًا على الفور.
كيفية إنشاء استطلاع رأي في تيليجرام
الوصف
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)
المعاملات:
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف المحادثة في تيليجرام * |
| **!** question | السؤال |
| **!** options | مصفوفة من خيارات الإجابة |
| is_anonymous | 1 - استطلاع مجهول ، '' - غير مجهول |
| allows_multiple_answers | 1 - إجابات متعددة متاحة، '' - إجابة واحدة |
| reply_markup | لوحة مفاتيح أو '' - بدون لوحة مفاتيح |
| disable_notification | علامة للإرسال مع إشعار صوتي (الافتراضي 0) 1 – تعطيل الإشعار عند الاستلام، 0 – إرسال مع إشعار |
| protect_content | 1 للحماية من النسخ ولقطات الشاشة، '' بدون حماية |
| token | رمز البوت؛ إذا لم يتم توفيره، يتم استخدام الرمز الحالي |
| reply_to_message_id | معرف الرسالة المقتبسة |
| message_thread_id | معرف الموضوع (متاح للمجموعات الفائقة إذا كانت وظيفة المنتدى موجودة) |
| business_connection_id | القيمة عند توصيل بوت (معرف الأعمال). يظهر في القنوات. يجب توفيره إذا تم استخدام رمز البوت ويجب إرسال الرسالة عبر حساب مستخدم متصل بالبوت |
من المهم معرفته!
ملاحظات
-
ترجع الدالة ردًا من تيليجرام يحتوي على message_id. من الأفضل حفظه. باستخدام message_id، يمكنك إيقاف الاستطلاع باستخدام tg_stop_poll (انظر الوصف أدناه) والحصول على النتيجة.
-
إذا أضاف مستخدم استطلاعًا في مراسل، يتم إرسال رد اتصال إلى المحادثة:
poll_added - جزء ثابت
YOUR QUESTION - نص السؤال من الاستطلاع

مثال على رد الاتصال عند إضافة استطلاع إلى قناة

مثال على رد الاتصال عند إضافة استطلاع إلى محادثة

رد الاتصال الثاني بعد poll_added يحتوي على أرقام - هذا ليس سوى معرف المستخدم في تيليجرام الذي أضاف الاستطلاع.
عند إنشاء استطلاع بواسطة البوت، لا يصل رد اتصال.
3. في القناة، يمكنك فقط إنشاء استطلاعات مجهولة
انتباه، يُوصى بإرسال استطلاعات مجهولة فقط إلى المجموعة!
- بعد إنشاء الاستطلاع، احفظ معرفه في متغير لفهم أي استطلاع وصل إليه رد الاتصال.
مثال
ملاحظات العملاء هي مفتاح نمونا. تقدم الاستطلاعات طريقة مباشرة لالتقاط هذه الملاحظات وترجمتها إلى استنتاجات تجارية ملموسة.
مثال على الكود للنسخ:
/* Example of creating a simple poll */
options = ["white", "red", "blue", "green"]
poll1 = tg_send_poll(platform_id, 'What is your favorite color?', options, 1, '', '', 1, '')
وظيفة إنشاء استطلاع في تيليجرام:

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

كيفية إنشاء اختبار في تيليجرام
الوصف
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 )
المعاملات:
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف المحادثة داخل تيليجرام * |
| **!** question | السؤال |
| **!** options | مصفوفة من خيارات الإجابة |
| **!** explanation | نص يظهر عندما يختار المستخدم إجابة خاطئة أو ينقر على أيقونة المصباح في استطلاع من نوع الاختبار، 0-200 حرف مع عدم وجود أكثر من فاصلتي سطر بعد تحليل الكيان. |
| **!** correct_option_id | رقم الإجابة الصحيحة، الترقيم من 1 |
| is_anonymous | 1 - استطلاع مجهول ، '' - غير مجهول |
| reply_markup | لوحة مفاتيح أو '' - بدون لوحة مفاتيح |
| parse_mode | تنسيق الشرح: markdown، html، أو '' (سلسلة فارغة بدون تنسيق) |
| protect_content | 1 للحماية من النسخ ولقطات الشاشة، '' بدون حماية |
| disable_notification | علامة للإرسال مع إشعار صوتي (الافتراضي 0) 1 – تعطيل الإشعار عند الاستلام، 0 – إرسال مع إشعار |
| token | رمز البوت؛ إذا لم يتم توفيره، يتم استخدام الرمز الحالي |
| reply_to_message_id | معرف الرسالة المقتبسة |
| message_thread_id | معرف الموضوع (متاح في المجموعات الفائقة مع ميزات المنتدى النشطة) |
**من المهم معرفته!**
ملاحظات
1. احفظ message_id
ترجع دالة API ردًا من تيليجرام يحتوي على message_id. احفظ هذا المعرف دائمًا، حيث أنه مطلوب من أجل:
- إنهاء الاختبار باستخدام دالة
tg_stop_poll(انظر الوصف أدناه). - استرداد النتائج النهائية.
2. رد الاتصال poll_added
إذا أضاف مستخدم استطلاعًا إلى قناة، يتلقى البوت رد اتصال:
-
التنسيق:
poll_added+ سؤال الاستطلاع - إذا تمت الإضافة إلى محادثة جماعية: يتضمن رد الاتصال أيضًا معرف مستخدم تيليجرام للشخص الذي أضاف الاستطلاع.
إذا تم إنشاؤه بواسطة البوت: لا يتم إرسال رد اتصال
poll_added.
3. قيود القناة
يمكن إنشاء اختبارات مجهولة فقط في القنوات.
4. رد الاتصال poll_answer (تصويت المستخدم)
عندما يصوت مستخدم في اختبار تم إرساله إلى محادثة خاصة أو مجموعة، يتم إرسال رد اتصال إلى حوار البوت مع ذلك العميل:
-
التنسيق:
poll_answer+ معرف الاستطلاع + [فهرس الإجابة] -
مثال:
poll_answer 5325838371359031648 [3] -
ملاحظة: يبدأ ترقيم الإجابات من 0.
[3]يعني أن المستخدم اختار خيار الإجابة الرابع.
5. webhook لاستطلاعات المجموعة غير المجهولة
بالنسبة لاستطلاعات الرأي غير المجهولة في المجموعات التي يكون فيها البوت مشرفًا، يتم إرسال webhook لكل صوت. عند استلامه، سيقوم البوت بإعادة توجيه رد الاتصال poll_answer (كما في النقطة 4) إلى حواره مع العميل المقابل.
6. شرط التفعيل وأفضل الممارسات
-
الشرط: لا يمكن للبوت بدء محادثة. إذا لم يتصل العميل بالبوت مطلقًا، فلا يمكنك إرسال رسالة مباشرة إليه ردًا على صوته حتى يقوم بتفعيل البوت أولاً (على سبيل المثال، عن طريق إرسال أمر
/start).
توصية: لتجنب هذا القيد، يُوصى بشدة بإرسال اختبارات مجهولة فقط إلى المجموعات.
7. تتبع استطلاعاتك
مباشرة بعد إنشاء اختبار، احفظ معرف الاستطلاع الفريد الخاص به في متغير. يتيح لك ذلك تحديد أي استطلاع محدد يشير إليه رد الاتصال الوارد.
مثال
مثال على الكود للنسخ.
options = ["white", "red", "blue", "green"]
r = tg_send_quiz_poll(platform_id, "What color is a crocodile?", options, "That is the explanation", 4, '', '', '', '', 1)
مثال: إنشاء اختبار.

كيفية إنهاء استطلاع رأي
الوصف
tg_stop_poll(platform_id, message_id)
المعاملات:
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف المحادثة في تيليجرام * |
| **!** message_id | معرف رسالة الاستطلاع/الاختبار. يمكن الحصول عليه من webhook |
استدعاء هذه الدالة لإنهاء استطلاع/اختبار يرجع قاموسًا يحتوي على النتائج النهائية.
كيفية العمل مع المواضيع في تيليجرام
مهم: موضوع المجموعة الرئيسي ليس له معرف ويتطلب دوال منفصلة للعمل معه.
كيفية إعادة تسمية الموضوع العام للمجموعة
الوصف
tg_edit_general_forum_topic(platform_id, topic_name)
المعاملات:
| المعامل | الوصف |
|---|---|
| **!** platform_id | معرف المحادثة داخل تيليجرام * |
| **!** topic_name | اسم الموضوع الجديد |
| bot_name |
معامل اختياري: اسم البوت. عند العمل مع المواضيع، يمكنك تحديد أي بوت يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات تيليجرام. ابحث عن اسم البوت في قسم "القنوات"، في حقل "معرف المجموعة". |
مثال
يمكن تغيير الموضوع العام للمجموعات باستخدام الدالة tg_edit_general_forum_topic(). تتطلب معلمتين إلزاميتين: معرف الدردشة والاسم الجديد لموضوع المجموعة:

مثال كود للنسخ
/إعادة تسمية دردشة الموضوع العام/
answer = tg_edit_general_forum_topic(-1001839380031, 'General')
كيفية إغلاق الموضوع العام
الوصف
tg_close_general_forum_topic(platform_id)
المعلمات:
| المعلمة | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram * |
| bot_name |
معلمة اختيارية: اسم البوت. عند العمل مع المواضيع، يمكنك تحديد البوت الذي يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات Telegram. ابحث عن اسم البوت في قسم "القنوات"، في حقل "معرف المجموعة". |
مثال كود للنسخ
/إغلاق دردشة الموضوع العام/
answer = tg_close_general_forum_topic(-1001839380031)
كيفية إعادة فتح موضوع عام مغلق سابقًا
الوصف
tg_reopen_general_forum_topic(platform_id)
المعلمات:
| المعلمة | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram * |
| bot_name |
معلمة اختيارية: اسم البوت. عند العمل مع المواضيع، يمكنك تحديد البوت الذي يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات Telegram. ابحث عن اسم البوت في قسم "القنوات"، في حقل "معرف المجموعة". |
مثال كود للنسخ
/إعادة فتح دردشة الموضوع العام/
answer = tg_reopen_general_forum_topic(-1001839380031)
كيفية إخفاء الموضوع العام
الوصف
tg_hide_general_forum_topic(platform_id)
المعلمات:
| المعلمة | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram * |
| bot_name |
معلمة اختيارية: اسم البوت. عند العمل مع المواضيع، يمكنك تحديد البوت الذي يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات Telegram. ابحث عن اسم البوت في قسم "القنوات"، في حقل "معرف المجموعة". |
يمكن إغلاق دردشة الموضوع العام أمام المشاركين في الموضوع (يمكنهم القراءة ولكن لا يمكنهم الكتابة) وإخفائها من قائمة الدردشة العامة في Telegram للمستخدمين الجدد.
مثال كود للنسخ
/إخفاء دردشة الموضوع العام/
answer = tg_hide_general_forum_topic(-1001839380031)
كيفية عرض الموضوع العام أو استعادة رؤيته
الوصف
tg_unhide_general_forum_topic(platform_id)
المعلمات:
| المعلمة | الوصف |
|---|---|
| **!** platform_id | معرف الموضوع داخل Telegram * |
| bot_name |
معلمة اختيارية: اسم البوت. عند العمل مع المواضيع، يمكنك تحديد البوت الذي يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات Telegram. ابحث عن اسم البوت في قسم "القنوات"، في حقل "معرف المجموعة". |
مهم!
هذه الدالة لا تعيد فتح الموضوع العام؛ بل تجعله مرئيًا فقط.
مثال كود للنسخ
/عرض دردشة الموضوع العام/
answer = tg_unhide_general_forum_topic(-1001839380031)
كيفية إنشاء موضوع جديد في Telegram
الوصف
tg_create_forum_topic(platform_id, name, icon, icon_color)
المعلمات:
| المعلمة | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram * |
| **!** name | اسم الموضوع الجديد |
| icon | معرف الرمز التعبيري الذي سيتم تعيينه للموضوع. يتم تمريره كسلسلة نصية. يمكنك فقط استخدام الرموز التعبيرية من القائمة التي تم استردادها بواسطة الدالة tg_get_forum_icon. |
| icon_color | لون الرمز التعبيري من القائمة: 7322096, 16766590, 13338331, 9367192, 16749490, 16478047. لا تدعم جميع الرموز التعبيرية تغيير اللون. |
| bot_name |
معلمة اختيارية: اسم البوت. عند العمل مع المواضيع، يمكنك تحديد البوت الذي يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات Telegram. ابحث عن اسم البوت في قسم "القنوات"، في حقل "معرف المجموعة". |
لا يمكن تغيير اللون المحدد؛ يمكن تعيين اللون فقط عند إنشاء الموضوع.
عند التنفيذ، ستعيد الدالة استجابة تحتوي على معلمات الموضوع الجديد، بما في ذلك معرف الموضوع (مطلوب لوظائف مختلفة).
مثال كود للنسخ
لإنشاء دردشة موضوع إضافية
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']
كيفية تحرير موضوع. كيفية إعادة تسمية و/أو تغيير الرمز التعبيري لموضوع
الوصف
tg_edit_forum_topic(platform_id, message_thread_id, name, icon)
المعلمات:
| المعلمة | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram * |
| **!** message_thread_id | معرف دردشة الموضوع الإضافية |
| name | اسم الموضوع الجديد |
| icon | معرف الرمز التعبيري الذي سيتم تعيينه للموضوع. يتم تمريره كسلسلة نصية. يمكنك فقط استخدام الرموز التعبيرية من القائمة التي تم استردادها بواسطة الدالة tg_get_forum_icon. |
| bot_name |
معلمة اختيارية: اسم البوت. عند العمل مع المواضيع، يمكنك تحديد البوت الذي يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات Telegram. ابحث عن اسم البوت في قسم "القنوات"، في حقل "معرف المجموعة". |
مثال كود للنسخ
answer = tg_edit_forum_topic(-1001839380031, 254)
كيفية إغلاق موضوع محدد
الوصف
إغلاق موضوع يعني جعله للقراءة فقط؛ الكتابة في موضوع مغلق غير مسموح بها.
tg_close_forum_topic(platform_id, message_thread_id)
المعلمات:
| المعلمة | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram * |
| **!** message_thread_id | معرف دردشة الموضوع الإضافية |
| bot_name |
معلمة اختيارية: اسم البوت. عند العمل مع المواضيع، يمكنك تحديد البوت الذي يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات Telegram. ابحث عن اسم البوت في قسم "القنوات"، في حقل "معرف المجموعة". |
مثال كود للنسخ
answer = tg_close_forum_topic(-1001839380031, 254)
كيفية إعادة فتح موضوع مغلق سابقًا
الوصف
tg_reopen_forum_topic(platform_id, message_thread_id)
المعلمات:
| المعلمة | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram * |
| **!** message_thread_id | معرف دردشة الموضوع الإضافية |
| bot_name |
معلمة اختيارية: اسم البوت. عند العمل مع المواضيع، يمكنك تحديد البوت الذي يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات Telegram. ابحث عن اسم البوت في قسم "القنوات"، في حقل "معرف المجموعة". |
مثال كود للنسخ
answer = tg_reopen_forum_topic(-1001839380031, 254)
كيفية حذف موضوع وجميع رسائله
الوصف
tg_delete_forum_topic(platform_id, message_thread_id)
المعلمات:
| المعلمة | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram * |
| **!** message_thread_id | معرف دردشة الموضوع الإضافية |
| bot_name |
معلمة اختيارية: اسم البوت. عند العمل مع المواضيع، يمكنك تحديد البوت الذي يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات Telegram. ابحث عن اسم البوت في قسم "القنوات"، في حقل "معرف المجموعة". |
مثال كود للنسخ
answer = tg_delete_forum_topic(-1001839380031, 254)
كيفية إلغاء تثبيت جميع الرسائل في موضوع
الوصف
tg_unpin_topic_messages(platform_id, message_thread_id)
المعلمات:
| المعلمة | الوصف |
|---|---|
| **!** platform_id | معرف الدردشة داخل Telegram * |
| **!** message_thread_id | معرف دردشة الموضوع الإضافية |
| bot_name |
معلمة اختيارية: اسم البوت. عند العمل مع المواضيع، يمكنك تحديد البوت الذي يجب أن ينفذ الدالة. هذا مفيد إذا كان مشروعك يستخدم عدة بوتات Telegram. ابحث عن اسم البوت في قسم "القنوات"، في حقل "معرف المجموعة". |
مثال كود للنسخ
answer = tg_unpin_topic_messages(-1001839380031, 254)
كيفية الحصول على قائمة الرموز التعبيرية لموضوع Telegram
الوصف
كيفية الحصول على قائمة الرموز التعبيرية
tg_get_forum_icon() – هذه الدالة تُرجع قائمة بالرموز التعبيرية المتاحة للاستخدام كأيقونات لموضوع المنتدى. يجب تعيين النتيجة إلى متغير، حيث أنها تُرجع قاموسًا حيث كل مفتاح هو رمز تعبيري وقيمته المقابلة هي المعرف الفريد (id) للرمز التعبيري.
المعلمات: لا شيء.
محتوى قائمة الرموز التعبيرية
للحصول على قائمة الرموز التعبيرية لمحادثة موضوع، أرسل الأمر إلى المحادثة المعنية.
ستُرجع الدالة قائمة الرموز التعبيرية في ردها. هذا يعني أن المتغير 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'}
مثال على الكود للنسخ
answer = tg_get_forum_icon()