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:
| Parameter | Penerangan |
|---|---|
| description | Menghantar rentetan kosong sebagai penerangan bot akan mengalih keluar penerangan sedia ada. |
| language_code |
Kod bahasa dua huruf mengikut piawaian ISO 639-1 untuk penyetempatan teks. Jika dibiarkan kosong, penerangan pendek akan digunakan untuk semua pengguna yang tidak mempunyai penerangan pendek khusus yang ditetapkan. |
Contoh
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:
| Parameter | Penerangan |
|---|---|
| description | Menghantar rentetan kosong sebagai penerangan bot akan mengalih keluar penerangan sedia ada. |
| language_code |
Kod bahasa dua huruf mengikut piawaian ISO 639-1 untuk penyetempatan teks. Jika dibiarkan kosong, penerangan pendek akan digunakan untuk semua pengguna yang tidak mempunyai penerangan pendek khusus yang ditetapkan. |
Untuk mendapatkan penerangan semasa
tg_get_bot_description(language_code) - gunakan kaedah ini untuk mendapatkan penerangan bot semasa untuk bahasa pengguna yang ditentukan.
| Parameter | Penerangan |
|---|---|
| language_code |
Kod bahasa dua huruf mengikut piawaian ISO 639-1 untuk penyetempatan teks. Jika dibiarkan kosong, penerangan pendek akan digunakan untuk semua pengguna yang tidak mempunyai penerangan pendek khusus yang ditetapkan. |
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.
| Parameter | Penerangan |
|---|---|
| language_code |
Kod bahasa dua huruf mengikut piawaian ISO 639-1 untuk penyetempatan teks. Jika dibiarkan kosong, penerangan pendek akan digunakan untuk semua pengguna yang tidak mempunyai penerangan pendek khusus yang ditetapkan. |
Cara mengkonfigurasi arahan untuk bot
Untuk mengkonfigurasi arahan
tg_set_command(commands, language, scope, platform_id, user_id)
| Parameter | Penerangan |
|---|---|
| **!** commands |
Arahan bot dalam bentuk senarai senarai, setiap senarai bersarang terdiri daripada 2 elemen:
1 – nama arahan, 2 – penerangannya (terdapat had 100 arahan). |
| language |
Kod bahasa dua huruf mengikut ISO 639-1, cth., 'ru' atau 'en'. Jika tidak dinyatakan, arahan akan digunakan untuk semua pengguna yang bahasanya tidak mempunyai arahan yang ditetapkan secara khusus. |
| scope | Parameter yang mentakrifkan skop pengguna yang arahan dibuat untuknya. Nilai lalai ialah 'default'. |
| platform_id |
Pengecam sembang dalam Telegram *. Hanya terpakai untuk nilai khusus parameter scope. |
| user_id |
Pengecam pengguna dalam Telegram *. Hanya terpakai untuk nilai khusus parameter scope. |
Contoh
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)
| Parameter | Penerangan |
|---|---|
| language | Kod bahasa dua huruf mengikut ISO 639-1, cth., 'ru' atau 'en'.
Jika tidak dinyatakan, arahan yang digunakan untuk semua pengguna dalam kawasan yang diberikan yang tidak mempunyai arahan khusus untuk bahasa mereka akan dipaparkan. |
| scope | Parameter yang mentakrifkan skop pengguna yang arahan harus dipaparkan (parameter pilihan; jika tidak digunakan, nilai lalai 'default' akan digunakan). |
| platform_id |
Pengecam sembang dalam Telegram *. Hanya terpakai untuk nilai khusus parameter scope. |
| user_id |
Pengecam pengguna dalam Telegram *. Hanya terpakai untuk nilai khusus parameter scope. |
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)
Contoh
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
| Parameter | Penerangan |
|---|---|
| language | Kod bahasa dua huruf mengikut ISO 639-1, cth., 'ru' atau 'en' (parameter pilihan; jika tidak dinyatakan, arahan yang digunakan untuk semua pengguna dalam skop yang diberikan yang tidak mempunyai arahan khusus untuk bahasa mereka akan dipadamkan). |
| scope | Parameter yang mentakrifkan skop pengguna yang arahan akan dipadamkan.
Jika tidak dinyatakan, nilai lalai 'default' akan digunakan. |
| platform_id | Pengecam sembang (parameter pilihan, hanya terpakai untuk nilai khusus parameter skop). |
| user_id | Pengecam pengguna (parameter pilihan, hanya terpakai untuk nilai khusus parameter 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)
Arahan seperti tg_delete_command() akan memadam arahan tanpa menentukan parameter bahasa, menggunakan nilai skop lalai.
Contoh
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:
| Parameter | Nilai |
|---|---|
| 'default' | Parameter lalai membayangkan bahawa arahan akan berfungsi dalam mesej peribadi dengan bot. |
| 'all_private_chats' | Semua sembang peribadi: arahan tersedia untuk semua orang dalam sembang peribadi di mana bot telah ditambahkan. |
| 'all_group_chats' | Semua sembang kumpulan dan superkumpulan: arahan tersedia untuk semua orang dalam jenis sembang ini di mana bot telah ditambahkan. |
| 'all_chat_administrators' | Arahan untuk pentadbir semua sembang kumpulan dan superkumpulan di mana bot telah ditambahkan. |
| 'chat' | Arahan untuk sembang tertentu (jika anda memilih pilihan ini, anda harus menentukan platform_id). |
| 'chat_administrators' | Arahan untuk pentadbir sembang tertentu (jika anda memilih pilihan ini, anda harus menentukan platform_id). |
| 'chat_member' | Arahan untuk ahli tertentu sembang tertentu (jika anda memilih pilihan ini, anda harus menentukan kedua-dua platform_id dan user_id; pengguna yang ditentukan mestilah ahli sembang yang diberikan). |
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)