Как Настроить Автоматическую Рассылку Сообщений По Таймеру В Telegram Боте С Использованием Telebot И Python

Jul 20, 2025 by Jeany 109 views

Как автоматизировать рассылку сообщений в Telegram боте по таймеру с использованием Telebot и Python

В современном мире Telegram боты стали мощным инструментом для автоматизации различных задач, от информирования пользователей до предоставления персонализированных услуг. Одной из распространенных задач является рассылка сообщений по расписанию. В этой статье мы подробно рассмотрим, как реализовать автоматическую рассылку сообщений (включая изображения) в Telegram боте с использованием библиотеки Telebot для Python. Мы обсудим основные концепции, необходимые библиотеки и предоставим пошаговые инструкции с примерами кода, чтобы вы могли легко создать своего собственного бота для рассылки сообщений.

Постановка задачи

Предположим, у вас есть Telegram бот, и вы хотите, чтобы он отправлял определенное сообщение (например, картинку с текстом) пользователям через заданные промежутки времени. Основная сложность заключается в том, что бот должен продолжать работать и отправлять сообщения по расписанию, даже когда получает новые сообщения или команды от пользователей. Это требует использования многопоточности или асинхронного программирования, чтобы не блокировать основной поток бота.

Необходимые инструменты и библиотеки

Для реализации рассылки сообщений по расписанию нам понадобятся следующие инструменты и библиотеки:

Python 3.6+: Язык программирования, на котором будет написан бот.
Библиотека Telebot (pyTelegramBotAPI): Для взаимодействия с Telegram Bot API.
Библиотека schedule: Для планирования отправки сообщений по расписанию.
Библиотека threading или asyncio: Для реализации многопоточности или асинхронности.
Токен вашего Telegram бота: Полученный от BotFather в Telegram.
ID чатов пользователей или групп: Куда будут отправляться сообщения.

Шаг 1. Установка необходимых библиотек

Первым делом необходимо установить библиотеки telebot и schedule. Это можно сделать с помощью pip:

pip install pyTelegramBotAPI schedule

Шаг 2. Создание и настройка Telegram бота

Если у вас еще нет Telegram бота, создайте его, обратившись к BotFather в Telegram. BotFather выдаст вам токен, который необходимо сохранить.

Шаг 3. Написание кода бота

3.1. Импорт библиотек и инициализация бота

В начале кода импортируем необходимые библиотеки и инициализируем бота, используя полученный токен:

import telebot
import schedule
import time
import threading

# Замените 'YOUR_BOT_TOKEN' на токен вашего бота
BOT_TOKEN = 'YOUR_BOT_TOKEN'
bot = telebot.TeleBot(BOT_TOKEN)

# Список ID чатов, куда будет производиться рассылка
CHAT_IDS = [
    123456789,  # Замените на ID первого чата
    987654321,  # Замените на ID второго чата
    # Добавьте другие ID чатов по необходимости
]

# Путь к картинке, которую будем отправлять
IMAGE_PATH = 'path/to/your/image.jpg'

# Текст сообщения, которое будет отправляться вместе с картинкой
MESSAGE_TEXT = "Привет! Это автоматическая рассылка от бота!"

В этом блоке кода мы импортируем необходимые библиотеки: telebot для работы с Telegram Bot API, schedule для планирования задач, time для управления временем и threading для создания потоков. Затем мы инициализируем бота, указав токен, и определяем список CHAT_IDS с идентификаторами чатов, куда будет производиться рассылка. Также указываются IMAGE_PATH – путь к картинке и MESSAGE_TEXT – текст сообщения, которые будут отправляться.

3.2. Функция для отправки сообщения

Создадим функцию, которая будет отправлять сообщение и картинку в указанные чаты:

def send_message_with_image(chat_ids, image_path, message_text):
    """Отправляет сообщение с картинкой в указанные чаты."""
    try:
        with open(image_path, 'rb') as photo:
            for chat_id in chat_ids:
                bot.send_photo(chat_id, photo, caption=message_text)
                print(f"Сообщение отправлено в чат {chat_id}")
    except Exception as e:
        print(f"Ошибка при отправке сообщения: {e}")

Эта функция send_message_with_image принимает список ID чатов, путь к картинке и текст сообщения. Она открывает картинку в бинарном режиме, перебирает ID чатов и отправляет фотографию с текстом сообщения в каждый чат, используя метод bot.send_photo. Если возникает ошибка при отправке, она выводится в консоль. Важно отметить использование конструкции try...except для обработки возможных исключений, таких как отсутствие файла или проблемы с подключением.

