Создание и хостинг телеграм бота. От А до Я
Привет, хабрчане! Какой бы заезженной не была тема создания телеграм бота на python3, я не нашёл инструкций, где показан путь от первой строчки кода до деплоинга бота (по крайней мере все методы, что я видел, немного устарели). В этой статье я хочу показать процесс создания бота от написания BotFather-у до деплоинга бота на Heroku.
Статья получилась длинной, советую пробежаться глазами по содержанию и кликнуть по интересующему вас пункту.
P.S. Пишите если нужна статья по созданию более сложного бота, т.е. с вебхуками, БД с настройками юзеров и т.д.
BotFather
Для начала нам надо зарегистрировать нашего бота в Telegram. Для этого:
В поиске вбиваем @BotFather и переходим в диалог с Отцом Ботов.
Пишем /newbot. Указываем имя бота (то, что отображается в диалогах). Указываем его логин, по которому его можно булет найти.
P.S. Оно должно заканчиваться на Bot/bot
Вот. Нам дали API ключ и ссылку на бота. Желательно сохранить API ключ и перейти в диалог с ботом, чтобы потом не копаться в переписке с BotFather
Дальше добавим ему пару команд: пропишем /setcommands и одним сообщением, т.к. /setcommands не добавляет команды, а задаёт их с нуля, пошлём ему команды.
all — спарсить заголовки с вкладки «ВСЁ ПОДРЯД»
top — спарсить заголовки с вкладки «ЛУЧШЕЕ»
На этом работа с BotFather закончилась, перейдём к следующей части.
Установка и настройка pipenv. Первый запуск.
Для начала создадим файл, в котором будет основной код бота bot.py. Если бот большой, то сразу создавайте файлы, куда вы вынесете функции, классы и т.д, иначе читаемость кода стремится к нулю. Я добавлю parser.py
Установим pipenv, если его конечно ещё нет.
Установим pipenv в папку проекта.
Установим интересующие нас библиотеки. Я буду работать с PyTelegramBotAPI. Также для парсинга добавим BeautifulSoup4.
Начинаем писать код!
Открываем bot.py, импортируем библиотеки и создаём главные переменные.
Запустим бота. Посмотри наличие ошибок.
Если ошибок не появилось, то продолжим.
Хэндлеры. Отвечаем на команды и сообщения
Пришло время научить бота отвечать нам. Возможно даже сделать его ответы полезными.
Основы взаимодействия. Ответ на команды
Для взаимодействия с пользователем, т.е. для ответа на его команды и сообщения используются хэндлеры.
Начнём с самого простого: ответим на команды /start и /go
Сейчас разберёмся что это и как это работает. Передаём в message_handler параметр commands равный массиву со строками — командами, на которые он будет отвечать описанным ниже образом. (На все эти команды он ответит одинаково). Далее используем send_message, в него записываем id чата (его можно достать из message.chat.id), в который отправить сообщение и, собственно, само сообщение. Нельзя забыть написать bot.polling() в конце кода, иначе бот сразу же выключиться. Почему так мы узнаем позже.
Теперь можно запустить бота и написать ему /start или /go и он ответит.
P.S. Сообщение может быть не только строкой, а, в принципе, чем угодно.
Это json объект, хранящий информацию об отправителе, чате, и самом сообщении.
Основы взаимодействия. Ответ на текстовые сообщения.
Теперь обработаем текстовые сообщения бота. Самое важное что нам нужно знать это то, что текст сообщения храниться в message.text и то, что, чтобы обрабатывать текст в message_handler нужно передавать content_types=[‘text’].
Добавим вот такой код.
Тут мы довабили пару переменных: вынесли текст сообщения (в нижнем регистре, чтобы не было лишних проблем с теми кто пишет капсом, заборчиком и т.д.) в переменную text, вынесли message.chat.id в отдельную переменную, чтобы каждый раз не обращаться к message. Также мы построили небольшое ветвление, для ответа на определённые сообщения, а также ответ на случай непонятного боту сообщения.
Основы взаимодействия. Ответ на картинки, документы, аудио и прочие.
Для ответа на картинки, стикеры, документы, аудио и т.д. нужно всего лишь поменять content_types=[‘text’].
Рассмотрим пример с картинкой, добавив этот код.
Все типы контента:
text, audio, document, photo, sticker, video, video_note, voice, location, contact, new_chat_members, left_chat_member, new_chat_title, new_chat_photo, delete_chat_photo, group_chat_created, supergroup_chat_created, channel_chat_created, migrate_to_chat_id, migrate_from_chat_id, pinned_message
Строим цепочку ответов.
Пришло время закончить с элементарными действиями и начать что-то серьёзное. Попробуем построить цепочку ответов. Для этого нам понадобиться register_next_step_handler(). Создадим простой пример, на котором и разберёмся как работает register_next_step_handler().
И так, в первой функции добавился bot.register_next_step_handler(msg, askAge), в него мы передаём сообщение, которые хотим послать, и следующий щаг, к которому перейти после ответа пользователя.
Во второй функции всё поинтересней, здесь идёт проверка ввёл ли пользователь число, и, если нет, то функция рекурсивно вызывает сама себя, с сообщением «Возраст должен быть числом, введите ещё раз.». Если пользователь ввёл всё верно, то он получает ответ.
Но, есть тут проблема. Можно повторно вызвать команду /go или /start, и начнётся бардак.
Пофиксить это несложно, добавим переменную для проверки состояния выполнения скрипта.
С построением простых цепочек мы разобрались, пойдём дальше.
Добавляем парсер в цепочку.
Для начала нужен сам парсер. Обратим внимание на то, что во вкладках «Лучшее» и «Всё подряд» есть дополнительные фильтры: сутки, неделя, месяц и ≥10, ≥25, ≥50, ≥100 соответственно.
Парсер конечно можно написать и в 1 функцию, но я разобью на 2, так будет проще читать код.
По итогу парсер возвращает нам строку с заголовками статей, основываясь на наших запросах.
Пробуем, используя полученные знания, написать бота связанного с парсером. Я решил создать отдельный класс (это скорее всего неправильный метод, но это уже относится к питону, а не к основной теме статьи), и в объекте этого класса хранить изменяемые данные.
Теория. Методы взаимодействия с ботом.
Мы используем long polling для получения данных о сообщениях от бота.
Есть же вариант использовать в корне другой метод — вебхуки. Так бот сам будет отправлять нам данные о получении сообщения и т.д. Но этот метод сложнее в настройке, и, для простого показательного бота я решил его не использовать.
Также в дополнительных материалах будут ссылки на всё, что использовалось и о чём говорилось.
Маркапы. Добавляем клавиатуры для быстрого ответа.
Наконец основной код дописан. Теперь можно передохнуть и написать маркапы. Я думаю вы неоднократно видели их, но всё же, приложу скриншот. [SCREENSHOT]
Я выведу маркапы в отдельный файл — markups.py.
В написании маркапов нет ничего сложного. Нужно лишь создать маркап, указать пару параметров, создать пару кнопок и добавить их в маркап, далее просто указываем reply_markup=markup в send_message .
В параметры маркапа указываем ширину строки и изменение размеров кнопок, иначе они огромны.
Применим полученные знания к нашему боту.
Ура! С кодом впринципе разобрались. Теперь самое важное — деплоинг бота не хероку.
Деплоим бота на Heroku.
Для начала надо зарегистрироваться на Хероку и на Гитхабе.
Теперь создаём репозиторий на гитхабе. (нажмите плюсик слева от вашего аватара)
Сейчас нам нужен Procfile (Procfile.windows для windows). Создаём его и записываем в него bot: python3 bot.py
Теперь удаляем TOKEN из bot.py, здесь он не нужен, ведь мы будем загружать этот файл на гитхаб. Через тот же терминале, что использовали для запуска бота, заливаем файлы на гитхаб. (Предворительно удалите папку __pycache__).
Гит просит логин и пароль, спокойно вводим и преступаем к деплоингу бота на хероку. Пишем всё в том же терминале.
Теперь возвращаем TOKEN в bot.py, здесь он нужен, ведь мы будем загружать этот файл на хероку.
Чтобы выключить бота
И, не забываем перед залитием на гитхаб и удалить TOKEN из нашего bot.py. Ведь нам не нужно, чтобы кто-то им пользовался. Можно конечно воспользоваться .gitignore и вынести токены в отдельный фай.
Поздравляю!
Работа окончена, бот работает удалённо.
Ссылки
Заключение
Если кому-то было интересно, то цель написания статьи выполнена. Если кому-то хочется увидеть статью про более сложного бота (с вебхуками, подключенной БД с настройками пользователей и т.д.) — пишите.
Сервер для бота Telegram: как разместить и какой хостинг выбрать
FAQ
Боты в «Телеграме» придуманы для облегчения работы с мессенджером. Поскольку задача приложения не только пересылать текстовые сообщения, но и предоставлять информацию, боты помогают в поиске этой информации, могут фильтровать ее или выполнять команды абонента.
У каждого владельца аккаунта в «Телеграм» обязательно найдется несколько bots. Нередко в таком случае возникает проблема, какой хостинг выбрать для телеграм-бота.
Зачем нужны боты
Ботов создали для выполнения монотонных, скучных действий, которые подражают деятельности настоящего пользователя, но с большей скоростью и правильностью.
Они нашли применение во множестве областей: интернет-рекламе, в играх, интернет-торгах, мессенджерах и прочее.
Названия помощников оканчиваются на «bot». Фактически, это рабочие аккаунты, управляемые программами.
Чтобы их использовать, не требуется выходить из мессенджера для решения простых задач: задать вопрос, ответить, перевести, обучать, играть. Это армия помощников, каждому из которых можно дать задание, и они беспрекословно и точно исполнят ваши желания.
Как ими пользоваться
В «Телеграме» есть каталог ботов с ссылками на помощников. Список находится на сайте https://tgram.ru/bots/.
Нужного bot можно найти другим способом: в строке поиска. Для этого заходят в приложение и в поле с лупой пишут название робота. Помощником будет тот, з названием которого есть значок робота.
Чтобы начать взаимодействовать с bot, кликните на /start. Сразу же вы получите информацию о программе и список доступных команд.
Что такое хостинг
Слово «хостинг» означает некое хранилище. Дело в том, что после написания bot его нужно где-то хранить, чтобы он постоянно функционировал. Хостинги содержатся на общем компьютере, который называют сервером.
Конечно, можно создать хостинг на своем домашнем ПК, но это представляет определенные трудности, а именно постоянная беспрерывная работа устройства. Само собой, это никому неудобно. Поэтому все же желательно подобрать общий хостинг для бота Telegram.
Существует несколько типов хостингов. Они различаются не только по цене, но и программному обеспечению, функционалу, объему памяти.
Общий виртуальный
Один из популярнейших. Подходит для небольших онлайн-магазинов, сайтов. Виртуальный хостинг – результат деления одного сервера на несколько частей для сдачи в аренду. Из минусов виртуального типа: наличие ограничений скорости записи или на использование ОП.
На сегодня наиболее известный тип host. Цена – от 2 до 15$ в месяц.
Виртуальный сервер
Также деление server на несколько частей для сдачи в аренду, но эти части будут независимы друг от друга, следовательно, ограничения не предусмотрены.
Это удобно тем, что можно настроить именно под свой проект или даже установить отдельное ПО. Подойдет для более крупных проектов. Цена аренды такого ресурса от 17$.
Выделенный сервер
Это хост – целый server. Плюс: нет зависимости от остальных клиентов провайдера. Вы как единственный админ получаете доступ к ПО, то есть осуществляете полный контроль систем.
Выделенный сервер – отличный вариант для игр, соцсетей и крупных проектов. Но и стоимость аренды такого хостинга от 50$.
Colocation
Колокейшн представляет собой хостинг, за который нужно платить провайдеру не только за аренду, но и за обслуживание server. Кроме того, есть услуга защиты данных, но она тоже платная.
Облачный сервер (Cloud-hosting)
При таком типе хоста оплата производится за объем ресурсов. Провайдер сам распределит их между серверами. Подходит в случае, когда сайт занимает несколько разных server. Плюс в том, что можно использовать ресурсы нескольких серверов. Цена – от 7$.
Разница между хостингом и доменными именами
Отличие домена состоит в том, что он предоставляет абсолютное право собственности на имя сайта. К домену никто не имеет доступа, кроме его владельца.
Наличие домена не предполагает того, что сайт рабочий. Чтобы его запустить, все равно потребуется сервер. А хостинг – это уже настроенный server с подключением к Сети и с обслуживанием.
Как выбрать хостинг для приложения
Перед тем как разместить бота Telegram на какой-нибудь хостинг, для начала надо этот хостинг выбрать.
Для этого нужно учесть 4 нюанса:
- функции и инструменты;
- дисковое пространство;
- цена и качество обслуживания;
- уровень техподдержки.
По первому критерию нужно обратить внимание на такие способности хоста:
- трафик;
- поддержка CMS, скриптов, баз данных, технологий;
- удобство управления;
- доступ к сайту для копирования, удаления либо редактирования файлов на сервере;
- возможность наблюдать за состоянием server;
- доступ к нескольким почтовым аккаунтам;
- защита от вирусов, спама и рекламы;
- бесплатный пробный период или возможность вернуть средства.
При выборе объема пространства для приложения достаточно будет 100 МБ.
На счет службы поддержки, то ее работа должна быть беспрерывной.
Как разместить бота Телеграм
Когда сервер для бота Telegram выбран, пришло время помощника размещать. Для начала потребуется регистрация на соответствующем сайте server. Теперь у вас есть аккаунт. В него нужно зайти и нажать на создание проекта (Create new app). Если название проекта придумано, то опустите этот шаг, если нет, то назовите bot. Имя должно быть уникальным.
Проект готов. Далее нужно выбирать варинат размещения. В разделе Deploy описано, как загрузить бота на сервер.
Если взять, к примеру, бесплатный server Heroku, то потребуется скачать Heroku CLI и войти через него в учетную запись, а затем открыть папку приложения через терминал.
Потом нужно инициализировать git в папке (git init) и установить ссылку на репозиторий «Геруку» (heroku git:remote -a archakov-im-telegram-bot).
Теперь нужно создать в папке с ботом Procfile и указать внутри файла команду start.
Зпуск робота производится следующим образом:
- git add .
- git commit -m “init” .
- git push heroku master .
Что делать, если бот не работает
Проблема решается двумя способами. Первый способ – написать @Botfather. Он решит технологические неполадки и предоставит инструкции с описанием правильного варианта кода.
Второй способ – активировать чат с помощью команды /setprivacy. Робот активизируется. После указания адреса bot вам покажутся участки прописки кода с ошибками и путями их исправления.
Выводы
Для опытных юзеров создать и разместить бота на сервере будет несложно. Трудности составят лишь выбор самого хостинга. Но поскольку их существует много, то ориентируясь по общепринятым критериям, можно подобрать подходящий именно под ваши запросы хостинг.
Какой хостинг и тариф лучше выбрать для Телеграм-бота, его настройка
Каждый начинающий разработчик должен попробовать создать чат-бота. Это полезная практика, которая помогает освоить принципы взаимодействия с API. Процесс создания бота можно поделить на два этапа – написания кода проекта и публикация на удаленном хостинге. Не стоит пренебрегать последним шагом, ведь выбор некачественного хостинга может привести к полной неработоспособности вашего проекта. Расскажем, какой выбрать подходящий хостинг для Телеграм-бота.
Как выбрать хостинг
Предполагаем, что хотя бы поверхностное представление о предназначении хостингов у наших читателей есть. Однако для полноты материала проведем небольшой ликбез по этому вопросу. Хостинг – это удаленный компьютер, который работает 24 часа в сутки (в идеале) и имеет бесперебойный доступ в интернет. Стоит отметить, что Телеграм-боты можно запускать и на компьютерах пользователей.
Однако у такого подхода много недостатков:
- компьютер рано или поздно придется выключить;
- мощностей и пропускной способности сети не хватит для ботов, которыми пользуются несколько десятков человек;
- компьютеры с ОС Windows иногда автоматически блокируют работу бота, считая его «неиспользуемым приложением».
Таких изъянов нет у хостингов. Но даже те различаются между собой по нескольким параметрам и критериям. Для выбора подходящего удаленного хостинга рекомендуем следовать критериям ниже:
- Цена. В этом плане поставщики значительно отличаются друг от друга. Например, три разных хостера (поставщик услуг) могут требовать разные цены за одну и ту же услугу.
- Тарифы и их количество. В зависимости от предназначения бота и его загруженности необходимо использовать разные тарифные планы. От них зависит количество выделяемой памяти, пропускная способность сети и прочие технические характеристики. Если ботом будут пользоваться 10 человек, то нет смысла покупать для него продвинутые тарифы. И, наоборот – для популярных ботов нельзя использовать слабые тарифные планы, в которых выделяется от силы 64 мегабайта памяти и скорость в 10 мбит/секунду.
- Поддержка необходимых технологий. Скрипт на Python точно не запустится на сервере, где нет интерпретатора. Список доступных технологий указывается на официальных страницах провайдеров.
- Репутация. Может хостинг и обещает дешевые тарифы с заманчивыми условиями, он может попросту не выполнять свои обязательства. Бывали случаи, когда провайдеры предоставляли одни услуги, а описывали совсем другие. Их быстро выводили на чистую воду гневные пользователи, которые писали отрицательные отзывы на разных сайтах.
- Безопасность. На правильно настроенных серверах все проекты работают отдельно друг от друга, а потому
Есть и другие критерии, например, юридические тонкости и инструменты управления удаленным сервером. Однако не стоит на них зацикливаться, особенно если речь идет о первых ботах, которые не будут использоваться в производственных целях. На основе этих критериев автор составил список наиболее оптимальных для Telegram-ботов хостингов:
- Timeweb;
- Beget;
- Reg ru.
Какой тариф использовать
Как мы уже говорили, в плане выбора тарифа надо быть осторожным и всегда искать золотую середину. Тарифы делятся между собой по следующим характеристикам:
- Количество ядер. Этот параметр отвечает за многозадачность, лучше использовать не меньше 2 CPU.
- Количество оперативной памяти. Еще один параметр, отвечающий за многозадачность. Чаще всего даже дешевые тарифы предоставляют 1 ГБ ОЗУ. Этого вполне достаточно для работы бота с низким уровнем активности (то есть тем, которым почти никто не пользуется).
- Количество внутренней памяти, также известный как NVMe. Тут все просто – если бот хранит какие-то большие файлы, то лучше брать тариф с большим количеством NVMe. Если бот вообще ничего не хранит кроме логов и данных пользователей, то можно выбирать тариф с наименьшим количеством внутренней памяти.
- Пропускная способность. От этого параметра зависит то, как быстро ваш проект получит запрос, а также, сколько времени понадобится на отправку ответа.
Стоит отметить, что некоторые хостинг-провайдеры позволяют пользователям самостоятельно настроить характеристики.
Настройка хостинга
Одного выбора площадки для размещения бота недостаточно, нужно уметь правильно настраивать ее во избежание потерь производительности, а также для поддержания работоспособности проекта. Большинство хостингов поддерживают только консольную настройку через SSH-подключение. Этого вполне достаточно для подготовки площадки к загрузке бота. Пошаговая инструкция:
- Оформите тариф на аренду VPS-сервера на любом удобном для вас хостинге.
- В личном кабинете найдите данные для входа по SSH.
- Скачайте на компьютер любую программу для подключения по SSH, например, PuTTY. Можно использовать и встроенную в Windows утилиту, однако с ней не всегда удобно работать из-за невозможности сохранять параметры подключения.
- Подключитесь к удаленному серверу через SSH. Для этого введите необходимые данные в соответствующие поля.
- После открытия подключения в командной строке введите следующую команду: «sudo apt —reinstall install python3 -y».
- Дождитесь ее завершения, а после введите «sudo apt —reinstall install python3-pip -y». Эти две команды используются для обновления интерпретатора и менеджера пакетов.
- Загрузите все зависимости (библиотеки, которые нужны для работы проекта).
- Также рекомендуем установить менеджер пакетов. Для этого поочередно включите следующие команды:
sudo apt install nodejs
sudo apt install npm
npm install pm2 -g
На этом процесс настройки сервера завершен.
Загрузка бота на сервер
Сервер готов, проект тоже, теперь осталось соединить их вместе. Сделать это гораздо проще, чем кажется. Обычно провайдеры предоставляют два способа для загрузки файлов – через встроенный в админ-панель файловый менеджер и через FTP-сервер. В случае с ботом мы рекомендуем использовать встроенный менеджер, ведь он намного быстрее справится с небольшими файлами.
- Откройте папку с проектом.
- Откройте файловый менеджер в админ-панели на сайте хостинг-провайдера.
- Создайте через «админку» новую папку.
- Загрузите в нее файлы проекта. Например, timeweb поддерживает функцию drug and drop. Это значит, что пользователю достаточно перетащить файлы проекта в окно браузера, все остальное сделает сайт.
Запуск
Последний шаг – это запуск бота. Для того чтобы выполнить его, достаточно ввести только две команды:
На каких хостингах в России ещё можно создать бота для Telegram?
Благодаря отличной внешней политике, публикую мой список хостингов, к которым я обращусь в первую очередь, если понадобится запустить телеграм-бота.
Вообще, не очень понимаю, почему все в этом мире не используют Beget, но тем не менее, вот список шаред и VPS хостингов, где Telegram API всё ещё функционирует:
-
— самый лучший хостинг на российском пространстве. Работает на шаред и на VPS. Самый лучший, быстрый и дешёвый вариант из мне известных.
- Reg.ru — медленный, на HDD, тупой, но работающий хостинг
- SpaceWeb — делал мелкий проектик, API ещё доступен
- ihc.ru — тоже работает
- Яндекс.Облако — на их VPS боты работает отлично
Список хостингов где гарантировано не получится развернуть Telegram бота:
- HostLand — отрубили доступ прямо в пике работы одного из ботов. Вообще, хостинг очень плохой, дерут три дорого за бесплатные функции обычных хостингов.
- Mail.Ru Cloud Solutions — использовал их VPS машины, до API запросы не доходят
Ну и не лишним будет упомянуть, что на любом хостинге за бугром всё работает отлично. Digital Ocean, Amazon, Google Cloud и т.д.
В будущем, если удастся поработать на других хостингах — обязательно протестирую их на предмет доступности Telegram API.