# 📱 Telegram-Benachrichtigungen aktivieren

## Übersicht

Erhalte Geofence-Benachrichtigungen direkt in Telegram mit:
- 📍 Standort-Pin auf der Karte
- 🔔 Sofortige Push-Benachrichtigungen
- 🔗 Direktlinks zur Karte und zum Dashboard

---

## 🚀 Schritt-für-Schritt Anleitung

### Schritt 1: Bot starten

#### Option A: QR-Code scannen (empfohlen für Smartphone)

<p align="center">
  <img src="../public/telegram-bot-qr.png" width="300" alt="Telegram Bot QR Code">
</p>

1. Öffne die Kamera-App auf deinem Smartphone
2. Scanne den QR-Code
3. Telegram öffnet sich automatisch
4. Klicke auf **"Start"** oder sende `/start`

#### Option B: Link öffnen

1. Klicke auf: **[https://t.me/MeinTracking_bot](https://t.me/MeinTracking_bot)**
2. Telegram öffnet sich automatisch
3. Klicke auf **"Start"** oder sende `/start`

✅ Du solltest eine Willkommensnachricht vom Bot erhalten

---

### Schritt 2: Chat ID herausfinden

#### Option A: Mit @myidbot (empfohlen)

1. Suche in Telegram nach: **@myidbot**
2. Sende: `/getid`
3. Der Bot antwortet sofort mit deiner Chat ID:
   ```
   Your user ID: 123456789
   ```
4. **Kopiere die Nummer** (z.B. `123456789`)

#### Option B: Mit @userinfobot

1. Suche in Telegram nach: **@userinfobot**
2. Sende: `/start`
3. Der Bot antwortet mit deinen Informationen:
   ```
   Id: 123456789
   First name: Dein Name
   ...
   ```
4. **Kopiere die Nummer** bei "Id:" (z.B. `123456789`)

---

### Schritt 3: Chat ID im Dashboard eintragen

1. Melde dich im Location Tracker an
2. Gehe zu: **Einstellungen** → **Benachrichtigungen**
3. Aktiviere: ☑️ **Telegram Benachrichtigungen**
4. Trage deine **Chat ID** ein (die Nummer aus Schritt 2)
5. Klicke auf **"Speichern"**

---

### Schritt 4: Verbindung testen

1. Klicke auf den Button **"Telegram Test"**
2. Du solltest sofort eine Test-Nachricht in Telegram erhalten:
   ```
   ✅ Telegram Connection Test

   Die Verbindung funktioniert!
   ```

✅ **Fertig!** Ab jetzt erhältst du alle Geofence-Benachrichtigungen auch per Telegram.

---

## 📨 Beispiel-Benachrichtigung

So sieht eine Geofence-Benachrichtigung aus:

```
🟢 Geofence BETRETEN

📱 Device: Mein iPhone
📍 Geofence: Zuhause
🕐 Zeit: 04.12.25, 14:30
📊 Ereignis: Hat Zuhause betreten
```

**+ Standort-Pin auf der Karte**

**+ Buttons:**
- 🗺️ Auf Karte zeigen
- 📊 Dashboard öffnen

---

## ❓ Häufige Fragen

### Kann ich sowohl Email als auch Telegram aktivieren?

Ja! Du kannst beide Kanäle gleichzeitig nutzen:
- ☑️ E-Mail Benachrichtigungen
- ☑️ Telegram Benachrichtigungen

### Sehen andere User meine Benachrichtigungen?

**Nein!** Jede Chat ID ist ein privater 1-zu-1 Chat. Andere User können deine Nachrichten nicht sehen, auch wenn sie den gleichen Bot nutzen.

### Was ist, wenn die Chat ID falsch ist?

Dann erhältst du keine Benachrichtigungen. Nutze den "Telegram Test" Button, um die Verbindung zu prüfen.

### Kann ich Benachrichtigungen pausieren?

Ja! Deaktiviere einfach "Telegram Benachrichtigungen" in den Einstellungen. Deine Chat ID bleibt gespeichert.

### Wo finde ich meine Chat ID nochmal?

Sende `/getid` an **@myidbot** oder `/start` an **@userinfobot** in Telegram.

---

## 🛠️ Troubleshooting

### "No Telegram chat ID configured"

→ Du hast noch keine Chat ID eingetragen. Folge Schritt 2 und 3.

### "Failed to send test message"

Mögliche Ursachen:
1. **Chat ID falsch** → Überprüfe die Nummer bei @userinfobot
2. **Bot nicht gestartet** → Sende `/start` an @MeinTracking_bot
3. **Bot blockiert** → Entsperre den Bot in Telegram

### Test-Nachricht kommt nicht an

1. Überprüfe, ob du den Bot gestartet hast (`/start` an @MeinTracking_bot)
2. Prüfe, ob die Chat ID korrekt ist (keine Leerzeichen, keine Buchstaben)
   - Hole sie neu mit `/getid` an @myidbot
3. Stelle sicher, dass du den Bot nicht blockiert hast

---

## 📞 Support

Bei Problemen wende dich an den Administrator oder überprüfe die Logs im System.

---

**Bot:** [@MeinTracking_bot](https://t.me/MeinTracking_bot)
**Letzte Aktualisierung:** 04.12.2025