# TelegramBot

> Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26  
> Index: https://www.symcon.de/de/llms.txt

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/telegrambot/

_Benötigt Symcon >= 6.0_

Erlaubt das Versenden von Nachrichten an angegebene Personen und Ausführen von Aktionen innerhalb von IP-Symcon.

### Funktionsumfang
- Nachrichten versenden (an alle oder einzelne Personen)
- Bilder (aus Medien) versenden (an alle oder einzelne Personen)
- Auf Chat-Kommandos mit Aktionen reagieren

### Voraussetzungen
- Ein Telegram Bot

### Telegram Bot erstellen
- Im Telegram-Client nach [BotFather](https://t.me/botfather) suchen
- Mit ***/newbot*** wird ein neuer Bot erstellt
- Unter dem Benutzernamen kann der Bot gefunden werden und sollte daher mit beispielsweise zufälligen Zahlen bestückt werden

![Createbot](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/benachrichtigungen/telegrambot/b74c4958a1-1790424938/createbot.png)

- Im Telegram-Client nach RawDataBot suchen
- Wenn der Bot angeschrieben wird gibt dieser einige Daten zurück, aus denen die eigene BenutzerID entnommen werden kann
  - Dieser Vorgang muss für jeden Benutzer wiederholt werden, der von dem Bot erreicht werden soll

![Userid](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/benachrichtigungen/telegrambot/bb4f48f360-1790424938/userid.png)

- Den Bot mit ***/start*** anschreiben um ihn zu starten

### Software-Installation
- Über den Module Store das 'TelegramBot'-Modul installieren.
- Alternativ über das Module Control folgende URL hinzufügen

### Einrichten der Instanzen in IP-Symcon
- Unter 'Instanz hinzufügen' kann das 'TelegramBot'-Modul mithilfe des Schnellfilters gefunden werden.
  - Weitere Informationen zum Hinzufügen von Instanzen in der [Dokumentation der Instanzen](https://www.symcon.de/service/dokumentation/konzepte/instanzen/#Instanz_hinzuf%C3%BCgen)

#### Konfigurationsseite:

| Name             | Beschreibung                                                      |
| ---------------- | ----------------------------------------------------------------- |
| Bot API Key      | Der API Key des erstellten Bots                                   |
| Bot Benutzername | Der Benutzername des erstellten Bots                              |
| Benutzer         | Eine Liste von Benutzern, die vom Bot angeschrieben werden können |
| Aktionen         | List mit Befehlen und den dazugehörigen Aktionen                  |

### Aktionen
#### Verschicke Bild
Mit dieser Aktion kann ein Bild an den ausgewählten Empfänger gesendet werden

#### _Parameter:_
- Bild: Das Medienobjekt, welches versendet werden soll
- Empfänger: Ein bestimmter oder alle in der Benutzer-Liste definierten Personen

#### Verschicke Nachricht
Mit dieser Aktion kann ein Nachricht an den ausgewählten Empfänger gesendet werden

#### _Parameter:_
- Text: Der Inhalt der Nachricht
- Empfänger: Ein bestimmter oder alle in der Benutzer-Liste definierten Personen

[Mehr Informationen zur Nutzung von Aktionen](https://www.symcon.de/service/dokumentation/konzepte/automationen/ablaufplaene/aktionen/)