3.3. Функция для планирования отправки

Теперь создадим функцию, которая будет планировать отправку сообщений с использованием библиотеки schedule:

def schedule_message(chat_ids, image_path, message_text):
    """Планирует отправку сообщения по расписанию."""
    schedule.every().day.at("10:00").do(send_message_with_image, chat_ids=chat_ids, image_path=image_path, message_text=message_text)
    schedule.every().day.at("18:00").do(send_message_with_image, chat_ids=chat_ids, image_path=image_path, message_text=message_text)

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

Функция schedule_message использует библиотеку schedule для планирования отправки сообщений. В данном примере сообщения планируются к отправке каждый день в 10:00 и 18:00. Метод schedule.every().day.at("10:00") указывает, что задача send_message_with_image должна выполняться каждый день в 10:00. Аналогично, schedule.every().day.at("18:00") планирует отправку в 18:00. Цикл while True постоянно проверяет, есть ли запланированные задачи для выполнения, и выполняет их с помощью schedule.run_pending(). time.sleep(1) добавляет задержку в 1 секунду, чтобы не перегружать процессор.

3.4. Запуск планировщика в отдельном потоке

Чтобы планировщик не блокировал основной поток бота, запустим его в отдельном потоке:

def run_scheduler(chat_ids, image_path, message_text):
    """Запускает планировщик в отдельном потоке."""
    schedule_thread = threading.Thread(target=schedule_message, args=(chat_ids, image_path, message_text))
    schedule_thread.daemon = True
    schedule_thread.start()

Функция run_scheduler создает новый поток (threading.Thread), в котором будет выполняться функция schedule_message. Установка schedule_thread.daemon = True позволяет потоку завершиться, когда завершается основной поток. Затем поток запускается с помощью schedule_thread.start(). Это позволяет планировщику работать в фоновом режиме, не блокируя основной поток бота.

3.5. Обработчики сообщений (по желанию)

Если вы хотите, чтобы бот обрабатывал входящие сообщения, добавьте соответствующие обработчики:

@bot.message_handler(commands=['start', 'help'])
def send_welcome(message):
    bot.reply_to(message, "Привет! Я бот для рассылки сообщений.")

@bot.message_handler(func=lambda message: True)
def echo_all(message):
    bot.reply_to(message, message.text)

Эти обработчики сообщений демонстрируют, как бот может отвечать на команды /start и /help, а также эхо-отвечать на любое другое сообщение. @bot.message_handler – это декоратор, который регистрирует функцию как обработчик сообщений. send_welcome отвечает на команды /start и /help, отправляя приветственное сообщение. echo_all отвечает на любое текстовое сообщение, отправляя его обратно пользователю. Эти обработчики позволяют боту взаимодействовать с пользователями, пока планировщик отправляет сообщения по расписанию.

3.6. Запуск бота

В конце кода запустим планировщик и бота:

if __name__ == '__main__':
    run_scheduler(CHAT_IDS, IMAGE_PATH, MESSAGE_TEXT)
    bot.infinity_polling()

Блок if __name__ == '__main__': гарантирует, что код внутри него будет выполнен только при запуске скрипта напрямую, а не при импорте его как модуля. Здесь мы запускаем планировщик с помощью run_scheduler, передавая ему список ID чатов, путь к картинке и текст сообщения. Затем запускается основной цикл бота с помощью bot.infinity_polling(), который постоянно опрашивает Telegram API на наличие новых сообщений и обрабатывает их.

Полный код

import telebot
import schedule
import time
import threading

# Замените 'YOUR_BOT_TOKEN' на токен вашего бота
BOT_TOKEN = 'YOUR_BOT_TOKEN'
bot = telebot.TeleBot(BOT_TOKEN)

# Список ID чатов, куда будет производиться рассылка
CHAT_IDS = [
    123456789,  # Замените на ID первого чата
    987654321,  # Замените на ID второго чата
    # Добавьте другие ID чатов по необходимости
]

# Путь к картинке, которую будем отправлять
IMAGE_PATH = 'path/to/your/image.jpg'

# Текст сообщения, которое будет отправляться вместе с картинкой
MESSAGE_TEXT = "Привет! Это автоматическая рассылка от бота!"

def send_message_with_image(chat_ids, image_path, message_text):
    """Отправляет сообщение с картинкой в указанные чаты."""
    try:
        with open(image_path, 'rb') as photo:
            for chat_id in chat_ids:
                bot.send_photo(chat_id, photo, caption=message_text)
                print(f"Сообщение отправлено в чат {chat_id}")
    except Exception as e:
        print(f"Ошибка при отправке сообщения: {e}")

