Eurojackpot-Tipp-Generator/documentation/NOTIFICATIONS_SETUP.md

📱 Benachrichtigungen Setup-Guide

Erhalte automatische Benachrichtigungen über:

• 🎲 Neu generierte Tipps (mit bestem Tipp)
• 🎯 Ziehungsergebnisse (deine Treffer)
• ❌ System-Fehler

📋 Übersicht

Das System unterstützt zwei Benachrichtigungskanäle:

1. Telegram Bot (empfohlen) - Push-Benachrichtigungen auf dein Handy
2. E-Mail (SMTP) - Klassische E-Mail-Benachrichtigungen

Du kannst beide aktivieren oder nur einen davon nutzen.

---

🤖 Telegram Bot Setup (Empfohlen)

Schritt 1: Bot erstellen

1. Öffne Telegram und suche nach @BotFather
2. Sende /newbot
3. Gib einen Namen ein (z.B. "Eurojackpot Notifier")
4. Gib einen Username ein (muss auf bot enden, z.B. eurojackpot_tips_bot)
5. Kopiere den Bot Token (Format: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)

Schritt 2: Chat ID ermitteln

Option A: Via GetUpdates API (einfach)

1. Sende eine Nachricht an deinen Bot (z.B. "/start")

2. Öffne im Browser:

   https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
   

   (Ersetze <YOUR_BOT_TOKEN> mit deinem Token)

