Joachim Hummel
0d1dbeafda
Features: - Multi-channel notifications (Email + Telegram) - User-configurable notification settings per channel - Telegram bot integration with rich messages, location pins, and inline buttons - QR code generation for easy bot access (@myidbot support) - Admin UI for notification settings management - Test functionality for Telegram connection - Comprehensive documentation Implementation: - lib/telegram-service.ts: Telegram API integration - lib/notification-settings-db.ts: Database layer for user notification preferences - lib/geofence-notifications.ts: Extended for parallel multi-channel delivery - API routes for settings management and testing - Admin UI with QR code display and step-by-step instructions - Database table: UserNotificationSettings Documentation: - docs/telegram.md: Technical implementation guide - docs/telegram-anleitung.md: User guide with @myidbot instructions - docs/telegram-setup.md: Admin setup guide - README.md: Updated NPM scripts section Docker: - Updated Dockerfile to copy public directory - Added TELEGRAM_BOT_TOKEN environment variable - Integrated notification settings initialization in db:init 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
164 lines
4.0 KiB
Markdown
164 lines
4.0 KiB
Markdown
# 📱 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
|