Telegram ботының сипаттамасымен жұмыс істеу (толық және қысқа)
Қош келдіңіз хабарламасын конфигурациялау
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)
Егер сіз тіл параметрін пайдаланғыңыз келмесе, бірақ 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), мұндағы
Егер сіз тіл параметрін пайдаланғыңыз келмесе, бірақ 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 - боттың пайдаланушы аты.
Ауқым мәндерінің тізімі:
Егер сіз тіл параметрін пайдаланғыңыз келмесе, бірақ scope параметрін пайдалану қажет болса, бірінші параметр үшін бос мәнді көрсетуді ұмытпаңыз, мысалдағыдай:
tg_delete_command('', scope)