Бот для оповещения о голе в telegram

[maluky 23]

 Приветствую. Создал бота для телеграмм

Будет ли гол в матче

 

FAQ - Goal Alert Bot

Полное руководство по установке, настройке и использованию

Общие вопросы

Что такое Goal Alert Bot (.exe)?

A: Это автономная версия футбольного бота, не требующая установки Python. Программа представляет собой один исполняемый файл, который можно запустить на любом компьютере с Windows.

Чем .exe версия отличается от Python скрипта?

·         Не требует Python - все зависимости уже включены

·         Простота запуска - двойной клик по файлу

·         Защита кода - исходный код скомпилирован

·         Портативность - можно переносить на флешке

Это вирус?

1: Нет, это безопасная программа. При первом запуске антивирус может предупредить о неизвестной программе - это нормально для собранных .exe файлов. Вы можете добавить программу в исключения антивируса.

---

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

Системные требования

1:

·         Windows 7/8/10/11 (64-bit)

·         100 МБ свободного места

·         Доступ в интернет

·         Не требуется установка Python

Как установить программу?

A:

1.    Скачайте файл GoalAlertBot.zip

2.    Создайте папку для программы (например, C:\GoalAlertBot)

3.    Распакуйте GoalAlertBot.exe и файл .env с настройками в эту папку

4.    Измените настройки в файле .env 

5.    Запустите двойным кликом GoalAlertBot.exe

Где взять необходимые ключи?

A:

·         API_KEY: Зарегистрируйтесь на api-sports.io

·         BOT_TOKEN: Создайте бота через @BotFather

·         CHAT_ID: Узнайте через @userinfobot

---

Запуск и работа

Как запустить программу?

A:

1.    Простой запуск: Двойной клик по GoalAlertBot.exe

2.    С консолью: Запустите из командной строки

3.    Автозапуск: Добавьте ярлык в автозагрузку

Появилось черное окно - это нормально?

A: Да, это консоль программы. В ней отображаются логи работы. Окно можно свернуть.

 

Как добавить в автозагрузку?

A:

1.    Нажмите Win + R, введите shell:startup

2.    Создайте ярлык для GoalAlertBot.exe в этой папке

3.    Или используйте .vbs файл для скрытого запуска

Как остановить программу?

A:

·         Закройте окно консоли

·         Или нажмите Ctrl + C в активном окне

·         Или завершите процесс через Диспетчер задач

---

Решение проблем

Программа сразу закрывается

Решение:

1.    Проверьте наличие файла .env

2.    Убедитесь, что все обязательные ключи заполнены

3.    Запустите из командной строки чтобы увидеть ошибку

cmd

cd C:\GoalAlertBot
GoalAlertBot.exe

"Файл .env не найден"

Решение: Создайте файл .env в той же папке что и .exe

# =============================================
# ОБЯЗАТЕЛЬНЫЕ ПАРАМЕТРЫ
# =============================================

# API ключ от api-sports.io (получите на https://api-sports.io/)
API_KEY=ваш_api_ключ_здесь

# Токен Telegram бота (получите у @BotFather)
BOT_TOKEN=ваш_бот_токен_здесь

# ID чата для уведомлений (можно получить у @userinfobot)
CHAT_ID= ваш_id_токен_здесь

# =============================================
# ОСНОВНЫЕ НАСТРОЙКИ
# =============================================

# Уведомление, если total <= этого значения
TOTAL_THRESHOLD=2.5

# Минута матча, с которой начинать отслеживание
MINUTE_TRIGGER=60

# Если True — сработает только при счёте 0:0
ONLY_NO_GOALS=False

# Интервал проверки в секундах
CHECK_INTERVAL=60

# =============================================
# ФИЛЬТРЫ ЛИГ И СТРАН
# =============================================

# Белый список лиг (только эти лиги, через запятую)
# Формат: "Country - League Name"
LEAGUE_WHITELIST=England - Premier League,Spain - La Liga,Germany - Bundesliga,Italy - Serie A,France - Ligue 1

# Черный список лиг (игнорировать эти лиги)
LEAGUE_BLACKLIST=

# Фильтр по странам (только эти страны, через запятую)
COUNTRY_FILTER=England,Spain,Germany,Italy,France

# =============================================
# УВЕДОМЛЕНИЯ И СТАТИСТИКА
# =============================================

# Включить отправку статистики
ENABLE_STATISTICS=True

# Интервал отправки статистики в секундах
STATS_INTERVAL=3600

# Отправлять тестовое сообщение при запуске
SEND_TEST_MESSAGE=True

# =============================================
# НАДЕЖНОСТЬ И ПОВТОРЫ
# =============================================

# Максимальное количество повторов при ошибках
MAX_RETRIES=3

# Задержка между повторами в секундах
RETRY_DELAY=5

# Таймаут запросов в секундах
TIMEOUT=15

Антивирус блокирует программу

Решение:

1.    Добавьте папку с программой в исключения антивируса

2.    Или подтвердите запуск в предупреждении антивируса

3.    Это нормально для собранных .exe файлов

"Missing dependencies" ошибка

Решение: Скачайте полную версию с включенными библиотеками

