TelegramMultiSender — кроссплатформенное приложение на Python для массовой рассылки сообщений в Telegram.
Поддерживает несколько API-профилей (API ID / API HASH), авторизацию через QR-код, отправку текстовых сообщений и вложений.
- Features
- Current Features
- Planned Features
- System Requirements
- Getting API ID & API HASH
- Installation & Usage from Source
- Download Ready-to-Use EXE
- Quick Start
- FAQ
- Important Notes
- Contributing & License
- Contacts
- Multiple API Profiles: храните несколько пар ключей (API ID / API HASH) для разных Telegram‑аккаунтов.
- QR Authorization: создавайте сессии (
.sessionфайлы) через удобный QR-код, без ввода кода из SMS. - Bulk Messaging: отправляйте сообщения (и файлы) сразу многим пользователям.
- Logging: отдельные вкладки для логов бота и отладочной информации.
- Dark Theme: современный интерфейс на PyQt6.
- Standalone EXE: при наличии готовой сборки не требуется установка Python и зависимостей.
- 2FA: Логика обработки двухфакторной аутентификации (запрос пароля при QR‑авторизации).
- Отдельное окно «Дебаг»: Отдельное окно «Дебаг» в отдельный пункт меню и вывод лога в новое окно.
- Задержка (SpinBox): Настройка задержки между отправками для обхода FloodWait и блокировок.
- Добавление/удаление API-профилей (API ID / API HASH).
- Создание/удаление Telegram-сессий с авторизацией через QR-код.
- Отправка текстовых сообщений списку пользователей (из файла
.txt). - Отправка вложений (файлы, изображения, документы).
- Автоматическая запись отправленных пользователей в
processed.txt, чтобы не дублировать отправку. - Лог «Бот лог» (Основное) и лог «Дебаг» (расширенная отладка).
- 2FA: Логика обработки двухфакторной аутентификации (запрос пароля при QR‑авторизации).
- Отдельное окно «Дебаг»: Отдельное окно «Дебаг» в отдельный пункт меню и вывод лога в новое окно.
- Задержка (SpinBox): Настройка задержки между отправками для обхода FloodWait и блокировок.
- Расширенное форматирование сообщений (Markdown/HTML).
- Система уведомлений о завершении рассылки.
- Бот-Версия для запуска скрипта через ботов в телеграм, дискорд.
- Рассылка через ботов что б можно было выбирать между рассылкой от аккаунтов или ботов.
- Готовая сборка (EXE): не требует установки Python. Достаточно Windows 7+ (рекомендуется Windows 10/11).
- Запуск из исходного кода:
- Python 3.9+
- Зависимости: PyQt6, telethon, qasync, qrcode (см.
requirements.txt)
- Стабильное интернет-соединение.
- Зайдите на my.telegram.org.
- Авторизуйтесь с помощью своего Telegram-аккаунта.
- Перейдите в раздел API Development Tools.
- Создайте новое приложение или используйте существующее.
- Скопируйте App api_id и App api_hash.
- Вставьте их в приложении при создании профиля API.
- Склонируйте репозиторий:
git clone https://github.com/username/TelegramMultiSender.git cd TelegramMultiSender - Установите зависимости
pip install -r requirements.txt
- Установите зависимости
py TelegramMultiSender.py
- Скачать стабильную версию (EXE) [Releases]
- Поместите скачанный
.exeфайл в удобную для вас папку. - Запустите
.exeфайл двойным кликом.
- Никаких дополнительных установок (Python, библиотеки) не требуется.
- Введите имя профиля, например:
MainAccount. - Укажите
API IDиAPI HASH. - Нажмите кнопку «Создать профиль API».
- Введите имя сессии, например:
test_session. - Нажмите кнопку «Создать сессию (QR)».
- Отсканируйте QR-код в официальном Telegram-клиенте:
- Откройте Настройки → Устройства → Подключить устройство
- Наведите камеру на QR-код в приложении.
- Выберите нужный API‑профиль и сессию.
- Загрузите файл со списком пользователей (логины / номера) и (опционально) вложение (файл, изображение и т.д.).
- Введите текст сообщения.
- Нажмите «Запустить бота», чтобы начать рассылку.
- «Бот лог» (вкладка «Основное») — показывает основные события: отправлено, ошибка, статус отправки и т.д.
- «Дебаг» (вкладка «Дебаг») — расширенная отладочная информация, включая stack trace ошибок.
Вопрос: Почему при сканировании QR-кода не происходит авторизация?
Ответ: Убедитесь, что в вашем Telegram-аккаунте не включена 2FA (двухфакторная аутентификация). Если она включена, убедитесь что вы ввели пароль, проверте правильно ли вы ввели пароль.
Вопрос: Как избежать блокировки за спам?
Ответ: Не рассылайте сообщения слишком быстро и по слишком большим спискам сразу. Telegram накладывает ограничения (FloodWait) при подозрении на массовый спам. Добавьте задержки между сообщениями или используйте несколько сессий.
Вопрос: Можно ли использовать программу на Linux/macOS?
Ответ: Да. Если вы запускаете из исходных кодов (Python 3.9+), программа будет работать на любой платформе, где поддерживаются PyQt6, telethon и другие зависимости.
Вопрос: Где найти подробный мануал по использованию?
Ответ: Мы подготовили расширенную инструкцию, доступную на Telegra.ph.
- Файл
processed.txt: Список пользователей, которым уже отправлено сообщение, записывается вprocessed.txt. Это предотвращает повторные рассылки. - Безопасность: Не передавайте
.session‑файлы третьим лицам, иначе они получат доступ к вашему Telegram‑аккаунту. - Блокировки Telegram: Если в вашей стране Telegram заблокирован, используйте прокси / VPN.
- Лимиты Telegram: При слишком частой рассылке возможен
FloodWaitили временные блокировки от Telegram.
- Contributing: Мы будем рады вашим Pull Requests и идеям в разделе Issues.
- License: Проект распространяется под лицензией MIT
- Автор: @emotionswaggage
- GitHub: github.com/username/TelegramMultiSender
Important
Используйте программу ответственно и в соответствии с правилами Telegram. Не нарушайте политику в отношении спама. Автор не несёт ответственности за возможные блокировки аккаунтов или иные последствия неправильного использования.