Konfigurationsanleitung für Telegram-Push-Benachrichtigungen

Konfigurationsprinzip und Schnittstellenstruktur

Der Telegram-Nachrichtenversand basiert auf der Telegram Bot API. Die vollständige Push-URL wird aus Bot Token (Bot-Zugriffsschlüssel) und Chat ID (eindeutige Kennung des Empfängers) zusammengesetzt.

Standardvorlage für die Zusammensetzung:

[https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/sendMessage?chat_id=<CHAT_ID>

Schritte zum Abrufen

Schritt 1: Bot erstellen und Bot Token abrufen

1. Öffnen Sie Telegram, geben Sie in der Suchleiste den offiziellen Bot @BotFather ein und folgen Sie ihm.
2. Senden Sie den Befehl @BotFather: /newbot.
3. Geben Sie gemäß den Aufforderungen nacheinander Folgendes ein:
   • Bot Name: Anzeigename des Bots (z. B. Benachrichtigungsassistent).
   • Bot Username: Eindeutiger Benutzername des Bots (muss mit bot enden, z. B. my_notice_bot).
4. Nach erfolgreicher Erstellung gibt @BotFather die API-Zugangsdaten aus. Kopieren Sie die Zeichenfolge HTTP API Token (Format z. B. 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ).

Schritt 2: Chat ID des Empfängers abrufen

Wählen Sie je nach Typ des Nachrichtenempfängers (Einzelperson oder Gruppe) die entsprechende Abrufmethode aus:

Option A: Benachrichtigungen an eine Einzelperson empfangen

• Methode 1: Über den offiziellen Abfrage-Bot (empfohlen)
  1. Suchen Sie in Telegram nach @userinfobot und folgen Sie ihm.
  2. Senden Sie ihm eine beliebige Nachricht oder klicken Sie auf /start.
  3. Der Bot gibt Metadaten des persönlichen Kontos zurück; die reine Zahl hinter Id ist Ihre persönliche Chat ID (z. B. 987654321).
• Methode 2: Abfrage über die API-Schnittstelle
  1. Senden Sie aktiv eine Nachricht an den gerade erstellten Bot (z. B. hello), um die Unterhaltung zu aktivieren.
  2. Öffnen Sie den Browser und rufen Sie den folgenden Link auf (ersetzen Sie <TOKEN> durch die in Schritt 1 erhaltenen Zugangsdaten):

      [https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/getUpdates

  3. Extrahieren Sie in der zurückgegebenen JSON-Antwort den Zahlenwert von "result" -> "message" -> "chat" -> "id".

Option B: Benachrichtigungen in Gruppe/Kanal empfangen

1. Fügen Sie den neu erstellten Bot der Zielgruppe in Telegram hinzu.
2. Senden Sie in der Gruppe eine beliebige Nachricht (z. B. test) oder erteilen Sie dem Bot Administratorberechtigungen.
3. Rufen Sie im Browser den folgenden Link auf (ersetzen Sie <TOKEN> durch die in Schritt 1 erhaltenen Zugangsdaten):

    [https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/getUpdates

4. Suchen Sie in der zurückgegebenen JSON-Antwort den Eintrag mit dem entsprechenden Gruppennamen und extrahieren Sie das Feld "chat" -> "id".

   Hinweis: Die Chat ID einer Gruppe ist in der Regel eine negative Zahl, die mit - oder -100 beginnt (z. B. -100123456780); beim Zusammensetzen müssen Minuszeichen und Präfix vollständig beibehalten werden.

III. Beispiel für die Zusammensetzung der URL

Nachdem Sie <TOKEN> und <CHAT_ID> erhalten haben, setzen Sie diese in die Standardvorlage ein und ersetzen Sie die Platzhalter:

1. Beispiel-URL für persönliche Benachrichtigungen

• Token: 8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t
• Chat ID: 987654321
• Endgültiges zusammengesetztes Ergebnis:

  [https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=987654321](https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=987654321)

2. Beispiel-URL für Gruppenbenachrichtigungen

• Token: 8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t
• Chat ID: -7
• Endgültiges zusammengesetztes Ergebnis:

  [https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=-100123456780](https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=-100123456780)