Не отправляются сообщения в Telegram

Проверьте:

1.    Правильность BOT_TOKEN

2.    Правильность CHAT_ID

3.    Что бот не заблокирован

4.    Интернет-соединение

"API error 429" - лимит запросов

Решение:

env

CHECK_INTERVAL=120  # Увеличьте интервал проверки

---

Настройка параметров

Где находятся настройки?

A: Все настройки в файле .env рядом с .exe файлом

Как изменить настройки?

A:

1.    Откройте файл .env в Блокноте

2.    Измените нужные параметры

3.    Сохраните файл

4.    Перезапустите программу

Какие настройки доступны?

Основные:

env

TOTAL_THRESHOLD=2.5     # Порог тотала голов (уведомлять если голов <= этого значения)
MINUTE_TRIGGER=60       # Минута начала отслеживания (с этой минуты матча)
ONLY_NO_GOALS=False     # Только матчи 0:0 (True/False)
CHECK_INTERVAL=60       # Интервал проверки в секундах

Дополнительные:

env

ENABLE_STATISTICS=True  # Включить отправку статистики (True/False)
STATS_INTERVAL=3600     # Интервал отправки статистики в секундах
SEND_TEST_MESSAGE=True  # Отправлять тестовое сообщение при запуске (True/False)

Как настроить для моих нужд?

Для консервативных уведомлений:

env

TOTAL_THRESHOLD=1.5

MINUTE_TRIGGER=70

ONLY_NO_GOALS=True

Для большего количества уведомлений:

env

TOTAL_THRESHOLD=3.5

MINUTE_TRIGGER=30

ONLY_NO_GOALS=False

---

Мониторинг работы

Где посмотреть логи?

A: Логи отображаются в консоли и сохраняются в файл goal_bot.log

Как проверить что бот работает?

A:

1.    При запуске придет тестовое сообщение в Telegram

2.    В консоли будут сообщения о проверке матчей

3.    Команда /stats в Telegram покажет статистику

Какие команды доступны в Telegram?

A:

·         /start - информация о боте

·         /stats - статистика работы

·         /status - текущий статус

Что значат сообщения в консоли?

text

Goal Alert Bot инициализирован - Успешный запуск

Найдено матчей: 5 - Найдены активные матчи

Отправлено уведомление - Сработало предупреждение

Ошибка API: 429 - Превышен лимит запросов

---

Обновление и обслуживание

Как обновить программу?

A:

1.    Скачайте новую версию GoalAlertBot.exe

2.    Замените старый файл (сохраните .env)

3.    Перезапустите программу

Настройки сохранятся при обновлении?

A: Да, настройки в файле .env останутся

Как сделать резервную копию?

A: Скопируйте файл .env - в нем все ваши настройки

Нужно ли обновлять зависимости?

A: Нет, в .exe версии все зависимости уже включены

---

🛡️ Безопасность

Безопасно ли хранить ключи в .env?

A: Да, если файл находится на вашем компьютере. Не распространяйте файл .env

Программа передает какие-то данные?

A: Только запросы к:

·         API api-sports.io (получение данных о матчах)

·         API Telegram (отправка уведомлений)

Можно ли использовать на нескольких компьютерах?

A: Да, с одним API ключом. Учтите лимиты API.

---

Полезные советы

Оптимизация и тонкая настройка

Начальные настройки для тестирования:

Env

 

TOTAL_THRESHOLD=2.5

MINUTE_TRIGGER=60

ONLY_NO_GOALS=False

CHECK_INTERVAL=60

LEAGUE_WHITELIST=England - Premier League

SEND_TEST_MESSAGE=True

Оптимальные настройки для продакшена:

Env

 

TOTAL_THRESHOLD=2.0

MINUTE_TRIGGER=65

ONLY_NO_GOALS=False

CHECK_INTERVAL=90

LEAGUE_WHITELIST=England - Premier League,Spain - La Liga,Germany - Bundesliga

ENABLE_STATISTICS=True

Для ставок LIVE:

Env

 

TOTAL_THRESHOLD=1.5

MINUTE_TRIGGER=70

ONLY_NO_GOALS=True

CHECK_INTERVAL=30

Экономия лимитов API:

env

CHECK_INTERVAL=120

LEAGUE_WHITELIST=England - Premier League

MAX_RETRIES=2

ENABLE_STATISTICS=False

Временные рекомендации:

• Утро (до 15:00 МСК) - мало матчей, можно увеличить интервалы
• Вечер (18:00-23:00 МСК) - пиковая нагрузка, уменьшайте интервалы
• Выходные - больше матчей, можно ужесточить фильтры

Для работы 24/7:

·         Добавьте в автозагрузку

·         Используйте .vbs для скрытого запуска

·         Убедитесь что компьютер не уходит в спящий режим

Для экономии трафика:

env

CHECK_INTERVAL=120

LEAGUE_WHITELIST=England - Premier League

Мониторинг работы:

·         Регулярно проверяйте логи

·         Используйте команду /stats

·         Следите за сообщениями об ошибках

---

Техническая поддержка

Где получить помощь?

Если программа не запускается:

1. Проверьте наличие .env файла

