Telegram ботының сипаттамасымен жұмыс істеу (толық және қысқа)

Қош келдіңіз хабарламасын конфигурациялау

tg_set_bot_description(description, language_code) - ботпен сөйлесу бос болғанда көрсетілетін бот сипаттамасы

Параметрлер:

Параметр Сипаттама
description Бот сипаттамасы ретінде бос жолды беру бар сипаттаманы жояды.
language_code

Мәтінді локализациялау үшін ISO 639-1 стандарты бойынша екі әріпті тіл коды.

Егер бос қалдырылса, қысқа сипаттама арнайы қысқа сипаттамасы жоқ барлық пайдаланушыларға қолданылады.
Мысал

Қош келдіңіз хабарламасын және бот мәзірін конфигурациялау мысалы:

Іске қосқаннан кейін (бұл әкімші пәрменін пайдаланып бір рет жасалуы керек):

Көшіруге арналған код мысалы:

tg_set_bot_description('Қош келдіңіз! Мен сіздің виртуалды көмекшіңіз, Yurgram.🤖') command = [["private_office", "Жеке кабинет"]] tg_set_command(command, '', 'default')

Қысқа алдын ала қарау сипаттамасын конфигурациялау

tg_set_bot_short_description(description, language_code) - боттың профиль бетінде пайда болатын және пайдаланушылар ботты бөліскенде сілтемемен бірге жіберілетін қысқа сипаттамасы.

Параметрлер:

Параметр Сипаттама
description Бот сипаттамасы ретінде бос жолды беру бар сипаттаманы жояды.
language_code

Мәтінді локализациялау үшін ISO 639-1 стандарты бойынша екі әріпті тіл коды.

Егер бос қалдырылса, қысқа сипаттама арнайы қысқа сипаттамасы жоқ барлық пайдаланушыларға қолданылады.

Ағымдағы сипаттаманы алу

tg_get_bot_description(language_code) - көрсетілген пайдаланушы тілі үшін ағымдағы бот сипаттамасын алу үшін осы әдісті пайдаланыңыз.

Параметр Сипаттама
language_code

Мәтінді локализациялау үшін ISO 639-1 стандарты бойынша екі әріпті тіл коды.

Егер бос қалдырылса, қысқа сипаттама арнайы қысқа сипаттамасы жоқ барлық пайдаланушыларға қолданылады.

Ағымдағы қысқа сипаттаманы алу

tg_get_bot_short_description(language_code) - көрсетілген пайдаланушы тілі үшін боттың ағымдағы қысқа сипаттамасын алу үшін осы әдісті пайдаланыңыз.

Параметр Сипаттама
language_code

Мәтінді локализациялау үшін ISO 639-1 стандарты бойынша екі әріпті тіл коды.

Егер бос қалдырылса, қысқа сипаттама арнайы қысқа сипаттамасы жоқ барлық пайдаланушыларға қолданылады.

Бот үшін пәрмендерді конфигурациялау

Пәрмендерді конфигурациялау

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

Параметр Сипаттама
**!** commands

Тізімдер тізімі түріндегі бот пәрмендері, әрбір кірістірілген тізім 2 элементтен тұрады:

1 – пәрмен атауы, 2 – оның сипаттамасы (100 пәрмен шегі бар).
language

ISO 639-1 бойынша екі әріпті тіл коды, мысалы, 'ru' немесе 'en'.

Егер көрсетілмесе, пәрмендер тіліне арнайы пәрмендер тағайындалмаған барлық пайдаланушыларға қолданылады.
scope Пәрмендер жасалатын пайдаланушылар ауқымын анықтайтын параметр. Әдепкі мәні 'default'.
platform_id

Telegram ішіндегі чат идентификаторы *.

Тек scope параметрінің нақты мәндері үшін қолданылады.
user_id

Telegram ішіндегі пайдаланушы идентификаторы *.

Тек scope параметрінің нақты мәндері үшін қолданылады.
Мысал

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)

Параметр Сипаттама
language ISO 639-1 бойынша екі әріпті тіл коды, мысалы, 'ru' немесе 'en'.
Егер көрсетілмесе, берілген аймақтағы тіліне арнайы пәрмендері жоқ барлық пайдаланушыларға қолданылатын пәрмендер көрсетіледі.
scope Пәрмендер көрсетілуі тиіс пайдаланушылар ауқымын анықтайтын параметр (міндетті емес параметр; пайдаланылмаса, әдепкі мән 'default' қолданылады).
platform_id

Telegram ішіндегі чат идентификаторы *.