def schedule_message(chat_ids, image_path, message_text):
    """Планирует отправку сообщения по расписанию."""
    schedule.every().day.at("10:00").do(send_message_with_image, chat_ids=chat_ids, image_path=image_path, message_text=message_text)
    schedule.every().day.at("18:00").do(send_message_with_image, chat_ids=chat_ids, image_path=image_path, message_text=message_text)

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

def run_scheduler(chat_ids, image_path, message_text):
    """Запускает планировщик в отдельном потоке."""
    schedule_thread = threading.Thread(target=schedule_message, args=(chat_ids, image_path, message_text))
    schedule_thread.daemon = True
    schedule_thread.start()

@bot.message_handler(commands=['start', 'help'])
def send_welcome(message):
    bot.reply_to(message, "Привет! Я бот для рассылки сообщений.")

@bot.message_handler(func=lambda message: True)
def echo_all(message):
    bot.reply_to(message, message.text)

if __name__ == '__main__':
    run_scheduler(CHAT_IDS, IMAGE_PATH, MESSAGE_TEXT)
    bot.infinity_polling()

Шаг 4. Запуск бота

Сохраните код в файл, например, telegram_bot.py, и запустите его из командной строки:

python telegram_bot.py

Бот начнет работать и отправлять сообщения по расписанию. Убедитесь, что вы заменили YOUR_BOT_TOKEN, CHAT_IDS и IMAGE_PATH на свои значения.

Заключение

В этой статье мы рассмотрели, как создать Telegram бота, который отправляет сообщения по расписанию с использованием библиотеки Telebot и планировщика schedule. Мы обсудили основные шаги, начиная от установки необходимых библиотек и заканчивая запуском бота в отдельном потоке. Этот подход позволяет автоматизировать рассылку сообщений, что может быть полезно для различных задач, таких как уведомления, напоминания или маркетинговые кампании. Вы можете расширить функциональность бота, добавляя другие обработчики сообщений и команды, чтобы сделать его еще более полезным и интерактивным.

Дополнительные возможности и улучшения

Использование базы данных: Для хранения информации о пользователях, расписании рассылок и других данных можно использовать базу данных, например, SQLite или PostgreSQL.
Динамическое расписание: Предоставить пользователям возможность настраивать расписание рассылок через команды бота.
Разные типы контента: Поддержка отправки различных типов контента, таких как видео, аудио, документы и т.д.
Обработка ошибок: Более детальная обработка ошибок и логирование для упрощения отладки и мониторинга.
Веб-интерфейс: Создание веб-интерфейса для управления ботом и рассылками.

Ответы на часто задаваемые вопросы (FAQ)

Вопрос 1: Как получить ID чата в Telegram?

Ответ: Чтобы узнать ID чата, вы можете отправить любое сообщение своему боту, и он отобразит ID чата в консоли. Также существуют специальные боты, которые могут помочь вам узнать ID чата, например, @userinfobot.

Вопрос 2: Как изменить расписание отправки сообщений?

Ответ: Вы можете изменить расписание, отредактировав функцию schedule_message в коде бота. Например, чтобы отправлять сообщения каждый час, можно использовать schedule.every().hour.do(...). Для более сложных расписаний можно использовать другие возможности библиотеки schedule.

Вопрос 3: Как добавить поддержку отправки других типов контента?

Ответ: Telebot предоставляет различные методы для отправки разных типов контента. Например, для отправки видео используйте bot.send_video, для отправки аудио – bot.send_audio, для отправки документов – bot.send_document. Просто добавьте соответствующие функции в код бота и используйте их в планировщике.

Вопрос 4: Как обрабатывать ошибки при отправке сообщений?

Ответ: В функции send_message_with_image используется конструкция try...except для обработки исключений. Вы можете добавить более детальную обработку ошибок, например, логирование ошибок в файл или отправку уведомлений администратору бота. Также полезно использовать retry-логику для повторной отправки сообщений в случае временных проблем с подключением.

Вопрос 5: Как сделать так, чтобы бот отправлял сообщения только определенным пользователям?

Ответ: Вы можете хранить список ID пользователей, которым нужно отправлять сообщения, в базе данных или в конфигурационном файле. Перед отправкой сообщения проверяйте, есть ли ID пользователя в этом списке. Также можно добавить команды для бота, чтобы пользователи могли подписываться или отписываться от рассылки.