2. Запустите из командной строки для просмотра ошибки

3. Проверьте, не блокирует ли антивирус

Если не работают уведомления:

1. Проверьте BOT_TOKEN и CHAT_ID

2. Убедитесь, что бот не заблокирован

3. Проверьте интернет-соединение

Если нет уведомлений о матчах:

1. Проверьте текущее время (матчи обычно с 12:00 до 23:00 по МСК)

2. Увеличьте TOTAL_THRESHOLD

3. Уменьшите MINUTE_TRIGGER

4. Убедитесь, что есть активные матчи в выбранных лигах

Куда сообщать об ошибках?

Присылайте:

1. Текст ошибки из консоли или файла goal_bot.log

2. Содержание файла .env (БЕЗ реальных ключей - замените на "xxx")

3. Версию Windows

4. Описание того, что вы делали при возникновении ошибки

---

Частые вопросы

Можно ли запускать несколько копий программы?

A: Нет, это вызовет превышение лимитов API и дублирование уведомлений.

Работает ли на Mac/Linux?

A: Только Windows. Для Mac/Linux используйте Python версию скрипта.

Нужны ли права администратора?

A: Обычно не нужны. Программа работает в пользовательском режиме.

Занимает ли много ресурсов?

A: Нет, потребление памяти ~50-100 МБ, процессор почти не нагружает.

Можно ли менять настройки без перезапуска?

A: Нет, для применения изменений в .env файле нужен перезапуск программы.

Почему нет уведомлений в выходные дни?

A: В выходные обычно больше матчей, но ваши настройки могут быть слишком строгими. Попробуйте увеличить TOTAL_THRESHOLD.

Как узнать, что программа работает в фоне?

A: Проверьте в Диспетчере задач процесс GoalAlertBot.exe или отправьте команду /status боту в Telegram.

 

GoalAlertBot.zip

[maluky 23]

Прошу прощения. Замените на этот архив. 

🤖 Goal Alert Bot.zip

[Mateusz Cimoch 0]

" Goal Alert Bot.exe"
2025-09-30 22:07:57,817 - INFO - Настройки: Тотал <= 1.5, с 70 мин
2025-09-30 22:07:57,817 - INFO - Белый список лиг: ['England - Premier League', 'Spain - La Liga', 'Germany - Bundesliga', 'Italy - Serie A', 'France - Ligue 1']
2025-09-30 22:07:58,211 - ERROR - Критическая ошибка при запуске: 'Updater' object has no attribute '_Updater__polling_cleanup_cb' and no __dict__ for setting new attributes
Traceback (most recent call last):
  File "bot.py", line 583, in main
  File "bot.py", line 75, in __init__
  File "telegram\ext\_applicationbuilder.py", line 312, in build
  File "telegram\ext\_updater.py", line 128, in __init__
AttributeError: 'Updater' object has no attribute '_Updater__polling_cleanup_cb' and no __dict__ for setting new attributes

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "bot.py", line 592, in <module>
  File "bot.py", line 589, in main
NameError: name 'exit' is not defined
[PYI-7180:ERROR] Failed to execute script 'bot' due to unhandled exception!

Can you help me with this?

[Rony 413]

по каким параметрам идет отбор? кроме как количество голов. спасибо

[Fiksar 262]

12 часов назад, Mateusz Cimoch сказал:

" Goal Alert Bot.exe"
2025-09-30 22:07:57,817 - INFO - Настройки: Тотал <= 1.5, с 70 мин
2025-09-30 22:07:57,817 - INFO - Белый список лиг: ['England - Premier League', 'Spain - La Liga', 'Germany - Bundesliga', 'Italy - Serie A', 'France - Ligue 1']
2025-09-30 22:07:58,211 - ERROR - Критическая ошибка при запуске: 'Updater' object has no attribute '_Updater__polling_cleanup_cb' and no __dict__ for setting new attributes
Traceback (most recent call last):
  File "bot.py", line 583, in main
  File "bot.py", line 75, in __init__
  File "telegram\ext\_applicationbuilder.py", line 312, in build
  File "telegram\ext\_updater.py", line 128, in __init__
AttributeError: 'Updater' object has no attribute '_Updater__polling_cleanup_cb' and no __dict__ for setting new attributes

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "bot.py", line 592, in <module>
  File "bot.py", line 589, in main
NameError: name 'exit' is not defined
[PYI-7180:ERROR] Failed to execute script 'bot' due to unhandled exception!

Can you help me with this?

Поддерживаю, такая же беда!

[Oleksa 3]

43 минуты назад, Fiksar сказал:

Поддерживаю, такая же беда!

2025-10-01 12:29:23,621 - INFO - Белый список лиг: ['England - Premier League', 'Spain - La Liga', 'Germany - Bundesliga', 'Italy - Serie A', 'France - Ligue 1']
2025-10-01 12:29:24,410 - ERROR - Критическая ошибка при запуске: 'Updater' object has no attribute '_Updater__polling_cleanup_cb' and no __dict__ for setting new attributes
тоже вот такая ошибка высочила и бот закрылся..

 

[Malukyan Ltd 101]

Скоро будет исправленная версия.. Ждите