Пишем telegram-бота на python с помощью библиотеки telebot

Лирическое отступление

Боты сегодня — это многофункциональный инструмент, как для бизнеса, так и для развлечений. Лично я считаю, что за ними будущее. Конечно, прочитав эту статью, вы не сможете создавать большие проекты, но заинтересоваться и начать — вполне.

Установка и настройка

Для начала давайте скачаем сам python. Сделать это можно на официальном сайте. Не забудьте поставить галочку add to PATH во время установки! После установки python'a нам понадобится хороший редактор кода. На помощь приходит компания JetBrains со своим бесплатным PyCharm. Мы уже близко, осталось скачать библиотеку telebot. Для этого заходим в командную строку и пишем:
pip install telebot

Если всё прошло успешно, мы можем продолжать!

***

Думаю все знают о блокировки telegram в России и единственным решением как всегда остаётся ***. Лично я рекомендую Windscribe, т.к. вам дают 2 гб. трафика совершенно бесплатно!

Bot Father

В поиске telegram находим Bot Farher'a и создаем своего бота с помощью команды /newbot. Затем вводим имя и юзернейм. Обратите внимание, что юзернейм должен оканчиваться на bot!




Как вы видите нам выдали специальный api токен, с помощью которого вы сможете управлять своим ботом (в моём случае это: 776550937:AAELEr0c3H6dM-9QnlDD-0Q0Fcd65pPyAiM). Свой токен Вы можете запомнить, но я рекомендую его записать.

Код

Настал момент, которого ждали все. Открываем PyCharm и создаем новый проект.



Тут рекомендую поставить всё как у меня (название, конечно можно изменить). После создания проекта, давайте создадим файл, в котором будет наш код. Кликните правой кнопкой по папке с вашем проектом, затем New → Python File. Отлично, начнем писать код. Импортируем библиотеку telebot, с помощью:

import telebot

Теперь нужно создать переменную bot. На самом деле имя переменной может быть каким угодно, но я привык писать bot.

bot = telebot.TeleBot('ваш токен')

Код

bot = telebot.TeleBot('ваш токен')

Напишем декоратор @bot.message_handler(), с помощью которого наш бот будет реогировать на команду /start. Для этого в круглых скобках пишем commands=['start']. В итоге у нас должно получиться это:

@bot.message_handler(commands=['start'])

Код

@bot.message_handler(commands=['start'])

Если Вы попробуете запустить своего бота (ПКМ->Run), то у вас ничего не выйдет. Во первых в конце кода мы должны прописать bot.polling(). Это нужно для того, чтобы бот не выключился сразу, а работал и проверял, нет ли на сервере нового сообщения. А во вторых наш бот если уж и будет проверять наличие сообщений, то всё равно ничего ответить не сможет. Пора это исправлять! После нашего декоратора создаем функцию start_message, которая будет принимать параметр message (название функции может быть любым). Далее давайте реализуем отправку сообщения от самого бота. В функции пропишем bot.send_message(message.chat.id, 'Привет, ты написал мне /start'). Смотрите, что у Вас должно получиться:

import telebot
bot = telebot.TeleBot('776550937:AAELEr0c3H6dM-9QnlDD-0Q0Fcd65pPyAiM')

@bot.message_handler(commands=['start']) def start_message(message):
bot.send_message(message.chat.id, 'Привет, ты написал мне /start')

bot.polling()

Код

import telebot

bot = telebot.TeleBot('776550937:AAELEr0c3H6dM-9QnlDD-0Q0Fcd65pPyAiM') 



@bot.message_handler(commands=['start']) def start_message(message):    

    bot.send_message(message.chat.id, 'Привет, ты написал мне /start') 



bot.polling()

Проверим…




Отлично, наш бот работает! Чтобы он отвечал не только на команды, но и на сообщения, создадим новый декоратор @bot.message_handler(), а в круглые скобочки напишем content_types=['text']. Вообще существует множество видов контента, к примеру location, photo, audio, sticker и т.д. Но нам же нужно отвечать на текст, верно? Поэтому создаём функцию send_text, принимающую параметр message. В функции пропишем условие:

@bot.message_handler(content_types=['text'])
def send_text(message):
if message.text == 'Привет':
bot.send_message(message.chat.id, 'Привет, мой создатель')
elif message.text == 'Пока':
bot.send_message(message.chat.id, 'Прощай, создатель')

Код

@bot.message_handler(content_types=['text'])

def send_text(message):

    if message.text == 'Привет':

        bot.send_message(message.chat.id, 'Привет, мой создатель')

    elif message.text == 'Пока':

        bot.send_message(message.chat.id, 'Прощай, создатель')

Если текст сообщения будет равен «Привет», то бот отвечает «Привет, мой создатель», а если текст сообщения будет равен «Пока», то бот ответит «Прощай, создатель». Тут думаю всё понятно. Но вы скорее всего задались вопросом, а если пользователь пропишет «привет», ну или «пРиВет», как быть в этой ситуации? Всё достаточно просто! В условии, после message.text напишите функцию .lower(), а в тексте все заглавные буквы замените на строчные. Теперь наш бот отвечает не только на «привет», но и на «ПривеТ», и даже «пРиВеТ».



Вот что у вас должно получиться:

import telebot

bot = telebot.TeleBot('776550937:AAELEr0c3H6dM-9QnlDD-0Q0Fcd65pPyAiM')

@bot.message_handler(commands=['start'])
def start_message(message):
bot.send_message(message.chat.id, 'Привет, ты написал мне /start')

@bot.message_handler(content_types=['text'])
def send_text(message):
if message.text.lower() == 'привет':
bot.send_message(message.chat.id, 'Привет, мой создатель')
elif message.text.lower() == 'пока':
bot.send_message(message.chat.id, 'Прощай, создатель')