Тек scope параметрінің нақты мәндері үшін қолданылады.
user_id

Telegram ішіндегі пайдаланушы идентификаторы *.

Тек scope параметрінің нақты мәндері үшін қолданылады.

Егер сіз тіл параметрін пайдаланғыңыз келмесе, бірақ scope параметрін пайдалану қажет болса, алдымен бос параметрді көрсетуді ұмытпаңыз, мысалдағыдай:

tg_get_command('', scope)

Мысал

command = tg_get_command('', 'all_chat_administrators')

Бұл функцияны айнымалыға тағайындаңыз, сонда айнымалы параметрде көрсетілген пайдаланушы ауқымы үшін пәрмендері бар сервер жауабын қамтиды.

{"ok":true,"result":[{"command":"count","description":"пайдаланушы санын қайтару"},{"command":"unpin","description":"барлық хабарламаны бекітуден шығару"}]}

Егер функция параметрлерсіз шақырылса, scope 'default' мәніне орнатылады.

command = tg_get_command()

Боттағы пәрмендерді жою

tg_delete_command()

Пәрмендерді жою

tg_delete_command(language, scope, platform_id, user_id), мұндағы

Параметр Сипаттама
language ISO 639-1 бойынша екі әріпті тіл коды, мысалы, 'ru' немесе 'en' (міндетті емес параметр; егер көрсетілмесе, берілген ауқымдағы тіліне арнайы пәрмендері жоқ барлық пайдаланушыларға қолданылатын пәрмендер жойылады).
scope Пәрмендер жойылатын пайдаланушылар ауқымын анықтайтын параметр.
Егер көрсетілмесе, әдепкі мән 'default' қолданылады.
platform_id Чат идентификаторы (міндетті емес параметр, тек scope параметрінің нақты мәндері үшін қолданылады).
user_id Пайдаланушы идентификаторы (міндетті емес параметр, тек scope параметрінің нақты мәндері үшін қолданылады).

Егер сіз тіл параметрін пайдаланғыңыз келмесе, бірақ scope параметрін пайдалану қажет болса, бірінші параметр үшін бос мәнді көрсетуді ұмытпаңыз, мысалдағыдай:

tg_delete_command('', scope)

tg_delete_command() сияқты пәрмен тіл параметрін көрсетпей, әдепкі scope мәнін пайдаланып пәрмендерді жояды.

Мысал

Калькуляторда параметрлері бар функцияны шақыру арқылы орнатылған пәрмендерді жоюға болады:

Көшіруге арналған код мысалы:

tg_delete_command('', 'all_chat_administrators')

Пәрмендерге реакцияларды конфигурациялау

Ботпен жеке чаттағы пәрмендер үшін келесідей хабарламаларға реакция жасау керек: '/command_name' – мұндағы command_name - пәрмен.

Топтар мен чаттардағы пәрмендер үшін хабарламалар келесідей көрінеді: '/command_name@bot_username' – мұндағы command_name - пәрмен және @bot_username - боттың пайдаланушы аты.

Ауқым мәндерінің тізімі:

Параметр Мәні
'default' Әдепкі параметр пәрмендердің ботпен жеке хабарламаларда жұмыс істейтінін білдіреді.
'all_private_chats' Барлық жеке чаттар: пәрмендер бот қосылған жеке чаттардағы барлығына қолжетімді.
'all_group_chats' Барлық топтық және супертоптық чаттар: пәрмендер бот қосылған осы типтегі чаттардағы барлығына қолжетімді.
'all_chat_administrators' Бот қосылған барлық топтық және супертоптық чаттардың әкімшілеріне арналған пәрмендер.
'chat' Белгілі бір чатқа арналған пәрмендер (егер сіз осы опцияны таңдасаңыз, platform_id көрсетуіңіз керек).
'chat_administrators' Белгілі бір чаттың әкімшілеріне арналған пәрмендер (егер сіз осы опцияны таңдасаңыз, platform_id көрсетуіңіз керек).
'chat_member' Белгілі бір чаттың нақты мүшесіне арналған пәрмендер (егер сіз осы опцияны таңдасаңыз, platform_id және user_id көрсетуіңіз керек; көрсетілген пайдаланушы берілген чаттың мүшесі болуы керек).

Егер сіз тіл параметрін пайдаланғыңыз келмесе, бірақ scope параметрін пайдалану қажет болса, бірінші параметр үшін бос мәнді көрсетуді ұмытпаңыз, мысалдағыдай:

tg_delete_command('', scope)