3. Suche nach "chat":{"id": - die Zahl danach ist deine Chat ID (z.B. 123456789)

Option B: Via @userinfobot (noch einfacher)

1. Suche in Telegram nach @userinfobot
2. Sende /start
3. Der Bot antwortet mit deiner Chat ID

Schritt 3: Konfiguration

Bearbeite die Datei config/notifications.json:

{
  "telegram": {
    "enabled": true,
    "bot_token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
    "chat_id": "123456789"
  },
  "email": {
    "enabled": false
  }
}

Schritt 4: Test

cd "/Users/sebastianfrohlich/Library/Mobile Documents/com~apple~CloudDocs/Jupyter Notebooks/Eurojackpot"
source venv/bin/activate
python scripts/utils/notifier.py --test

Du solltest jetzt eine Test-Nachricht auf Telegram erhalten! ✅

---

📧 E-Mail Setup

Gmail verwenden

Schritt 1: App-Passwort erstellen

Gmail erfordert ein App-Passwort (nicht dein normales Passwort):

1. Gehe zu https://myaccount.google.com/security
2. Aktiviere 2-Faktor-Authentifizierung (falls noch nicht aktiv)
3. Suche nach "App-Passwörter"
4. Wähle "Mail" und "Sonstiges Gerät"
5. Gib einen Namen ein (z.B. "Eurojackpot Bot")
6. Kopiere das 16-stellige Passwort (Format: xxxx xxxx xxxx xxxx)

Schritt 2: Konfiguration

Bearbeite config/notifications.json:

{
  "telegram": {
    "enabled": false
  },
  "email": {
    "enabled": true,
    "smtp_server": "smtp.gmail.com",
    "smtp_port": 587,
    "smtp_user": "deine.email@gmail.com",
    "smtp_password": "xxxx xxxx xxxx xxxx",
    "from_email": "deine.email@gmail.com",
    "to_email": "deine.email@gmail.com"
  }
}

Andere E-Mail-Provider

iCloud Mail

{
  "email": {
    "enabled": true,
    "smtp_server": "smtp.mail.me.com",
    "smtp_port": 587,
    "smtp_user": "deine.email@icloud.com",
    "smtp_password": "app-spezifisches-passwort",
    "from_email": "deine.email@icloud.com",
    "to_email": "deine.email@icloud.com"
  }
}

Outlook/Hotmail

{
  "email": {
    "enabled": true,
    "smtp_server": "smtp-mail.outlook.com",
    "smtp_port": 587,
    "smtp_user": "deine.email@outlook.com",
    "smtp_password": "dein-passwort",
    "from_email": "deine.email@outlook.com",
    "to_email": "deine.email@outlook.com"
  }
}

Web.de / GMX

{
  "email": {
    "enabled": true,
    "smtp_server": "smtp.web.de",  // oder smtp.gmx.net
    "smtp_port": 587,
    "smtp_user": "deine.email@web.de",
    "smtp_password": "dein-passwort",
    "from_email": "deine.email@web.de",
    "to_email": "deine.email@web.de"
  }
}

Schritt 3: Test

python scripts/utils/notifier.py --test

Prüfe deinen E-Mail-Posteingang! 📧

---

🔔 Beide Kanäle aktivieren

Für maximale Zuverlässigkeit:

{
  "telegram": {
    "enabled": true,
    "bot_token": "YOUR_BOT_TOKEN",
    "chat_id": "YOUR_CHAT_ID"
  },
  "email": {
    "enabled": true,
    "smtp_server": "smtp.gmail.com",
    "smtp_port": 587,
    "smtp_user": "your.email@gmail.com",
    "smtp_password": "YOUR_APP_PASSWORD",
    "from_email": "your.email@gmail.com",
    "to_email": "your.email@gmail.com"
  }
}

---

📬 Benachrichtigungs-Typen

1. Tipps generiert

Wann: Nach erfolgreicher Tipp-Generierung

Telegram/E-Mail:

🎲 NEUE EUROJACKPOT-TIPPS GENERIERT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 Anzahl Tipps: 10
⏰ Zeitpunkt: 2025-11-25 09:00

🏆 BESTER TIPP (höchste Confidence):
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔢 Hauptzahlen: 3-23-29-32-41
⭐ Eurozahlen: 8-9
📈 Strategie: HYBRID-OPT
💎 Confidence: 39.16%

💡 Alle Tipps findest du in der CSV-Datei!

Viel Glück! 🍀

2. Ziehung ausgewertet

Wann: Nach Verarbeitung einer neuen Ziehung

Telegram/E-Mail:

🎰 EUROJACKPOT-ZIEHUNG AUSGEWERTET
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📅 Datum: 2025-11-21

🎲 GEZOGENE ZAHLEN:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔢 Hauptzahlen: 5-8-21-37-46
⭐ Eurozahlen: 6-8

🎊 DEINE BESTEN TREFFER:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔢 Hauptzahlen: 3 Treffer
⭐ Eurozahlen: 1 Treffer
🎯 Gesamt: 4 Treffer
📊 Bewertung: Sehr gut!

📈 DURCHSCHNITT ALLER TIPPS:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔢 Main: 1.2 Treffer
⭐ Euro: 0.8 Treffer

💡 Details im Performance-Report!

3. Fehler-Benachrichtigung

Wann: Bei System-Fehlern (nur via Telegram für schnelle Reaktion)

Telegram:

❌ FEHLER IM EUROJACKPOT-SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📍 Kontext: Tipp-Generierung
🔴 Fehler: Connection timeout

💡 Bitte System-Logs prüfen!

---

🛠️ Troubleshooting

Telegram-Bot antwortet nicht

Problem: Test-Nachricht kommt nicht an

Lösung:

1. Überprüfe Bot Token und Chat ID
2. Stelle sicher, dass du /start an deinen Bot gesendet hast
3. Teste manuell:

   curl "https://api.telegram.org/bot<YOUR_TOKEN>/sendMessage?chat_id=<YOUR_CHAT_ID>&text=Test"
   

E-Mail kommt nicht an

Problem: Test-E-Mail wird nicht empfangen

Lösung:

1. Prüfe Spam-Ordner
2. Bei Gmail: Stelle sicher, dass du ein App-Passwort verwendest (nicht dein normales Passwort)
3. Teste SMTP-Verbindung:

   python3 -c "
   import smtplib
   server = smtplib.SMTP('smtp.gmail.com', 587)
   server.starttls()
   server.login('your@email.com', 'your-app-password')
   print('✅ Verbindung erfolgreich!')
   server.quit()
   "
   

Gmail: "Username and Password not accepted"

Ursache: Du verwendest dein normales Passwort statt App-Passwort

Lösung:

1. Aktiviere 2-Faktor-Authentifizierung
2. Erstelle App-Passwort (siehe oben)
3. Verwende das 16-stellige App-Passwort in der Config

Keine Benachrichtigungen trotz Config

Mögliche Ursachen:

1. enabled: false in der Config
2. Fehlende oder ungültige Credentials
3. Netzwerkprobleme

Debug:

# Teste direkt
python scripts/utils/notifier.py --test

# Prüfe Config
cat config/notifications.json

---

🔐 Sicherheit

Config-Datei schützen

Die notifications.json enthält sensible Daten (Bot Token, Passwörter).

Best Practices:

1. Nie committen:

   # .gitignore
   config/notifications.json
   

2. Permissions setzen:

   chmod 600 config/notifications.json
   

3. Backups verschlüsseln:

   # Backup erstellen
   cp config/notifications.json config/notifications.json.backup
   
   # Verschlüsseln (optional)
   openssl enc -aes-256-cbc -salt -in config/notifications.json.backup -out config/notifications.json.backup.enc
   

App-Passwörter verwenden

• Niemals dein Haupt-E-Mail-Passwort in Scripts verwenden
• Immer App-spezifische Passwörter erstellen
• Bei Verdacht auf Kompromittierung: App-Passwort sofort widerrufen

---

💡 Tipps & Tricks

Benachrichtigungen nur für wichtige Events

Nur Ziehungsergebnisse (keine Tipp-Generierung):

1. Editiere scripts/automation/weekly_tip_generator.py
2. Kommentiere Zeilen 178-194 aus (Benachrichtigungs-Block)

Mehrere Empfänger (E-Mail)

{
  "email": {
    "to_email": "empfaenger1@example.com, empfaenger2@example.com"
  }
}

Stille Stunden (keine Benachrichtigungen nachts)

Füge in notifier.py hinzu:

from datetime import datetime

def _should_send(self):
    hour = datetime.now().hour
    # Keine Benachrichtigungen zwischen 22:00 und 08:00
    if hour >= 22 or hour < 8:
        return False
    return True

Telegram Gruppen-Chat

Statt persönlicher Chat ID kannst du auch eine Gruppen-ID verwenden:

1. Erstelle Telegram-Gruppe
2. Füge deinen Bot hinzu
3. Sende /start@your_bot_name in der Gruppe
4. Hole Gruppen-ID via getUpdates (Format: -123456789, negativ!)

---

📱 Beispiel-Nachrichten

Montag 09:00 - Tipps generiert

🎲 NEUE EUROJACKPOT-TIPPS GENERIERT

📊 10 Tipps für Dienstag-Ziehung bereit!

🏆 Bester Tipp: 3-23-29-32-41 + 8-9 Confidence: 39.16% (HYBRID-OPT)

Viel Glück! 🍀

Dienstag 21:00 - Ergebnis

🎰 ZIEHUNG VOM 2025-11-25

Gezogene Zahlen: 5-8-21-37-46 + 6-8

🎊 Dein bester Tipp: 4 Treffer! (3 Main + 1 Euro)

Sehr gut! 📈

---

✅ Checkliste

• Telegram Bot erstellt (@BotFather)
• Bot Token kopiert
• Chat ID ermittelt (via getUpdates oder @userinfobot)
• config/notifications.json erstellt
• Telegram aktiviert (enabled: true)
• Test-Nachricht erfolgreich (python scripts/utils/notifier.py --test)
• (Optional) E-Mail konfiguriert
• (Optional) Gmail App-Passwort erstellt
• (Optional) E-Mail-Test erfolgreich
• Config-Datei gesichert (chmod 600)
• In .gitignore eingetragen

---

🆘 Support

Bei Problemen:

1. Teste manuell:

   python scripts/utils/notifier.py --test
   

2. Prüfe Logs:

   tail -100 logs/tips_generation.log
   tail -100 logs/auto_update.log
   

3. Validiere Config:

   python3 -c "import json; print(json.load(open('config/notifications.json')))"
   

4. Telegram API testen:

   curl "https://api.telegram.org/bot<TOKEN>/getMe"
   

---

Version: 1.0 Erstellt: 2025-11-25 Kompatibel mit: Eurojackpot Automation System V1.0