bot.polling()

Код

import telebot



bot = telebot.TeleBot('776550937:AAELEr0c3H6dM-9QnlDD-0Q0Fcd65pPyAiM')



@bot.message_handler(commands=['start'])

def start_message(message):

    bot.send_message(message.chat.id, 'Привет, ты написал мне /start')



@bot.message_handler(content_types=['text'])

def send_text(message):

    if message.text.lower() == 'привет':

        bot.send_message(message.chat.id, 'Привет, мой создатель')

    elif message.text.lower() == 'пока':

        bot.send_message(message.chat.id, 'Прощай, создатель')



bot.polling()

Отлично, с текстом мы разобрались, но как же отправить к примеру стикер? Всё просто! У каждого стикера есть свой id, соответственно зная id мы сможем его отправить. Получить id стикера можно двумя способами. Первый (простой) — через специального бота «What's the sticker id?»



Ну и второй способ, для тех, кто не ищет лёгких путей. Создаем новый декоратор @bot.message_handler(), вот только в скобочки пишем content_types=['sticker']. Далее всё как обычно. Создаем функцию, принимающую параметр message, а вот в ней пропишем print(message). Запускаем бота.



Смотрите, как только я отправил стикер, он сразу же вывел информацию в консоль, и в самом конце будет наш id стикера (file_id). Давайте сделаем так, чтобы когда пользователь отправил боту «я тебя люблю», то бот ему ответил стикером. Создавать новый декоратор не нужно, мы просто допишем условие, которое было до этого. Вот только вместо bot.send_message() пропишем bot.send_sticker(), а вместо текста напишем id стикера.



Поздравляю, всё получилось! Думаю как отправить аудио, фото, и геолокацию, вы разберетесь сами. Я же хочу показать вам, как сделать клавиатуру, которую бот покажет вам при старте. Это уже будет сделать сложнее. Создаем переменную keyboard1, в которую запишем telebot.types.ReplyKeyboardMarkup(). Эта функция вызывает клавиатуру. Далее создадим ряды, но помните, что рядов может быть не больше 12! Для того, чтобы их создать, пишем keyboard1.row(). В круглые скобочки запишите всё что хотите, лично я напишу «Привет» и «Пока». Теперь, чтобы вызвать клавиатуру, допишем reply_markup=keyboard1 к функции отправки сообщения при старте. Вот, что у вас должно получиться:

keyboard1 = telebot.types.ReplyKeyboardMarkup()
keyboard1.row('Привет', 'Пока')

@bot.message_handler(commands=['start'])
def start_message(message):
bot.send_message(message.chat.id, 'Привет, ты написал мне /start', reply_markup=keyboard1)

Код

keyboard1 = telebot.types.ReplyKeyboardMarkup()

keyboard1.row('Привет', 'Пока')



@bot.message_handler(commands=['start'])

def start_message(message):

    bot.send_message(message.chat.id, 'Привет, ты написал мне /start', reply_markup=keyboard1)

Запускаем бота…



Вы видите, что клавиатура какая-то большая. Чтобы это исправить, нужно просто в ReplyKeyboardMarkup() прописать True. Ну а если вы хотите, чтобы клавиатура скрывалась, как только пользователь нажал на нее, то напишите еще один True. Подробнее прочитать, что означают эти True вы можете в официальной документации.

keyboard1 = telebot.types.ReplyKeyboardMarkup(True, True)

Код

keyboard1 = telebot.types.ReplyKeyboardMarkup(True, True)

Ну а на этом всё! Конечно, это не все возможно ботов в telegram, но основные возможности я вам показал. Спасибо за внимание.

Исходный код:

import telebot

bot = telebot.TeleBot('<ваш токен>')
keyboard1 = telebot.types.ReplyKeyboardMarkup()
keyboard1.row('Привет', 'Пока')

@bot.message_handler(commands=['start'])
def start_message(message):
bot.send_message(message.chat.id, 'Привет, ты написал мне /start', reply_markup=keyboard1)

@bot.message_handler(content_types=['text'])
def send_text(message):
if message.text.lower() == 'привет':
bot.send_message(message.chat.id, 'Привет, мой создатель')
elif message.text.lower() == 'пока':
bot.send_message(message.chat.id, 'Прощай, создатель')
elif message.text.lower() == 'я тебя люблю':
bot.send_sticker(message.chat.id, 'CAADAgADZgkAAnlc4gmfCor5YbYYRAI')

@bot.message_handler(content_types=['sticker'])
def sticker_id(message):
print(message)

bot.polling()

Код

import telebot



bot = telebot.TeleBot('<ваш токен>')

keyboard1 = telebot.types.ReplyKeyboardMarkup()

keyboard1.row('Привет', 'Пока')



@bot.message_handler(commands=['start'])

def start_message(message):

    bot.send_message(message.chat.id, 'Привет, ты написал мне /start', reply_markup=keyboard1)



@bot.message_handler(content_types=['text'])

def send_text(message):

    if message.text.lower() == 'привет':

        bot.send_message(message.chat.id, 'Привет, мой создатель')

    elif message.text.lower() == 'пока':

        bot.send_message(message.chat.id, 'Прощай, создатель')

    elif message.text.lower() == 'я тебя люблю':

        bot.send_sticker(message.chat.id, 'CAADAgADZgkAAnlc4gmfCor5YbYYRAI')



@bot.message_handler(content_types=['sticker'])

def sticker_id(message):

    print(message)



bot.polling()

Писал не я, все взял отсюда: https://habr.com/ru/post/448310 ( не реклама )