# TelegramBot

> Symcon documentation · English · generated on 2026-09-26  
> Index: https://www.symcon.de/en/llms.txt

Source: https://www.symcon.de/en/service/documentation/module-reference/notifications/telegrambot/

_Requires Symcon >= 6.0_

Allows sending messages to specified persons and performing actions within IP-Symcon.

### function scope
- Send messages (to all or individual persons)
- Send images (from media) (to all or individual people)
- Respond to chat commands with actions

### requirements
- A Telegram Bot

### Create Telegram Bot
- In the Telegram client, search for [BotFather](https://t.me/botfather)
- Use ***/newbot*** to create a new bot
- Under the username the bot can be found and should be populated with for example random numbers

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

- In the Telegram client search for RawDataBot
- When the bot is contacted, it returns some data, from which you can get your own userID
  - This process must be repeated for each user that should be reached by the bot

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

- Write the bot with */start* to start it

### software installation
- Install the 'TelegramBot' module via the [Module Store](https://www.symcon.de/en/service/documentation/components/management-console/module-store/).

### Instance setup in IP-Symcon
- Under 'Add Instance', the 'TelegramBot' module can be found using the quick filter.
  - More information about adding instances in the [Instances documentation](https://www.symcon.de/en/service/documentation/basics/instances/)

#### ConfigurationPage:

| Name         | Description                                      |
| ------------ | ------------------------------------------------ |
| Bot API Key  | The API key of the created bot                   |
| Bot Username | The username of the created bot                  |
| Users        | A list of users that can be contacted by the bot |
| Actions      | A list of commands and their actions             |

### actions
#### Send-image
This action can be used to send an image to the selected recipient

#### _Parameter:_
- Image: the media object to be sent
- Recipient: A specific person or all persons defined in the user list

#### SendMessage
With this action a message can be sent to the selected recipient

#### _Parameter:_
- Text: The content of the message
- Recipient: A specific person or all persons defined in the user list

[More information about using actions](https://www.symcon.de/en/service/documentation/basics/automations/flow-scripts/actions/)