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

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

 

🤖 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

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

🤖 Goal Alert Bot.zip

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

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?

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

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
тоже вот такая ошибка высочила и бот закрылся..

 

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