Краткое руководство по настройке TgDev2 ботов для эффективного удаления рекламы и спама.
0. Как правильно добавлять ботов в чат
Имя бота отображается в контактных данных и в других местах.
Имя пользователя бота — это логин бота и представляет из себя короткое имя, которое будет использоваться в упоминаниях и ссылках на t.me . Обратите внимание, что в дальнейшем имя пользователя изменить нельзя! Имена пользователей (логины) состоят из 5–32 символов и нечувствительны к регистру, и могут включать только латинские символы, числа и символы подчеркивания. Имя пользователя бота должно заканчиваться на bot , например tetris_bot или TetrisBot .
Токен представляет собой строку типа 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw , которая требуется для авторизации бота и отправки запросов в API бота. Держите свой токен в безопасности и храните его, он может быть использован кем угодно для управления вашим ботом.
Пересоздание токена авторизации Telegram бота.
Если существующий токен скомпрометирован или был утерян по какой-либо причине, то используйте команду /token для создания нового.
Как получить прямую ссылку на запуск бота Telegram | BotHelp
- /mybots — возвращает список ваших ботов с удобными элементами управления для редактирования их настроек.
- /mygames — делает то же самое для ваших игр
Команды редактирования Telegram бота:
- /setname — изменить имя вашего бота.
- /setdescription — изменить описание бота, текст до 512 символов, описывающий бота. Пользователи увидят этот текст в начале разговора с ботом, озаглавленный «What can this bot do?».
- /setabouttext — изменить информацию о боте, более короткий текст до 120 символов. Пользователи увидят этот текст на странице профиля бота. Когда они делятся вашим ботом с кем-то, этот текст отправляется вместе со ссылкой.
- /setuserpic — изменить фото профиля бота.
- /setcommands — изменить список команд, поддерживаемых ботом. Пользователи будут видеть список команд всякий раз, когда они набирают ‘/’ в разговоре с вашим ботом. Каждая команда имеет имя (должно начинаться с косой черты ‘/’ , буквенно-цифровое значение плюс подчеркивание, не более 32 символов, без учета регистра), параметры и текстовое описание.
- /deletebot — команда удаляет бота и освобождает его логин.
Команды изменения настроек Telegram бота.
- /setinline — переключает встроенный режим запросов для бота.
- /setinlinegeo — запрашивает данные о местоположении для предоставления встроенных результатов на основе местоположения.
- /setjoingroups — переключатель, который отвечает за то, можно ли добавлять бота в группы или нет. Любой бот должен уметь обрабатывать личные сообщения, но если создаваемый бот не предназначен для работы в группах, то можно отключить этот режим.
- /setprivacy — установить, какие сообщения будет получать бот при добавлении в группу. Если режим конфиденциальности отключен, то бот будет получать все сообщения. Мы рекомендуем оставить режим конфиденциальности включенным. Вам нужно будет повторно добавить бота в существующие группы, чтобы это изменение вступило в силу.
Команды управления играми.
- /newgame — создать новую игру.
- /listgames — получить список ваших игр.
- /editgame — редактировать игру.
- /deletegame — удалить существующую игру.
Обратите внимание, что изменения вступят в силу не сразу, а через несколько минут.
Ограничения и предупреждения о статусе Telegram бота.
Ответы на предупреждения.
По умолчанию вы будете получать только одно предупреждение на одного бота в час. Каждое предупреждение имеет следующие кнопки:
Отслеживаемые проблемы Telegram бота.
В настоящее время Telegram будет уведомлять о следующих проблемах:
- Too few private messages are sent compared to previous weeks: . Бот отправляет гораздо меньше сообщений, чем в предыдущие недели. Такие уведомления полезны для ботов в стиле новостной рассылки, которые рассылают сообщения без возможности получения ответов от пользователей. Чем больше значение, тем значительнее разница.
- Too few replies to incoming private messages. Conversion rate: . Бот не отвечает на все сообщения, которые ему отправляются (коэффициент конверсии запроса/ответа для бота был слишком низким по крайней мере в течение двух из последних трех 5-минутных периодов). Чтобы обеспечить хороший пользовательский опыт, пожалуйста, отвечайте на все сообщения, которые отправляются вашему боту.
- Too few answers to inline queries. Conversion rate: . Бот не отвечает на все встроенные запросы, которые ему посылаются, рассчитанные таким же образом, как и выше. Отвечайте на обновления inline_query , вызывая answerInlineQuery .
- Too few answers to callback queries. Conversion rate: или Too few answers to callback game queries. Conversion rate: . Бот не отвечает на все запросы обратного вызова, которые ему посылаются (с играми или без них), рассчитанные таким же образом, как и выше. Отвечайте на сообщения callback_query , вызывая answerCallbackQuery .
Обратите внимание, что функция оповещения о состоянии все еще тестируется и будет улучшена в будущем.
Источник: docs-python.ru
Как запустить бота с меню команд в Telegram
3 простых шага, как запустить чат-бота с командами в Telegram.
19.6.2023 13:30
Шаг первый: создайте сценарий бота
Предположим, что вы уже знаете, какой алгоритм будет у вашего бота. Обычно мы в команде SmartbotPro рекомендуем нашим пользователям сначала нарисовать логику в виде блок-схемы прямо «на бумажке» (конечно, лучше делать это в онлайн-редакторах типа Miro). После этого вам нужно переложить нарисованную логику на блоки Smartbot. Для этого зарегистрируйтесь в сервисе и создайте свой первый сценарий. Ну а если вы еще не придумали логику до конца, то воспользуйтесь нашими готовыми шаблонами для разного бизнеса.
Немного о конструкторе алгоритма: в нем есть события и действия.
События – внешние воздействия, которые могут запускать сценарий вашего бота. Например, событием может быть новое сообщение от пользователя, комментарий или даже вызов Webhook
Действия – шаги, которые бот выполняет в ответ на события. Например, отправить сообщение, сохранить пользователя в список рассылки, отправить контакты в AmoCRM.
Соединяя действия в цепочку с помощью стрелочек, вы создаете логику бота. Каждая такая цепочка должна начинаться с события.
Шаг второй: подключите чат-бота
Создайте бота в Botfather, следуя инструкциям:
- Выберите имя для бота
- Выберите ссылку. Она должна заканчиваться на «bot».
- После этого вы сможете настроить другие атрибуты бота (например, приветственную картинку), выбрав в Botfather своего нового бота.
После регистрации вы получите токен бота, скопируйте его.
Нажмите кнопку «каналы», выберите Telegram и вставьте скопированный токен.
Все, после этого вы уже можете протестировать своего нового бота.
Шаг третий: добавляем команды
По сути команды, это глобальные события с сообщениями пользователей. Например /order или /about и тд. Когда пользователь вводит такие команды или выбирает их из меню, бот должен среагировать, независимо от того, в каком месте сценария он сейчас находится.
В первом шаге мы уже рассматривали события в Smartbot. Теперь нам нужно создать такие же события, только под каждую команду и сделать их глобальными.
Для примера создадим команду /menu, которая будет вести в начало нашего сценария. Просто добавьте блок «сообщение от пользователя» из раздела событий в левом меню и выберите в условии «равно» тексту «/menu».
Чуть ниже в «дополнительных настройках» будет галочка «глобальное событие», включите ее. Протяните стрелочку от нового события к блоку с отправкой сообщения:
Сохраните и опубликуйте бота. Теперь он будет реагировать на команду /menu в любом месте диалога с пользователем. Но как добавить эту команду в левое меню кнопочкой?
Хорошая новость: очень просто!
Нажмите на кнопку «каналы» в левом меню сценариев и выберите вашего подключенного телеграм-бота. Откроется окошко с редактированием команд. Просто введите текст своей команды (/menu) в поле ввода. Сервис автоматически сохранит эту команду и добавит в бота.
Проверьте, теперь в вашем боте появилась команда в меню быстрого доступа!
Источник: smartbotpro.ru