> For the complete documentation index, see [llms.txt](https://docs.helmut.de/helmut4-releases/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helmut.de/helmut4-releases/v4.8.0/helmut4-components/streamdesigner/nodes/outputs/misc-3/telegram-output.md).

# Telegram Output

The Telegram Output Action allows you to send notifications to a Telegram group. Before utilizing this node, it is essential to collect some required information in advance, such as an API key.

### API Token

Instructions to set up your Telegram bot. No coding is required, and you can complete the process directly on your device:

#### **Step 1**

Locate the Telegram bot named "@botfather." This bot will assist you in creating and managing your own bot.

<figure><img src="/files/oOVutx7RE2QmBqnKjLhP" alt="" width="216"><figcaption><p>Telegram BotFather</p></figcaption></figure>

#### **Step 2**

Create a new bot by typing "/newbot" or clicking on the corresponding option. Follow the instructions provided by @botfather to generate a new name for your bot. If your bot is purely for experimentation, you can add a unique touch by including your name before it in its username, as the bot's name must be unique. The screen name can be anything of your choice.

<figure><img src="/files/yk5L8ipT0jOABqBtkFqb" alt="" width="216"><figcaption><p>Telegram BotFather</p></figcaption></figure>

#### **Step 3**

Congratulations! You have successfully created your Telegram bot. A new API token will be generated for your bot.

In the example above, the token is 270485614:AAHfiqksKZ8WmR2zSjiQ7\_v4TMAKdiHm9T0.

Copy your API token and paste it into the designated node.

Tutorial source:  <https://www.siteguarding.com/en/how-to-get-telegram-bot-api-token><br>

### Recipient-ID

#### Step 1

Locate the Telegram bot named "@RawDataBot" or "Telegram Bot Raw"; it will assist you in obtaining the ID of your group.

#### Step 2

Create a new group and give it a name of your choice.

#### Step 3

Add the bot @RawDataBot to this group. Once the bot is inside, it will respond with a message containing various metadata, one of which is the chat group ID.

<figure><img src="/files/TAGtV9PM6o11lAmuK72C" alt="" width="375"><figcaption><p>Telegram Bot returning information</p></figcaption></figure>

```json
"chat": {
            "id": -655476556,
            "title": "Helmut Telegram Group",
            "type": "group",
            "all_members_are_administrators": true
        },
```

The complete ID, prefixed with a hyphen "-655476556," is the recipient ID that can be copied into the node. After the bot reveals the ID, it can be removed from the group.

<br>

### Store and use API-Token / Recipient-ID

To facilitate easier management of the API-Token and recipient-ID, these can be stored in variable storage. This enables seamless modification or variation of the group, such as incorporating the group name into the combination.

<figure><img src="/files/qN24Fm78q3jIM8GfE7kv" alt=""><figcaption><p>Store Variables for Telegram Message node</p></figcaption></figure>

### Send Message via Telegram

<figure><img src="/files/JboPwU8h4AcbKvuhdRul" alt=""><figcaption><p>Telegram Output node</p></figcaption></figure>

<figure><img src="/files/kIdi678VKNX8HWBLXEqx" alt=""><figcaption><p>Message from the Telegram Output node in Telegram</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.helmut.de/helmut4-releases/v4.8.0/helmut4-components/streamdesigner/nodes/outputs/misc-3/telegram-output.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.