joachim/location-mqtt-tracker-app
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
0d1dbeafda704d6bbb21c83b0309d559e7c9c360
location-mqtt-tracker-app/docs/telegram-anleitung.md
Joachim Hummel 0d1dbeafda Add Telegram notification integration for geofencing 
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>
2025-12-04 14:54:19 +00:00

4.0 KiB
Raw Blame History

📱 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)

Telegram Bot QR Code

  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
  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 Letzte Aktualisierung: 04.12.2025