Cara bekerja dengan penerangan bot Telegram (penuh dan pendek)
Untuk mengkonfigurasi mesej alu-aluan
tg_set_bot_description(description, language_code) - penerangan bot yang dipaparkan apabila sembang dengan bot kosong
Parameter:
Contoh mengkonfigurasi mesej alu-aluan dan menu bot:
Selepas pelancaran (ini perlu dilakukan sekali menggunakan arahan pentadbir):
Contoh kod untuk disalin:
tg_set_bot_description('Selamat datang! Saya pembantu maya anda, Yurgram.🤖') command = [["private_office", "Akaun Peribadi"]] tg_set_command(command, '', 'default')
Untuk mengkonfigurasi penerangan pratonton pendek
tg_set_bot_short_description(description, language_code) - penerangan ringkas bot yang muncul pada halaman profil bot dan dihantar bersama pautan apabila pengguna berkongsi bot.
Parameter:
Untuk mendapatkan penerangan semasa
tg_get_bot_description(language_code) - gunakan kaedah ini untuk mendapatkan penerangan bot semasa untuk bahasa pengguna yang ditentukan.
Untuk mendapatkan penerangan pendek semasa
tg_get_bot_short_description(language_code) - gunakan kaedah ini untuk mendapatkan penerangan pendek semasa bot untuk bahasa pengguna yang ditentukan.
Cara mengkonfigurasi arahan untuk bot
Untuk mengkonfigurasi arahan
tg_set_command(commands, language, scope, platform_id, user_id)
command = [["count", "return count of user"],["unpin", "unpin all message"]] tg_set_command(command, '', 'all_chat_administrators')
Dalam contoh ini, arahan diletakkan dalam pembolehubah yang berasingan. Anda juga boleh menambah arahan ini terus ke dalam fungsi.
tg_set_command('[["count", "return count of user"],["unpin", "unpin all message"]]', '', 'all_chat_administrators')
Untuk memanggil arahan, taip simbol '/' dalam medan input mesej. Jika semuanya dikonfigurasi dengan betul, anda akan melihat senarai cadangan arahan yang tersedia. Arahan akan muncul dalam huruf tebal, dengan penerangannya ditunjukkan di sebelah kanan.
Untuk menggunakan arahan, konfigurasikan reaksi terhadap mesej yang mengandungi arahan.
Cara melihat arahan untuk bot
tg_get_command()
Untuk melihat arahan
tg_get_command(language, scope, platform_id, user_id)
Jika anda tidak mahu menggunakan parameter bahasa tetapi perlu menggunakan parameter skop, pastikan anda menentukan parameter kosong terlebih dahulu, seperti dalam contoh:
tg_get_command('', scope)
command = tg_get_command('', 'all_chat_administrators')
Tetapkan fungsi ini kepada pembolehubah, dan pembolehubah akan mengandungi respons pelayan dengan arahan untuk skop pengguna yang dinyatakan dalam parameter.
{"ok":true,"result":[{"command":"count","description":"return count of user"},{"command":"unpin","description":"unpin all message"}]}
Jika fungsi dipanggil tanpa parameter, skop akan ditetapkan kepada 'default'.
command = tg_get_command()
Cara memadam arahan dalam bot
tg_delete_command()
Untuk memadam arahan
tg_delete_command(language, scope, platform_id, user_id), di mana
Jika anda tidak mahu menggunakan parameter bahasa tetapi perlu menggunakan parameter skop, pastikan anda menentukan nilai kosong untuk parameter pertama, seperti dalam contoh:
tg_delete_command('', scope)
Arahan seperti tg_delete_command() akan memadam arahan tanpa menentukan parameter bahasa, menggunakan nilai skop lalai.
Anda boleh memadam arahan yang ditetapkan dengan memanggil fungsi dengan parameter dalam kalkulator:
Contoh kod untuk disalin:
tg_delete_command('', 'all_chat_administrators')
Cara mengkonfigurasi reaksi terhadap arahan
Untuk arahan dalam sembang peribadi dengan bot, anda perlu bertindak balas terhadap mesej seperti: '/command_name' – di mana command_name ialah arahan.
Untuk arahan dalam kumpulan dan sembang, mesej akan muncul sebagai: '/command_name@bot_username' – di mana command_name ialah arahan dan @bot_username ialah nama pengguna bot.
Senarai nilai skop:
Jika anda tidak mahu menggunakan parameter bahasa tetapi perlu menggunakan parameter skop, pastikan anda menentukan nilai kosong untuk parameter pertama, seperti dalam contoh:
tg_delete_command('', scope)