создание ботов в телеграмме обучение
Инструкция: Как создавать ботов в Telegram
24 июня разработчики Telegram открыли платформу для создания ботов. Новость кого-то обошла стороной Хабр, однако многие уже начали разрабатывать викторины. При этом мало где указаны хоть какие-то примеры работающих ботов.
Прежде всего, бот для Telegram — это по-прежнему приложение, запущенное на вашей стороне и осуществляющее запросы к Telegram Bot API. Причем API довольное простое — бот обращается на определенный URL с параметрами, а Telegram отвечает JSON объектом.
Рассмотрим API на примере создания тривиального бота:
1. Регистрация
Прежде чем начинать разработку, бота необходимо зарегистрировать и получить его уникальный id, являющийся одновременно и токеном. Для этого в Telegram существует специальный бот — @BotFather.
Пишем ему /start и получаем список всех его команд.
Первая и главная — /newbot — отправляем ему и бот просит придумать имя нашему новому боту. Единственное ограничение на имя — оно должно оканчиваться на «bot». В случае успеха BotFather возвращает токен бота и ссылку для быстрого добавления бота в контакты, иначе придется поломать голову над именем.
Для начала работы этого уже достаточно. Особо педантичные могут уже здесь присвоить боту аватар, описание и приветственное сообщение.
Не забудьте проверить полученный токен с помощью ссылки /getMe»>api.telegram.org/bot /getMe, говорят, не всегда работает с первого раза.
2. Программирование
Создавать бота буду на Python3, однако благодаря адекватности этого языка алгоритмы легко переносятся на любой другой.
Telegram позволяет не делать выгрузку сообщений вручную, а поставить webHook, и тогда они сами будут присылать каждое сообщение. Для Python, чтобы не заморачиваться с cgi и потоками, удобно использовать какой-нибудь реактор, поэтому я для реализации выбрал tornado.web. (для GAE удобно использовать связку Python2+Flask)
Здесь мы при запуске бота устанавливаем вебхук на наш адрес и отлавливаем сигнал выхода, чтобы вернуть поведение с ручной выгрузкой событий.
Приложение торнадо для обработки запросов принимает класс tornado.web.RequestHandler, в котором и будет логика бота.
Здесь CMD — словарь доступных команд, а send_reply — функция отправки ответа, которая на вход принимает уже сформированный объект Message.
Собственно, её код довольно прост:
Теперь, когда вся логика бота описана можно начать придумывать ему команды.
3. Команды
Перво-наперво, необходимо соблюсти соглашение Telegram и научить бота двум командам: /start и /help:
Структура message[‘from’] — это объект типа User, она предоставляет боту информацию как id пользователя, так и его имя. Для ответов же полезнее использовать message[‘chat’][‘id’] — в случае личного общения там будет User, а в случае чата — id чата. В противном случае можно получить ситуацию, когда пользователь пишет в чат, а бот отвечает в личку.
Команда /start без параметров предназначена для вывода информации о боте, а с параметрами — для идентификации. Полезно её использовать для действий, требующих авторизации.
После этого можно добавить какую-нибудь свою команду, например, /base64:
Для пользователей мобильного Telegram, будет полезно сказать @BotFather, какие команды принимает наш бот:
I: /setcommands
BotFather : Choose a bot to change the list of commands.
I: @******_bot
BotFather: OK. Send me a list of commands for your bot. Please use this format:
C таким описанием, если пользователь наберет /, Telegram услужливо покажет список всех доступных команд.
4. Свобода
Как можно было заметить, Telegram присылает сообщение целиком, а не разбитое, и ограничение на то, что команды начинаются со слеша — только для удобства мобильных пользователей. Благодаря этому можно научить бота немного говорить по-человечески.
UPD: Как верно подсказали, такое пройдет только при личном общении. В чатах боту доставляются только сообщения, начинающиеся с команды (/ ) (https://core.telegram.org/bots#privacy-mode)
Чтобы бот получал все сообщения в группах пишем @BotFather команду /setprivacy и выключаем приватность.
Для начала в Handler добавляем обработчик:
А потом в список команд добавляем псевдо-речь:
Здесь эмпирическая константа 75 относительно неплохо отражает вероятность того, что пользователь всё-таки хотел сказать. А format_map — удобна для одинакового описания строк как требующих подстановки, так и без нее. Теперь бот будет отвечать на приветствия и иногда даже обращаться по имени.
5. Не текст.
Боты, как и любой нормальный пользователь Telegram, могут не только писать сообщения, но и делиться картинками, музыкой, стикерами.
Для примера расширим словарь RESPONSES:
И будем отлавливать текст :
Видно, что теперь структура Message уже не содержит текст, поэтому необходимо модифицировать send_reply:
И все, теперь бот будет время от времени присылать стикер вместо времени:
6. Возможности
Благодаря удобству API и быстрому старту боты Telegram могут стать хорошей платформой для автоматизации своих действий, настройки уведомлений, создания викторин и task-based соревнований (CTF, DozoR и прочие).
Вспоминая статью про умный дом, могу сказать, что теперь извращений меньше, а работа прозрачнее.
7. Ограничения
К сожалению, на данный момент существует ограничение на использование webHook — он работает только по https и только с валидным сертификатом, что, например для меня пока критично за счет отсутствия поддержки сертифицирующими центрами динамических днс.
К счастью, Telegram также умеет работать и по ручному обновлению, поэтому не меняя кода можно создать еще одну службу Puller, которая будет выкачивать их и слать на локальный адрес:
P.S. По пункту 7 нашел удобное решение — размещение бота не у себя, а на heroku, благо все имена вида *.herokuapp.com защищены их собственным сертификатом.
UPD: Telegram улучшили Бот Апи, из-за чего, теперь не обязательно иметь отдельную функцию для отправки сообщений при установленном вебхуке, а в ответ на POST запрос можно отвечать тем же сформированным JSON с ответным сообщением, где одно из полей устанавливается как ч ‘method’: ‘sendMessage’ (или любой другой метод, используемый ботом).
Telegram-бот: как создать и заработать на нем
Telegram — не просто безопасное и удобное средство коммуникации. Благодаря постоянному развитию и новым инструментам, мессенджер превратился в автономную платформу, полезную для обычных пользователей и для владельцев бизнеса.
В Telegram легко можно найти разнообразный тематический контент, организовать авторские курсы, делиться подборками продуктов, продвигать бренд, строить комьюнити.
Сегодня говорим о другой полезной функции — о Telegram-ботах. Подробно рассмотрим процесс создания бота (без специальных навыков программирования и прочих сложных штук) и разберемся, как с помощью ботов продвигать товары и услуги.
Что такое Telegram-бот
Бот — это программа, робот, который помогает улучшить, автоматизировать и упростить взаимодействие с аудиторией.
Боты — самостоятельные аккаунты, не требуют дополнительного номера телефона для регистрации. Для начала использования их не нужно устанавливать отдельно. Они имитируют поведение реального человека, с которым вы взаимодействуете в чате.
Интерфейс ботов текстовый, так что вы управляете ботами через сообщения, которые содержат определенные команды, инструкции. Боты распознают эти команды и реагируют в соответствии с заданной программой. Приложения полностью автономны и не требуют контроля со стороны: их необходимо лишь настроить в соответствии с вашими целями.
Боты — это кроссплатформенные приложения, поэтому вы можете использовать их в версии Telegram любой операционной системы (IOS, Android, Windows).
Стоит отметить, что бот никогда не начинает коммуникацию первым. Для начала работы необходимо согласие подписчика на получение сообщений.
Ботов можно интегрировать в уже существующие чаты каналов, а также находить отдельно, введя @имя_бота в строке поиска приложения. Вот как это происходит.
Шаг 1. Ищем в поиске @имя_бота.
Шаг.2 Знакомимся с описанием бота.
Шаг 3. Заходим в бот, изучаем описание меню. Если все нравится, нажимаем «Запустить».
Telegram-боты помогают расширить базовый функционал каналов и повысить активность, вовлеченность аудитории.
Каждый бот можно настроить для определенной цели, например:
Преимущество ботов — их вариативность и многофункциональность. Вам не нужно скачивать на телефон несколько сторонних приложений, набирать большую команду администраторов. Достаточно найти несколько готовых ботов (или создать своего), которые будут выдавать информацию.
Вы можете создавать собственных ботов и пользоваться услугами сторонних сервисов. Во втором случае рекомендуем обращаться к каталогам Telegram-ботов с проверенными качественными подборками для разных задач. Разница между ботами в Telegram и, например, ботами в Facebook в том, что благодаря публичному API, в Telegram их может создать любой пользователь.
Как создать Telegram-бота
Создать и настроить бота довольно просто. Для этого совсем не обязательно владеть языками программирования.
Для начала нужно придумать имя, продумать команды, найти два Telegram-бота в помощь — @Fatherbot и @Manybot. Приступаем.
Шаг 1. Находим в строке поиска мессенджера приложение @FatherBot.
@FatherBot — это главный бот, который помогает создавать и изменять существующие боты.
Шаг 2. Заходим в беседу с ботом, читаем описание.
Для начала работы нам нужно отправить команду /start.
Эта команда выведет на экран главное меню (список всего того, что умеет @FatherBot).
Кстати, не обязательно печатать команды вручную, достаточно ввести символ «/» в диалоговом окне. После этого отобразится лист доступных команд, и вы сможете кликнуть на нужную.
Также можно нажать на подсвеченную синим цветом команду в выпавшем сообщении с меню.
Шаг 3. Создаем бот.
Чтобы приступить к созданию нового бота, отправляем команду /newbot.
Получаем ответное сообщение, где нужно ввести название бота.
Вводим имя нашего бота.
Шаг 4. Придумываем юзернейм.
Теперь нам нужно придумать юзернейм, который позволит находить бот внутри мессенджера или через браузер.
Важно: название бота должно оканчиваться на слово «bot» (welcome_bot, information_bot, newsbot).
@FatherBot сообщает нам, что юзернейм свободен и теперь закреплен за нашим ботом.
Теперь у нашего бота есть собственная гиперссылка, через которую пользователи могут находить бот и заходить в чат через браузер и сам мессенджер (http://t.me/StarsFriens_bot).
Также мы получаем токен (API-ключ). Это набор символов, исходный код нашего бота, который позволяет управлять им и изменять его в специальных конструкторах. Токен понадобится на следующих этапах работы с ботом.
Шаг 5. Переходим к настройкам бота.
Отправляем в чат @FatherBot команду /mybots и выбираем нужный бот для редактирования (сейчас у нас только один тестовый бот, но впоследствии можно создавать и редактировать неограниченное количество ботов).
Отправляем в чат @FatherBot команду /mybots и
выбираем нужный бот для редактирования (сейчас у нас только один тестовый бот, но впоследствии можно создавать и редактировать неограниченное количество ботов).
Нажимаем на наш тестовый бот, получаем сообщение с меню, где нас спрашивают, что бы мы хотели сейчас сделать. Нажимаем в меню команду «Edit Bot» и получаем области редактирования нашего бота.
На скриншоте видим «скелет» бота. Сейчас у него есть только название, но нет ни описания, ни каких-либо команд (действий, которые могут совершать с ним пользователи). По мере того как вы будете изменять бот, эти поля заполнятся.
Например, выбираем поле «Edit Description» и нажимаем соответствующую кнопку.
Получаем сообщение, где нам предлагают дать описание того, чем наш бот поможет пользователям (такое же сообщение выпало нам, когда мы зашли в чат с @FatherBot).
Добавляем текст и получаем подтверждающее сообщение, что описание к боту добавлено.
Клавишу «Back to Bot» мы нажимаем каждый раз после того, как внесли изменение и хотим вернуться к другим настройкам бота.
Кстати, если нажмете клавишу «Back to Bot» и вернетесь к настройкам, то увидите, что «скелет» бота обновился: добавилось описание (Description).
В чем разница между полем Description и About? Description мы видим, когда уже зашли в чат с ботом. Поле About — это описание профиля бота, которое пользователи видят до начала диалога.
Снова нажимаем «Edit Bot», выбираем кнопку «Edit About». Поле About не должно превышать 120 символов.
About изменено. Нам снова предлагают либо вернуться к меню с настройками, либо к списку наших ботов (напоминаем, у нас он пока только один).
Давайте посмотрим, где находится Description и About на примере нашего бота. Как это увидят пользователи? Мы уже можем ввести в поиске Telegram название нашего бота @StarsFriend_bot
В профиле бота видим поле About, а в самом чате — Description:
Шаг 5. Добавляем картинку.
Снова выбираем «Edit Bot», затем «Edit Botpic». Присылаем в чат заранее подготовленную картинку.
Нажимаем «Back to Bot», смотрим на «скелет» нашего бота.
Теперь здесь отображаются почти все параметры, кроме команд. Для настройки команд понадобится специальный редактор ботов — @Manybot.
Шаг 6. Добавляем команды через редактор @Manybot.
Так как @Fatherbot не позволяет создавать команды для новых ботов, мы будем настраивать наш бот через специальные редакторы, например, через @Manybot.
@Manybot — многофункциональная платформа для создания и редактирования ботов, доступная на русском языке. В ней легко создавать меню и команды. Здесь же можно редактировать описание и другие параметры бота без знания языков программирования.
Находим бот в поиске приложения Telegram, отправляем в чат команду /start.
Получаем сообщение с меню.
На месте клавиатуры появляется меню, которым мы будем пользоваться в дальнейшем. Нам нужно выбрать «Добавить бота».
Обратите внимание, что @Manybot содержит подробный список инструкций по любым настройкам. Нажмите на кнопку «Инструкции» (или отправьте в чат команду /tutorials) — и получите детальные гиды (на скриншоте отражена лишь часть инструкций). Нажмите кнопку «Помощь» — и снова получите меню доступных действий с вашим ботом (как на скриншоте выше):
Если вам недостаточно той информации, которая есть в меню самого @Manybot, вы можете найти большое количество пошаговых видео и инструкций в интернете. Так и гуглим: «Manybot инструкция».
Итак, нажимаем «Добавить нового бота». В ответ на команду @Manybot предлагает уже знакомый нам алгоритм. Остается только скопировать токен (напомним, мы получили его в самом начале от @FatherBot) и прислать его в сообщении @Manybot.
Важно! Никому не присылайте свой токен. Пользуйтесь только проверенными конструкторами ботов. Мы ведь не хотим, чтобы наш бот попал в чужие руки.
Отправляем сообщение «Я скопировал токен».
Присылаем наш токен из сообщения в чате с @Fatherbot.
Токен принят, и сейчас мы перейдем в чат с нашим ботом и далее будем работать в нем.
В чате с @Manybot даем команду /newpost (или нажимаем клавишу меню «Отправить новое сообщение подписчикам»). Выбираем нашего бота в выпавшем сообщении.
Нажимаем на название бота в сообщении, и нас перебрасывает в чат с нашим ботом. Здесь видим сообщение, которое только что отправил нам @Manybot. Оно содержит меню с настройками. Это пульт управления нашим ботом. Здесь можем перечитать подробные инструкции по каждому пункту. И снова видим удобные клавиши меню на месте клавиатуры:
Нас интересует клавиша «Пользовательские команды». Это и есть будущие пункты меню нашего бота. Теперь можем создавать любые команды для нашего бота — специальные запросы, которые будут отправлять подписчики, чтобы получить информацию или действие от бота.
Сначала настроим команды, а затем уже их вид в меню (то, как их будут видеть подписчики).
Выбираем «Создать команду».
Советуем перед началом программирования бота составить лист задач, который он будет выполнять для пользователей: отвечать на вопросы, присылать фотографии, что-то еще.
Так как тематика нашего тестового бота связана с астрономией и астрологией, в качестве одной из команд мы вставим ссылку на сайт NASA. Эту команду (опцию будущего меню) так и назовем: /site.
После этого отправляем ссылку на сайт NASA и нажимаем «Сохранить». Получаем сообщение, что наша команда добавлена в меню бота.
Вы можете добавить для подписчиков возможность задавать боту вопросы. Для этого есть специальная кнопка «Добавить вопрос». Нажимаем ее и видим варианты: «Обычный вопрос», «Развернутый ответ», «С вариантами ответа».
Вы также можете включить «Режим Случайного Сообщения».
Приведем пример еще двух команд: /wallpaper (мы хотим, чтобы пользователи могли скачать тематические обои) и /info (после этой команды пользователь получит информацию о создателях бота).
Для /wallpaper используем режим случайного сообщения и загрузим пять картинок. Нажимаем «Сохранить».
Шаг 7. Настройка меню бота.
Благодаря удобным клавишам меню снизу добавляете и упорядочиваете команды, которые вы задали боту на предыдущих этапах.
Выбираем «Настроить гл.меню», «Добавить пункт меню», выбираем уже созданную нами команду, называем ее (финальное название для пользователя, а не формат /команда), сохраняем.
Например, хотим переименовать команду /info в понятное «О нас».
Выбираем «Добавить пункт меню» — /info:
Теперь меню нашего бота выглядит так. Кстати, можно использовать любой язык и эмодзи.
В наш тестовый бот добавили три пункта меню: /info (о нас), /site (официальный сайт NASA), /coolfact (интересные факты).
Как заработать на Telegram-ботах и использовать их для продвижения продуктов
Если рассматривать заработок в ботах с точки зрения подписчика, то в Telegram есть сервисы, которые платят за выполнение различных заданий. Они платят, например, за просмотры постов и видео, комментарии в соцсетях, подписки на каналы и ботов.
Найти подобные сервисы можно по запросам в поисковике: например, «Топ-10 ботов для заработка в Telegram в 2021 году». Учтите, что многие из таких сервисов работают по серым схемам. Мы не приветствуем накрутку целевых действий и советуем внимательно читать отзывы и условия участия в заданиях от ботов.
Кроме того, вы можете разрабатывать ботов на заказ, а затем продавать владельцам каналов.
Для бизнеса, веб-мастеров, онлайн-предпринимателей все интереснее. Боты позволяют оптимизировать процессы, выстраивать эффективные коммуникации, лучше понимать запросы клиента и оперативно на них отвечать.
Компании могут создать Telegram-бота любой тематики и продвигать его среди своей аудитории. Если раньше вы рекламировали свой сайт, то теперь рекламируете бота.
Такая маркетинговая стратегия называется Telegram First: пользователи совершают все целевые действия прямо внутри мессенджера. Таким образом, если хотите получать хорошие показатели в Telegram, полноценно работайте с лидами в этом мессенджере, уделяйте этому маркетинговому каналу внимание и ресурсы.
Для бесплатных мастер-классов и марафонов Telegram-бот — находка еще потому, что его можно рекламировать, как мы говорили выше, в различных Telegram-каналах. Конверсия в бота будет выше, чем конверсия в заявку на лендинге, ведь здесь пользователю нужно сделать минимум шагов, чтобы совершить целевое действие.
Пример бота с мастер-классом
Всплывающее уведомление от бота пользователь с большой долей вероятности заметит и кликнет на него. А если даже пропустит, то чат с ботом поднимется в списке над другими чатами.
Немного подробнее о последнем пункте. Объем рекламы, проходящей через Telegram, постоянно увеличивается, согласно исследованиям. Специалисты отмечают, что большим спросом пользуется именно реклама в Telegram-ботах. И вот почему:
Аналитики также заявляют, что стоимость размещения в Telegram-каналах ежемесячно увеличивается на 10–15%. В ботах такого роста не наблюдается, и стоимость целевого действия пользователей обычно гораздо ниже.
Доставка сообщения одному подписчику бота варьируется от 50 копеек до 1 рубля. Стоимость подписчика — около 10 рублей. А стоимость подписчика канала — в среднем не меньше 50 рублей.
Как находить Telegram-ботов для рекламы
Существует три способа: поиск в браузере, готовые каталоги с ботами, услуги рекламных бирж.
При первом варианте достаточно ввести в поиске запрос, например «Топ Telegram ботов по изучению английского языка». Выдача предоставит авторские подборки ботов на различные тематики.
Каталоги также можно найти через поиск в браузере. Введите запрос «Каталог ботов в Telegram». Вот пример такого сайта.
Делаем телеграм бота за 5 минут: быстрый старт с продвинутым шаблоном
В последнее время я сделал настолько много ботов для телеграмма, что крайне преисполнился в том, как их писать, как хостить, да и в принципе выработал красивый шаблон для быстрого их создания.
Сразу могу предложить посмотреть на то, что получиться в конце этого туториала. Для этого я запустил бота с идентичном шаблону кодом.
Также стоит отметить, что хостинг в этом примере бесплатный, но его хватает для разумной нагрузки.
А еще сразу скажу, что далее будет все на питоне. Вот. Сказал. Не буду больше ходить вокруг да около, у нас всего 5 минут (помните, да?). Приступим!
Пошаговая инструкция
1) Создаем репозиторий на гитхабе из моего шаблона
2) Регистрируемся на Heroku
3) Создаем новое приложение
4) Привязываем наш репозиторий к проекту на Heroku
5) Настраиваем автоматический deployment
6) Смотрим на адрес, где будет висеть наш бот
7) Настраиваем переменные среды
VALUE
Рандомная строка из букв для безопастности
Еще одна рандомная строка из букв для безопастности
Адрес полученный в пункте 6 (например fancy-panda.herokuapp.com). Обратите внимание на формат!
Токен для бота, куда будут отправляться логи (оставьте пустым, если хотите отключить логирование в телеграм)
user_id, куда будут отправляться логи (получить в боте @userinfobot)
8) Собираем наше приложение и ждем пока оно запустится
9) Заходим по адресу из пункта 6 и добавляем к ссылке пароль. Получиться что-то такое: fancy-panda.herokuapp.com/?password=
10) Устанавливаем webhook, переходя по ссылке на подобие fancy-panda.herokuapp.com/set_webhook?password=
Тестируем
Теперь, когда мы закончили все настраивать, пора посмотреть, что же мы «натворили».
Пример работы из коробки Пример работы логирования
Добавляем функционал
Теперь, когда у вас есть рабочий бот, который сам разворачивается и запускается в облаке, пришло время добавить свои функции. Для примера такую:
Думаю, дальше ограничивает вас только воображение. (ну почти)
Применение в проектах
Все любят, когда есть примеры работы. На основе этого шаблона я сделал бота wifi_qr_bot, который генерирует QR-коды для подключения к WiFi. Это упрощает жизнь, ведь пароль у вас длинный (безопасность, все дела), а вводить его на каждом новом устройстве вам лень.
Выводы
Вот мы и сделали нашего бота, который хостится в облаке. Он уже многое умеет в плане логирования. Для логирования я написал отдельную библиотеку, tg-logger. Если интересно, как она работает, то потыкайте в демо бота. Если все еще интересно, прочитайте мою статью. Такие пироги с котятками.