كيفية العمل مع وصف بوت تيليجرام (كامل وقصير)

لتكوين رسالة الترحيب

tg_set_bot_description(description, language_code) - وصف البوت الذي يظهر عندما تكون الدردشة مع البوت فارغة

المعلمات:

مثال لتكوين رسالة ترحيب وقائمة البوت:

بعد التشغيل (يجب القيام بذلك مرة واحدة باستخدام أمر المسؤول):

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

tg_set_bot_description('مرحبًا! أنا مساعدك الافتراضي، Yurgram.🤖') command = [["private_office", "الحساب الشخصي"]] tg_set_command(command, '', 'default')

لتكوين وصف المعاينة القصير

tg_set_bot_short_description(description, language_code) - وصف قصير للبوت يظهر على صفحة ملف البوت ويتم إرساله مع الرابط عندما يشارك المستخدمون البوت.

المعلمات:

للحصول على الوصف الحالي

tg_get_bot_description(language_code) - استخدم هذه الطريقة للحصول على وصف البوت الحالي للغة المستخدم المحددة.

للحصول على الوصف القصير الحالي

tg_get_bot_short_description(language_code) - استخدم هذه الطريقة للحصول على الوصف القصير الحالي للبوت للغة المستخدم المحددة.

كيفية تكوين الأوامر للبوت

لتكوين الأوامر

tg_set_command(commands, language, scope, platform_id, user_id)

command = [["count", "إرجاع عدد المستخدمين"],["unpin", "إلغاء تثبيت جميع الرسائل"]] tg_set_command(command, '', 'all_chat_administrators')

في هذا المثال، يتم وضع الأوامر في متغير منفصل. يمكنك أيضًا إضافة هذه الأوامر مباشرة إلى الدالة.

tg_set_command('[["count", "إرجاع عدد المستخدمين"],["unpin", "إلغاء تثبيت جميع الرسائل"]]', '', 'all_chat_administrators')

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

لاستخدام الأوامر، قم بتكوين رد فعل على الرسائل التي تحتوي على أوامر.

كيفية عرض الأوامر للبوت

tg_get_command()

لعرض الأوامر

tg_get_command(language, scope, platform_id, user_id)

إذا كنت لا ترغب في استخدام معلمة اللغة ولكنك بحاجة إلى استخدام معلمة النطاق، فتأكد من تحديد معلمة فارغة أولاً، كما في المثال:

tg_get_command('', scope)

command = tg_get_command('', 'all_chat_administrators')

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

{"ok":true,"result":[{"command":"count","description":"إرجاع عدد المستخدمين"},{"command":"unpin","description":"إلغاء تثبيت جميع الرسائل"}]}

إذا تم استدعاء الدالة بدون معلمات، فسيتم تعيين النطاق على 'default'.

command = tg_get_command()

كيفية حذف الأوامر في البوت

tg_delete_command()

لحذف الأوامر

tg_delete_command(language, scope, platform_id, user_id), حيث

إذا كنت لا ترغب في استخدام معلمة اللغة ولكنك بحاجة إلى استخدام معلمة النطاق، فتأكد من تحديد قيمة فارغة للمعلمة الأولى، كما في المثال:

tg_delete_command('', scope)

أمر مثل tg_delete_command() سيحذف الأوامر دون تحديد معلمة اللغة، باستخدام قيمة النطاق الافتراضية.

يمكنك حذف الأوامر المحددة عن طريق استدعاء الدالة مع المعلمات في الآلة الحاسبة:

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

tg_delete_command('', 'all_chat_administrators')

كيفية تكوين ردود الفعل على الأوامر

بالنسبة للأوامر في الدردشة الخاصة مع البوت، تحتاج إلى الرد على رسائل مثل: '/command_name' – حيث command_name هو الأمر.

بالنسبة للأوامر في المجموعات والدردشات، ستظهر الرسائل على النحو التالي: '/command_name@bot_username' – حيث command_name هو الأمر و @bot_username هو اسم مستخدم البوت.

قائمة قيم النطاق:

إذا كنت لا ترغب في استخدام معلمة اللغة ولكنك بحاجة إلى استخدام معلمة النطاق، فتأكد من تحديد قيمة فارغة للمعلمة الأولى، كما في المثال:

tg_delete_command('', scope)