Как работать с описанием бота Telegram (полное,краткое)
Установка приветственного сообщения
tg_set_bot_description(description, language_code) - описание бота, показываемое когда чат с ботом пуст
Параметры:
Пример установки приветсвенного сообщения и меню бота:
После запуска (проводите это единожды по команде администратора):
Пример кода для копирования:
tg_set_bot_description('Добро пожаловать! Я ваш виртуальный помощник Юрграм.🤖') 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", "return count of user"],["unpin", "unpin all message"]] tg_set_command(command, '', 'all_chat_administrators')
В этом примере команды вынесены в отдельную переменную. Также можно добавить эти команды прямо в функцию:
tg_set_command('[["count", "return count of user"],["unpin", "unpin all message"]]', '', 'all_chat_administrators')
Для дальнейшего вызова команд в поле ввода сообщения введите символ '/'. Если все было сделано верно, то увидите подсказку в виде списка команд. Жирным шрифтом выделены команды, правее их описание.
Для использования команд настройте реакцию на сообщения содержащие команды.
Как просмотреть команды для бота
Для просмотра команд
tg_get_command(language, scope, platform_id, user_id)
Если Вы не хотите использовать параметр language, но при этом используете параметр scope, то не забудьте указать в начале пустой параметр, как в примере:
tg_get_command('', scope)
command = tg_get_command('', 'all_chat_administrators')
Переменной присваиваем в качестве значения эту функцию и внутри переменной после выполнения будет ответ сервера с командами для заданного в параметре scope круга пользователей.
{"ok":true,"result":[{"command":"count","description":"return count of user"},{"command":"unpin","description":"unpin all message"}]}
Если вызвать функцию без параметров, то scope по умолчанию примет значение 'default'.
command = tg_get_command()
Как удалить команды в боте
Для удаления команд
tg_delete_command(language, scope, platform_id, user_id), где
Если Вы не хотите использовать параметр language, но при этом используете параметр scope, то не забудьте указать в начале пустой параметр, как в примере: tg_delete_command('', scope)
Команда вида tg_delete_command() удалит команды без указания параметра language из параметра scope по умолчанию.
Удалить установленные команды можно, прописав функцию с параметрами в калькуляторе:
Пример кода для копирования:
tg_delete_command('', 'all_chat_administrators')
Как настроить реакцию на команды
Для команд в переписке с ботом реагировать нужно на сообщения вида:
&#xNAN;'/command_name' – в этом примере command_name – команда.
для команд в чатах при вводе команды будут приходить сообщения вида:
Для команд в группах и чатах реагировать нужно на сообщения вида:
'/command_name@bot_username' – в этом примере command_name – команда, а @bot_username – username бота.
Список значений scope:
Если Вы не хотите использовать параметр language, но при этом используете параметр scope, то не забудьте указать после команд пустой параметр, как в примере:
&#xNAN;tg_set_command(command, '', scope)