العمل مع معرفات المنصة في 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

الوصف

ينشئ رابط دعوة جديدًا لدردشة 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

الوصف

يلغي رابط دعوة موجود لدردشة Telegram.

المعاملات

المعامل الوصف
platform_id معرف دردشة Telegram.
invite_link رابط الدعوة المراد إلغاؤه.
المعامل الوصف
**!** platform_id معرف الدردشة داخل Telegram *
**!** invite_link الرابط الذي تحتاج إلى حذفه

كيفية تعطيل جميع الروابط الموجودة واستبدالها برابط واحد

الوصف

ينشئ رابط دعوة رئيسي جديد لدردشة 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 :

  1. is_anonymous — يخفي وجود المشرف في الدردشة،
  2. can_manage_chat — يمكن للمشرف الوصول إلى سجل أحداث الدردشة، وإحصائيات الدردشة، وإحصائيات الرسائل في القنوات، وعرض أعضاء القناة، وعرض المشرفين المجهولين في المجموعات الفائقة، وتجاوز الوضع البطيء. يتم منح هذا المستوى من الصلاحية افتراضيًا إذا تم تحديد أي من الامتيازات اللاحقة
  3. can_post_messages — يمكن للمشرف إنشاء منشورات القناة (للقنوات فقط)
  4. can_edit_messages — يمكن للمشرف تعديل رسائل المستخدمين الآخرين وتثبيت الرسائل (للقنوات فقط)
  5. can_delete_messages — يمكن للمشرف حذف رسائل المستخدمين الآخرين
  6. can_manage_video_chats — يمكن للمشرف إدارة محادثات الفيديو،
  7. can_restrict_members — يمكن للمشرف تقييد الأعضاء، وحظر/إلغاء حظرهم في الدردشة،
  8. can_promote_members — يمكن للمشرف تعيين مشرفين جدد بمجموعة فرعية من صلاحياته الخاصة، أو خفض رتبة المشرفين الذين عينهم بشكل مباشر أو غير مباشر (على سبيل المثال، المشرفون الذين عينهم)
  9. can_change_info — يمكن للمشرف تغيير عنوان الدردشة، والصورة، والإعدادات الأخرى
  10. can_invite_users — يمكن للمشرف دعوة مستخدمين جدد إلى الدردشة
  11. 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:\

  1. ! can_send_messages - الإذن بإرسال الرسائل النصية، جهات الاتصال، المواقع، والأماكن.\
  2. ! can_send_media_messages - الإذن بإرسال الصوت، المستندات، الصور، الفيديو، ملاحظات الفيديو، وملاحظات الصوت. يتطلب can_send_messages\
  3. ! can_send_polls - الإذن بإرسال الاستطلاعات. يتطلب can_send_messages\
  4. ! can_send_other_messages - الإذن بإرسال الرسوم المتحركة، الألعاب، الملصقات، واستخدام البوتات المضمنة. يتطلب can_send_media_messages\
  5. ! can_add_web_page_previews - الإذن بإضافة معاينات صفحات الويب إلى الرسائل. يتطلب can_send_media_messages\
  6. ! can_change_info - الإذن بتغيير عنوان الدردشة، الصورة، والإعدادات الأخرى. يتم تجاهله في المجموعات الفائقة العامة.\
  7. ! can_invite_users - الإذن بدعوة المستخدمين\
  8. ! can_pin_messages - الإذن بتثبيت الرسائل. يتم تجاهله في المجموعات الفائقة العامة.\
  9. can_manage_topics - الإذن بإنشاء مواضيع في مجموعات المنتدى. إذا تم استخدامه في مجموعة من النوع الخاطئ، ستفشل الوظيفة وترجع خطأ.
قائمة القيم للمعامل المطلوب **media_permissions**

قيم منح الصلاحيات المتعلقة بالوسائط media_permissions:

  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 - الإذن بإرسال الرسائل الصوتية

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

الوصف

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:\

  1. ! can_send_messages - الإذن بإرسال الرسائل النصية، جهات الاتصال، المواقع، والأماكن.\
  2. ! can_send_media_messages - الإذن بإرسال الصوت، المستندات، الصور، الفيديو، ملاحظات الفيديو، وملاحظات الصوت. يتطلب can_send_messages\
  3. ! can_send_polls - الإذن بإرسال الاستطلاعات. يتطلب can_send_messages\
  4. ! can_send_other_messages - الإذن بإرسال الرسوم المتحركة، الألعاب، الملصقات، واستخدام البوتات المضمنة. يتطلب can_send_media_messages\
  5. ! can_add_web_page_previews - الإذن بإضافة معاينات صفحات الويب إلى الرسائل. يتطلب can_send_media_messages\
  6. ! can_change_info - الإذن بتغيير عنوان الدردشة، الصورة، والإعدادات الأخرى. يتم تجاهله في المجموعات الفائقة العامة.\
  7. ! can_invite_users - الإذن بدعوة المستخدمين\
  8. ! can_pin_messages - الإذن بتثبيت الرسائل. يتم تجاهله في المجموعات الفائقة العامة.\
  9. can_manage_topics - الإذن بإنشاء مواضيع في مجموعات المنتدى. إذا تم استخدامه في مجموعة من النوع الخاطئ، ستفشل الوظيفة وترجع خطأ.
قائمة القيم للمعامل المطلوب **media_permissions**

قيم منح الصلاحيات المتعلقة بالوسائط media_permissions:

  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 - الإذن بإرسال الرسائل الصوتية
مثال

مثال على استخدام الوظيفة، حيث يتم تقييد المستخدم من كل شيء لمدة 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 القيمة عند توصيل بوت (معرف الأعمال). يظهر في القنوات. يجب توفيره إذا تم استخدام رمز البوت ويجب إرسال الرسالة عبر حساب مستخدم متصل بالبوت
من المهم معرفته!

ملاحظات

  1. ترجع الدالة ردًا من تيليجرام يحتوي على message_id. من الأفضل حفظه. باستخدام message_id، يمكنك إيقاف الاستطلاع باستخدام tg_stop_poll (انظر الوصف أدناه) والحصول على النتيجة.

  2. إذا أضاف مستخدم استطلاعًا في مراسل، يتم إرسال رد اتصال إلى المحادثة:

poll_added - جزء ثابت
YOUR QUESTION - نص السؤال من الاستطلاع

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

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

رد الاتصال الثاني بعد poll_added يحتوي على أرقام - هذا ليس سوى معرف المستخدم في تيليجرام الذي أضاف الاستطلاع.

عند إنشاء استطلاع بواسطة البوت، لا يصل رد اتصال.

3. في القناة، يمكنك فقط إنشاء استطلاعات مجهولة

انتباه، يُوصى بإرسال استطلاعات مجهولة فقط إلى المجموعة!

  1. بعد إنشاء الاستطلاع، احفظ معرفه في متغير لفهم أي استطلاع وصل إليه رد الاتصال.
مثال

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

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

/* 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()