TelegramMultiSender

Автор: !ниц

TG: @emotionswaggage

https://github.com/nitzlover/TelegramMultiSender

Данное приложение позволяет отправлять сообщения в Telegram с использованием нескольких API-профилей и разных сессий. Ниже описаны важные требования, правила и пошаговая инструкция по настройке и использованию.

Важные условия и правила

Аккаунт Telegram для сессии должен быть без 2FA (без пароля).
Если у вас включена двухфакторная аутентификация, отключите её в настройках Telegram или используйте другой аккаунт без 2FA. В некоторых случаях Telethon запрашивает пароль 2FA, но если в коде не реализован ввод этого пароля, авторизация по QR может не завершиться.
Убедитесь, что аккаунт Telegram не заблокирован и не ограничен.
Необходим стабильно работающее интернет-соединение.
Если в вашей стране или сети Telegram заблокирован, используйте VPN или прокси.
Не передавайте файлы .session третьим лицам.
Они содержат авторизационные данные и могут дать полный доступ к вашему аккаунту.
Убедитесь, что используете актуальную версию приложения.
При необходимости обновите Telethon, если вы запускаете программу из исходников.

1. Запуск программы

Если у вас есть готовый EXE-файл:

Запустите TelegramSender.exe двойным кликом. Ничего дополнительно устанавливать не нужно — все необходимые библиотеки уже встроены.
Откроется основное окно программы с четырьмя вкладками:Основное
Сессии
API
Дебаг

2. Создание и настройка API

Перед созданием сессии и отправкой сообщений нужно получить API ID и API HASH от Telegram.

2.1 Как создать приложение и получить API-данные

Перейдите на my.telegram.org (используйте тот аккаунт, который будете применять).
Авторизуйтесь с помощью кода, присланного в ваш Telegram (либо через логин/пароль, если включена 2FA).
Перейдите в раздел API Development Tools.
Нажмите Create new application (или выберите уже существующее).
Заполните поля:App title: любое название.
Short name: короткое название (латиницей).
URL и Platform можно указать произвольные (актуально, если используется только для бота или скрипта).
После сохранения появятся:App api_id (API ID)
App api_hash (API HASH)
Скопируйте их — они понадобятся в программе.

2.2 Добавление API-профиля в программу

Перейдите на вкладку API.
В поле «Имя профиля» введите любое удобное название (например, MainAccount).
В поля «API ID» и «API HASH» вставьте соответствующие значения, полученные с сайта my.telegram.org.
Нажмите «Создать профиль API».
В списке ниже отобразится ваш новый профиль.

Можно создать несколько профилей, если у вас есть разные данные (API ID / API HASH) для разных аккаунтов.

3. Работа с сессиями (Авторизация через QR‑код)

3.1 Создание новой сессии

Перейдите на вкладку Сессии.
В поле «Имя новой сессии» введите название (например, test_session).
Нажмите «Создать сессию (QR)».
Программа сгенерирует QR-код и отобразит его.
Откройте на телефоне Telegram → Настройки → Устройства → Подключить устройство. Отсканируйте QR-код.
При успешном входе появится сообщение: «Успешный вход через QR‑код!»
В папке sessions/ появится файл test_session.session.

Важно: если у аккаунта включён пароль (2FA), авторизация по QR может не сработать.

3.2 Выбор сессии

На вкладке Основное выберите сессию (например, test_session.session) в списке «Выберите сессию для отправки сообщений».
Убедитесь, что выбран корректный профиль API (см. раздел «API»).

3.3 Удаление сессии

На вкладке Сессии выделите нужный файл (например, test_session.session).
Нажмите «Удалить выбранную сессию».
Файл .session будет удалён из папки sessions/.

4. Массовая отправка сообщений

4.1 Подготовка списка пользователей

Создайте текстовый файл (например, users.txt).
В каждой строке укажите @username или номер телефона в формате +123456789.
Сохраните файл.

4.2 Загрузка файла с пользователями

На вкладке Основное нажмите «Выбрать файл с юзерами».
Укажите ваш users.txt.
Программа отобразит путь к файлу в логах.

4.3 (Опционально) Добавление вложения

Нажмите «Добавить вложение».
Выберите нужный файл (PDF, изображение, документ и т.д.).
Путь к вложению появится в лог-окне.

4.4 Ввод сообщения

В большом текстовом поле «Введите текст сообщения» введите ваш текст.
Можно использовать эмодзи и форматирование (Markdown), если это поддерживается клиентом.

4.5 Запуск отправки

Убедитесь, что выбраны правильные API-профиль и сессия.
Нажмите «Запустить бота».
Программа по очереди отправит сообщения всем пользователям из users.txt.
Каждое успешно отправленное имя пользователя записывается в processed.txt, чтобы избежать повторной отправки.
Если указано вложение, оно отправится вместе с текстом (при условии, что формат поддерживается Telegram).

4.6 Остановка отправки

Нажмите «Остановить бота» в любой момент, чтобы прервать рассылку.
Уже отправленные сообщения отменить невозможно.

5. Отслеживание логов

Бот лог (вкладка «Основное») показывает ключевые события: «Сообщение отправлено» или «Ошибка при отправке».
Дебаг (вкладка «Дебаг») показывает подробную отладочную информацию и тексты ошибок.

Все логи также выводятся в консоль (если программа запущена без флага --noconsole при использовании Python-скриптов).

6. Частые вопросы (FAQ)

Q: Можно ли использовать одно и то же имя сессии под разными API-профилями?

A: Не рекомендуется смешивать разные API-данные в одной сессии, так как каждая сессия привязана к конкретному Telegram-аккаунту. Для нескольких аккаунтов создавайте отдельные API-профили и сессии.

Q: Что делать, если при сканировании QR-кода возникает ошибка?

A: Убедитесь, что на телефоне установлена последняя версия Telegram, стабилен интернет и QR-код ещё действителен (он может протухать через 30–60 секунд).

Q: Почему у некоторых пользователей при отправке вложений возникает «User deactivated»?

A: Пользователь удалил или заблокировал свой аккаунт, и он недоступен.

Q: Как изменить текст уже запущенной рассылки?

A: Остановите бота («Остановить бота»), измените текст, затем снова запустите. Повторная отправка не будет выполнена тем, кто уже в processed.txt.

Q: Что делать, если аккаунт защищён паролем (2FA)?

A: Отключите 2FA в настройках Telegram или используйте аккаунт без пароля.

7. Дополнительная информация

Папка sessions/
Хранит файлы .session. Не удаляйте их, если хотите сохранить авторизацию.
Файл api_profiles.json
Содержит ваши профили API.
Файл processed.txt
Хранит логины/номера, которым уже было отправлено сообщение.
Безопасность
Не передавайте .session-файлы третьим лицам — это может дать доступ к вашему аккаунту.
Связь с автором
По вопросам или при обнаружении ошибок пишите: @emotionswaggage.

Удачной работы!