Telegram чат-боты на Python с библиотекой pyTelegramBotAPI: от начального уровня до продвинутых решений

Расширенные примеры с детальными пояснениями

Пример 1: Бот с регистрацией пользователя и сохранением в SQLite

Этот бот собирает имя, возраст и город, затем сохраняет данные в локальную базу данных SQLite.

import telebot
from telebot import types
import sqlite3

bot = telebot.TeleBot('TOKEN')

def init_db():
    conn = sqlite3.connect('users.db')
    cursor = conn.cursor()
    cursor.execute('''CREATE TABLE IF NOT EXISTS users (
        user_id INTEGER PRIMARY KEY,
        name TEXT,
        age INTEGER,
        city TEXT
    )''')
    conn.commit()
    conn.close()

init_db()

user_data = {}  # временное хранение до сохранения
state = {}  # состояния

@bot.message_handler(commands=['register'])
def register_start(message):
    state[message.chat.id] = 'get_name'
    bot.send_message(message.chat.id, 'Введите ваше имя:')

@bot.message_handler(func=lambda m: state.get(m.chat.id) == 'get_name')
def get_name(message):
    user_data[message.chat.id] = {'name': message.text}
    state[message.chat.id] = 'get_age'
    bot.send_message(message.chat.id, 'Сколько вам лет?')

@bot.message_handler(func=lambda m: state.get(m.chat.id) == 'get_age')
def get_age(message):
    if not message.text.isdigit():
        bot.send_message(message.chat.id, 'Пожалуйста, введите число.')
        return
    user_data[message.chat.id]['age'] = int(message.text)
    state[message.chat.id] = 'get_city'
    bot.send_message(message.chat.id, 'Из какого вы города?')

@bot.message_handler(func=lambda m: state.get(m.chat.id) == 'get_city')
def get_city(message):
    user_data[message.chat.id]['city'] = message.text
    # Сохраняем в БД
    conn = sqlite3.connect('users.db')
    cursor = conn.cursor()
    data = user_data.pop(message.chat.id)
    cursor.execute('INSERT OR REPLACE INTO users (user_id, name, age, city) VALUES (?,?,?,?)',
                   (message.chat.id, data['name'], data['age'], data['city']))
    conn.commit()
    conn.close()
    del state[message.chat.id]
    bot.send_message(message.chat.id, 'Регистрация завершена!')

@bot.message_handler(commands=['me'])
def show_profile(message):
    conn = sqlite3.connect('users.db')
    cursor = conn.cursor()
    cursor.execute('SELECT name, age, city FROM users WHERE user_id = ?', (message.chat.id,))
    row = cursor.fetchone()
    conn.close()
    if row:
        bot.send_message(message.chat.id, f'Имя: {row[0]}, Возраст: {row[1]}, Город: {row[2]}')
    else:
        bot.send_message(message.chat.id, 'Вы ещё не зарегистрированы. Используйте /register')

bot.polling()

Результат: При первом запуске создаётся таблица users. Пользователь проходит три шага, данные сохраняются. Команда /me показывает профиль.

Пример 2: Интеграция с внешним API (погода)

Бот получает название города от пользователя и возвращает текущую погоду через OpenWeatherMap.

import telebot
import requests

bot = telebot.TeleBot('TOKEN')
OWM_API_KEY = 'ваш_ключ'

@bot.message_handler(commands=['weather'])
def ask_city(message):
    msg = bot.send_message(message.chat.id, 'Напишите название города:')
    bot.register_next_step_handler(msg, send_weather)

def send_weather(message):
    city = message.text
    url = f'http://api.openweathermap.org/data/2.5/weather?q={city}&appid={OWM_API_KEY}&units=metric&lang=ru'
    response = requests.get(url)
    if response.status_code == 200:
        data = response.json()
        temp = data['main']['temp']
        desc = data['weather'][0]['description']
        bot.send_message(message.chat.id, f'Погода в {city}: {desc}, температура {temp}°C')
    else:
        bot.send_message(message.chat.id, 'Город не найден. Попробуйте снова.')

bot.polling()

Результат: Пользователь вводит команду /weather, затем название города. Бот отправляет запрос к API и отображает погоду.

Пример 3: Бот с уведомлениями по расписанию (schedule)

Бот отправляет напоминание каждый день в определённое время. Используется библиотека schedule.

import telebot
import schedule
import time
import threading

bot = telebot.TeleBot('TOKEN')
CHAT_ID = 123456789  # заменить на реальный ID

def send_reminder():
    bot.send_message(CHAT_ID, 'Не забудьте сделать зарядку!')

schedule.every().day.at('09:00').do(send_reminder)

def run_schedule():
    while True:
        schedule.run_pending()
        time.sleep(1)

threading.Thread(target=run_schedule, daemon=True).start()

@bot.message_handler(commands=['start'])
def start(message):
    bot.send_message(message.chat.id, 'Бот запущен. Уведомления будут приходить каждый день в 9:00.')

bot.polling()

Результат: При старте бота запускается поток, который проверяет расписание. Каждый день в 9 утра пользователь получает сообщение.

Пример 4: Inline-режим (поиск через бота)

Бот работает в inline-режиме: пользователь может ввести запрос в любом чате, набрав @botusername, и бот предложит результаты.

import telebot
from telebot import types

bot = telebot.TeleBot('TOKEN')

@bot.inline_handler(func=lambda query: len(query.query) > 0)
def inline_search(inline_query):
    query_text = inline_query.query
    results = []
    # Пример: предложить несколько вариантов ответа
    for i, item in enumerate(['Вариант A', 'Вариант B', 'Вариант C']):
        if query_text.lower() in item.lower():
            results.append(types.InlineQueryResultArticle(
                id=str(i),
                title=item,
                input_message_content=types.InputTextMessageContent(
                    message_text=f'Вы выбрали: {item}'
                )
            ))
    if not results:
        results.append(types.InlineQueryResultArticle(
            id='0',
            title='Нет результатов',
            input_message_content=types.InputTextMessageContent(message_text='Ничего не найдено')
        ))
    bot.answer_inline_query(inline_query.id, results)

bot.polling()

Результат: При вводе @botusername и текста в любом чате появляется список статей. Выбор статьи отправляет сообщение с текстом.

Пример 5: Использование middleware для логирования

Можно добавить промежуточный обработчик для логирования всех входящих сообщений.

import telebot

bot = telebot.TeleBot('TOKEN')

@bot.middleware_handler(update_types=['message'])
def log_messages(bot_instance, message):
    print(f'Получено сообщение от {message.from_user.id}: {message.text}')

@bot.message_handler(commands=['start'])
def start(message):
    bot.send_message(message.chat.id, 'Привет! Логирование активно.')

bot.polling()

Результат: Каждое входящее сообщение перед обработкой выводится в консоль. В production можно записывать в файл или БД.